@promptctl/rich-js 0.1.0

package/dist/widgets/text-input.js

@@ -0,0 +1,242 @@
+/**
+ * TextInput widget — single-line editable text field with cursor.
+ * [LAW:dataflow-not-control-flow] cursor is a data position; when focused,
+ * exactly one cell is rendered with reverse-video styling on every frame.
+ * [LAW:one-type-per-behavior] shared infrastructure inherited from WidgetBase.
+ *
+ * Visual states:
+ *   normal      — "[value______]" with brackets bracketing fixed-width content
+ *   focused     — same width with cursor cell (reverse video) at cursorPosition
+ *   placeholder — focused + empty value: dimmed placeholder text shown,
+ *                 cursor at position 0
+ *   password    — every value char rendered as "•"
+ *   disabled    — entire segment dimmed
+ */
+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 { observable, action } from "mobx";
+import { Segment } from "../core/segment.js";
+import { Style } from "../core/style.js";
+import { ColorSpec } from "../core/color.js";
+import { DEFAULT_TERMINAL_THEME } from "../themes/terminalThemes.js";
+import { WidgetBase } from "./widget-base.js";
+const MIN_CONTENT_WIDTH = 8;
+let TextInput = (() => {
+    var _a;
+    let _classSuper = WidgetBase;
+    let _instanceExtraInitializers = [];
+    let _value_decorators;
+    let _value_initializers = [];
+    let _value_extraInitializers = [];
+    let _cursorPosition_decorators;
+    let _cursorPosition_initializers = [];
+    let _cursorPosition_extraInitializers = [];
+    let _placeholder_decorators;
+    let _placeholder_initializers = [];
+    let _placeholder_extraInitializers = [];
+    let _handleKey_decorators;
+    let _handleMouse_decorators;
+    let _setHovered_decorators;
+    return class TextInput extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _value_decorators = [observable];
+            _cursorPosition_decorators = [observable];
+            _placeholder_decorators = [(_a = observable).ref.bind(_a)];
+            _handleKey_decorators = [action];
+            _handleMouse_decorators = [action];
+            _setHovered_decorators = [action];
+            __esDecorate(this, null, _value_decorators, { kind: "accessor", name: "value", static: false, private: false, access: { has: obj => "value" in obj, get: obj => obj.value, set: (obj, value) => { obj.value = value; } }, metadata: _metadata }, _value_initializers, _value_extraInitializers);
+            __esDecorate(this, null, _cursorPosition_decorators, { kind: "accessor", name: "cursorPosition", static: false, private: false, access: { has: obj => "cursorPosition" in obj, get: obj => obj.cursorPosition, set: (obj, value) => { obj.cursorPosition = value; } }, metadata: _metadata }, _cursorPosition_initializers, _cursorPosition_extraInitializers);
+            __esDecorate(this, null, _placeholder_decorators, { kind: "accessor", name: "placeholder", static: false, private: false, access: { has: obj => "placeholder" in obj, get: obj => obj.placeholder, set: (obj, value) => { obj.placeholder = value; } }, metadata: _metadata }, _placeholder_initializers, _placeholder_extraInitializers);
+            __esDecorate(this, null, _handleKey_decorators, { kind: "method", name: "handleKey", static: false, private: false, access: { has: obj => "handleKey" in obj, get: obj => obj.handleKey }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _handleMouse_decorators, { kind: "method", name: "handleMouse", static: false, private: false, access: { has: obj => "handleMouse" in obj, get: obj => obj.handleMouse }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _setHovered_decorators, { kind: "method", name: "setHovered", static: false, private: false, access: { has: obj => "setHovered" in obj, get: obj => obj.setHovered }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        id = __runInitializers(this, _instanceExtraInitializers);
+        focusable = true;
+        #value_accessor_storage = __runInitializers(this, _value_initializers, void 0);
+        get value() { return this.#value_accessor_storage; }
+        set value(value) { this.#value_accessor_storage = value; }
+        #cursorPosition_accessor_storage = (__runInitializers(this, _value_extraInitializers), __runInitializers(this, _cursorPosition_initializers, void 0));
+        get cursorPosition() { return this.#cursorPosition_accessor_storage; }
+        set cursorPosition(value) { this.#cursorPosition_accessor_storage = value; }
+        #placeholder_accessor_storage = (__runInitializers(this, _cursorPosition_extraInitializers), __runInitializers(this, _placeholder_initializers, void 0));
+        get placeholder() { return this.#placeholder_accessor_storage; }
+        set placeholder(value) { this.#placeholder_accessor_storage = value; }
+        _theme = __runInitializers(this, _placeholder_extraInitializers);
+        _maxLength;
+        _password;
+        constructor(options = {}) {
+            super();
+            this.id = options.id ?? `text-input-${Math.random().toString(36).slice(2, 8)}`;
+            this.value = options.value ?? "";
+            this.placeholder = options.placeholder ?? "";
+            this.cursorPosition = this.value.length;
+            this.disabled = options.disabled ?? false;
+            this._theme = options.theme ?? DEFAULT_TERMINAL_THEME;
+            this._maxLength = options.maxLength;
+            this._password = options.password ?? false;
+        }
+        setTheme(theme) { this._theme = theme; }
+        // --- Event handlers ---
+        handleKey(event) {
+            if (this.disabled)
+                return;
+            switch (event.key) {
+                case "left":
+                    this.cursorPosition = Math.max(0, this.cursorPosition - 1);
+                    return;
+                case "right":
+                    this.cursorPosition = Math.min(this.value.length, this.cursorPosition + 1);
+                    return;
+                case "home":
+                    this.cursorPosition = 0;
+                    return;
+                case "end":
+                    this.cursorPosition = this.value.length;
+                    return;
+                case "backspace":
+                    if (this.cursorPosition > 0) {
+                        this.value = this.value.slice(0, this.cursorPosition - 1) + this.value.slice(this.cursorPosition);
+                        this.cursorPosition -= 1;
+                        this.emitChange();
+                    }
+                    return;
+                case "delete":
+                    if (this.cursorPosition < this.value.length) {
+                        this.value = this.value.slice(0, this.cursorPosition) + this.value.slice(this.cursorPosition + 1);
+                        this.emitChange();
+                    }
+                    return;
+                case "enter":
+                    this.emitSubmit();
+                    return;
+            }
+            // Printable insertion: single-character event.character with no modifier.
+            if (event.character.length === 1 &&
+                !event.ctrl &&
+                !event.meta &&
+                event.character >= " " &&
+                event.character !== "\x7f") {
+                if (this._maxLength !== undefined && this.value.length >= this._maxLength)
+                    return;
+                this.value =
+                    this.value.slice(0, this.cursorPosition) +
+                        event.character +
+                        this.value.slice(this.cursorPosition);
+                this.cursorPosition += 1;
+                this.emitChange();
+            }
+        }
+        handleMouse(event) {
+            if (this.disabled)
+                return;
+            if (event.type !== "mouse_down")
+                return;
+            const b = this.bounds;
+            if (!b)
+                return;
+            // Click position relative to the content area (skip the leading "[" bracket).
+            const relX = event.x - b.x - 1;
+            this.cursorPosition = Math.max(0, Math.min(this.value.length, relX));
+        }
+        // --- Hover mutator (router fast-path) ---
+        setHovered(value) { this.hovered = value; }
+        // --- Rendering ---
+        render(options) {
+            const showPlaceholder = this.focused && this.value.length === 0 && this.placeholder.length > 0;
+            const rawDisplay = showPlaceholder
+                ? this.placeholder
+                : this._password
+                    ? "•".repeat(this.value.length)
+                    : this.value;
+            // [LAW:dataflow-not-control-flow] content width is data — derived from
+            // value/placeholder length, MIN_CONTENT_WIDTH floor, maxWidth ceiling.
+            const maxAvailable = Math.max(MIN_CONTENT_WIDTH, options.maxWidth - 2);
+            const desiredWidth = Math.max(MIN_CONTENT_WIDTH, rawDisplay.length, this.cursorPosition + 1);
+            const contentWidth = Math.min(maxAvailable, desiredWidth);
+            // Slide window to keep cursor visible when content overflows.
+            const startIdx = Math.max(0, Math.min(rawDisplay.length - contentWidth, this.cursorPosition - contentWidth + 1));
+            const sliced = rawDisplay.slice(Math.max(0, startIdx), Math.max(0, startIdx) + contentWidth);
+            const display = sliced.padEnd(contentWidth, " ");
+            const cursorDisplayIdx = this.cursorPosition - Math.max(0, startIdx);
+            const bracketStyle = this.disabled
+                ? new Style({ color: "#666666", bgcolor: "#333333", dim: true })
+                : new Style({ color: this.resolvePalette("foreground") });
+            const contentStyle = this.disabled
+                ? new Style({ color: "#666666", bgcolor: "#333333", dim: true })
+                : showPlaceholder
+                    ? new Style({ color: this.resolvePalette("foreground"), dim: true })
+                    : new Style({ color: this.resolvePalette("foreground") });
+            // Cursor cell paints on a full primary bg → use on-primary for fg so
+            // contrast is WCAG-correct across all themes, not theme-bg-dependent.
+            const cursorStyle = new Style({
+                color: this.resolvePalette("on-primary"),
+                bgcolor: this.resolvePalette("primary"),
+            });
+            const segments = [new Segment("[", bracketStyle)];
+            if (this.focused && !this.disabled && cursorDisplayIdx >= 0 && cursorDisplayIdx < contentWidth) {
+                const before = display.slice(0, cursorDisplayIdx);
+                const at = display.slice(cursorDisplayIdx, cursorDisplayIdx + 1);
+                const after = display.slice(cursorDisplayIdx + 1);
+                if (before.length > 0)
+                    segments.push(new Segment(before, contentStyle));
+                segments.push(new Segment(at.length > 0 ? at : " ", cursorStyle));
+                if (after.length > 0)
+                    segments.push(new Segment(after, contentStyle));
+            }
+            else {
+                segments.push(new Segment(display, contentStyle));
+            }
+            segments.push(new Segment("]", bracketStyle));
+            return segments;
+        }
+        measure(_options) {
+            const minimum = MIN_CONTENT_WIDTH + 2;
+            const maximum = Math.max(minimum, Math.max(this.value.length, this.placeholder.length) + 2);
+            return { minimum, maximum };
+        }
+        // --- Palette resolution ---
+        resolvePalette(key) {
+            const rgba = this._theme.palette.get(key);
+            // [LAW:no-defensive-null-guards] palette must contain all keys.
+            return ColorSpec.fromRgba(rgba);
+        }
+    };
+})();
+export { TextInput };
+//# sourceMappingURL=text-input.js.map

package/dist/widgets/text-input.js.map

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

package/dist/widgets/toggle.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Toggle widget — on/off switch with label and variant colour.
+ * [LAW:dataflow-not-control-flow] one Segment of fixed width every render;
+ * indicator and palette keys come from observable state via lookup tables.
+ * [LAW:one-type-per-behavior] shared infrastructure inherited from WidgetBase.
+ *
+ * Visual states:
+ *   off       — "[OFF] label" with muted variant background
+ *   on        — "[ON]  label" with full variant accent background
+ *   focused   — underline on the segment (no width change)
+ *   disabled  — dimmed
+ */
+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 type ToggleVariant = "default" | "primary" | "success" | "warning" | "danger";
+export interface ToggleOptions {
+    label: string;
+    on?: boolean;
+    id?: string;
+    disabled?: boolean;
+    theme?: TerminalTheme;
+    variant?: ToggleVariant;
+}
+export declare class Toggle extends WidgetBase {
+    readonly id: string;
+    readonly focusable = true;
+    accessor label: string;
+    accessor on: boolean;
+    accessor variant: ToggleVariant;
+    private _theme;
+    constructor(options: ToggleOptions);
+    setTheme(theme: TerminalTheme): void;
+    handleKey(event: KeyEvent): void;
+    handleMouse(event: WidgetMouseEvent): void;
+    setHovered(value: boolean): void;
+    render(_options: RenderOptions): Iterable<Segment>;
+    measure(_options: RenderOptions): {
+        minimum: number;
+        maximum: number;
+    };
+    private resolvePalette;
+}
+//# sourceMappingURL=toggle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../../src/widgets/toggle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAI7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAkBD,qBAAa,MAAO,SAAQ,UAAU;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,QAAQ;IAEd,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhD,OAAO,CAAC,MAAM,CAAgB;gBAElB,OAAO,EAAE,aAAa;IAUlC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAKpC,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAavB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAWnD,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAIhC,MAAM,CAAC,QAAQ,EAAE,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;IAgBlD,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAOtE,OAAO,CAAC,cAAc;CAKvB"}

package/dist/widgets/toggle.js

@@ -0,0 +1,169 @@
+/**
+ * Toggle widget — on/off switch with label and variant colour.
+ * [LAW:dataflow-not-control-flow] one Segment of fixed width every render;
+ * indicator and palette keys come from observable state via lookup tables.
+ * [LAW:one-type-per-behavior] shared infrastructure inherited from WidgetBase.
+ *
+ * Visual states:
+ *   off       — "[OFF] label" with muted variant background
+ *   on        — "[ON]  label" with full variant accent background
+ *   focused   — underline on the segment (no width change)
+ *   disabled  — dimmed
+ */
+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 { observable, action } from "mobx";
+import { Segment } from "../core/segment.js";
+import { Style } from "../core/style.js";
+import { ColorSpec } from "../core/color.js";
+import { DEFAULT_TERMINAL_THEME } from "../themes/terminalThemes.js";
+import { WidgetBase } from "./widget-base.js";
+// onFg uses on-${accent} (WCAG-correct contrast, picked once at palette
+// build time) so the ON state stays readable on a full accent bg. Earlier
+// versions used text-${accent} here, which is mostly-accent and clashed
+// with the same accent as background. offFg keeps text-${accent} because
+// offBg is mostly-bg-tinted and the contrast holds.
+const VARIANT_KEYS = {
+    default: { onBg: "primary", onFg: "on-primary", offBg: "surface", offFg: "foreground" },
+    primary: { onBg: "primary", onFg: "on-primary", offBg: "primary-muted", offFg: "text-primary" },
+    success: { onBg: "success", onFg: "on-success", offBg: "success-muted", offFg: "text-success" },
+    warning: { onBg: "warning", onFg: "on-warning", offBg: "warning-muted", offFg: "text-warning" },
+    danger: { onBg: "error", onFg: "on-error", offBg: "error-muted", offFg: "text-error" },
+};
+let Toggle = (() => {
+    var _a;
+    let _classSuper = WidgetBase;
+    let _instanceExtraInitializers = [];
+    let _label_decorators;
+    let _label_initializers = [];
+    let _label_extraInitializers = [];
+    let _on_decorators;
+    let _on_initializers = [];
+    let _on_extraInitializers = [];
+    let _variant_decorators;
+    let _variant_initializers = [];
+    let _variant_extraInitializers = [];
+    let _handleKey_decorators;
+    let _handleMouse_decorators;
+    let _setHovered_decorators;
+    return class Toggle extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _label_decorators = [observable];
+            _on_decorators = [observable];
+            _variant_decorators = [(_a = observable).ref.bind(_a)];
+            _handleKey_decorators = [action];
+            _handleMouse_decorators = [action];
+            _setHovered_decorators = [action];
+            __esDecorate(this, null, _label_decorators, { kind: "accessor", name: "label", static: false, private: false, access: { has: obj => "label" in obj, get: obj => obj.label, set: (obj, value) => { obj.label = value; } }, metadata: _metadata }, _label_initializers, _label_extraInitializers);
+            __esDecorate(this, null, _on_decorators, { kind: "accessor", name: "on", static: false, private: false, access: { has: obj => "on" in obj, get: obj => obj.on, set: (obj, value) => { obj.on = value; } }, metadata: _metadata }, _on_initializers, _on_extraInitializers);
+            __esDecorate(this, null, _variant_decorators, { kind: "accessor", name: "variant", static: false, private: false, access: { has: obj => "variant" in obj, get: obj => obj.variant, set: (obj, value) => { obj.variant = value; } }, metadata: _metadata }, _variant_initializers, _variant_extraInitializers);
+            __esDecorate(this, null, _handleKey_decorators, { kind: "method", name: "handleKey", static: false, private: false, access: { has: obj => "handleKey" in obj, get: obj => obj.handleKey }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _handleMouse_decorators, { kind: "method", name: "handleMouse", static: false, private: false, access: { has: obj => "handleMouse" in obj, get: obj => obj.handleMouse }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _setHovered_decorators, { kind: "method", name: "setHovered", static: false, private: false, access: { has: obj => "setHovered" in obj, get: obj => obj.setHovered }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        id = __runInitializers(this, _instanceExtraInitializers);
+        focusable = true;
+        #label_accessor_storage = __runInitializers(this, _label_initializers, void 0);
+        get label() { return this.#label_accessor_storage; }
+        set label(value) { this.#label_accessor_storage = value; }
+        #on_accessor_storage = (__runInitializers(this, _label_extraInitializers), __runInitializers(this, _on_initializers, void 0));
+        get on() { return this.#on_accessor_storage; }
+        set on(value) { this.#on_accessor_storage = value; }
+        #variant_accessor_storage = (__runInitializers(this, _on_extraInitializers), __runInitializers(this, _variant_initializers, void 0));
+        get variant() { return this.#variant_accessor_storage; }
+        set variant(value) { this.#variant_accessor_storage = value; }
+        _theme = __runInitializers(this, _variant_extraInitializers);
+        constructor(options) {
+            super();
+            this.id = options.id ?? `toggle-${options.label.toLowerCase().replace(/\s+/g, "-")}`;
+            this.label = options.label;
+            this.on = options.on ?? false;
+            this.variant = options.variant ?? "default";
+            this.disabled = options.disabled ?? false;
+            this._theme = options.theme ?? DEFAULT_TERMINAL_THEME;
+        }
+        setTheme(theme) { this._theme = theme; }
+        // --- Event handlers ---
+        handleKey(event) {
+            if (this.disabled)
+                return;
+            if (event.key === "space") {
+                this.on = !this.on;
+                this.emitChange();
+                return;
+            }
+            if (event.key === "enter") {
+                this.emitSubmit();
+            }
+        }
+        handleMouse(event) {
+            if (this.disabled)
+                return;
+            if (event.type === "mouse_up") {
+                this.on = !this.on;
+                this.emitChange();
+            }
+        }
+        // --- Hover mutator (router fast-path) ---
+        setHovered(value) { this.hovered = value; }
+        // --- Rendering ---
+        render(_options) {
+            // Both indicators are exactly 5 cells: "[ON] " and "[OFF]".
+            const indicator = this.on ? "[ON] " : "[OFF]";
+            const text = `${indicator} ${this.label}`;
+            if (this.disabled) {
+                return [new Segment(text, new Style({ color: "#666666", bgcolor: "#333333", dim: true }))];
+            }
+            const keys = VARIANT_KEYS[this.variant];
+            const fg = this.resolvePalette(this.on ? keys.onFg : keys.offFg);
+            const bg = this.resolvePalette(this.on ? keys.onBg : keys.offBg);
+            return [new Segment(text, new Style({ color: fg, bgcolor: bg, underline: this.focused }))];
+        }
+        measure(_options) {
+            const width = 5 + 1 + this.label.length;
+            return { minimum: width, maximum: width };
+        }
+        // --- Palette resolution ---
+        resolvePalette(key) {
+            const rgba = this._theme.palette.get(key);
+            // [LAW:no-defensive-null-guards] palette must contain all keys; missing is a construction bug.
+            return ColorSpec.fromRgba(rgba);
+        }
+    };
+})();
+export { Toggle };
+//# sourceMappingURL=toggle.js.map

package/dist/widgets/toggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.js","sourceRoot":"","sources":["../../src/widgets/toggle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAc9C,wEAAwE;AACxE,0EAA0E;AAC1E,wEAAwE;AACxE,yEAAyE;AACzE,oDAAoD;AACpD,MAAM,YAAY,GAGd;IACF,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAQ,KAAK,EAAE,YAAY,EAAE;IAC7F,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE;IAC/F,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE;IAC/F,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE;IAC/F,MAAM,EAAG,EAAE,IAAI,EAAE,OAAO,EAAI,IAAI,EAAE,UAAU,EAAI,KAAK,EAAE,aAAa,EAAI,KAAK,EAAE,YAAY,EAAE;CAC9F,CAAC;IAEW,MAAM;;sBAAS,UAAU;;;;;;;;;;;;;;iBAAzB,MAAO,SAAQ,WAAU;;;iCAInC,UAAU;8BACV,UAAU;mCACV,CAAA,KAAA,UAAU,CAAA,CAAC,GAAG;qCAkBd,MAAM;uCAaN,MAAM;sCAWN,MAAM;YA5CK,oKAAS,KAAK,6BAAL,KAAK,qFAAS;YACvB,2JAAS,EAAE,6BAAF,EAAE,+EAAU;YACjB,0KAAS,OAAO,6BAAP,OAAO,yFAAgB;YAmBhD,8KAAA,SAAS,6DAUR;YAGD,oLAAS,WAAW,6DAMnB;YAKD,iLAAA,UAAU,6DAAgD;;;QAhDjD,EAAE,GADA,mDAAM,CACG;QACX,SAAS,GAAG,IAAI,CAAC;QAEd,+EAAuB;QAAvB,IAAS,KAAK,2CAAS;QAAvB,IAAS,KAAK,iDAAS;QACvB,8HAAqB;QAArB,IAAS,EAAE,wCAAU;QAArB,IAAS,EAAE,8CAAU;QACjB,qIAAgC;QAAhC,IAAS,OAAO,6CAAgB;QAAhC,IAAS,OAAO,mDAAgB;QAExC,MAAM,uDAAgB;QAE9B,YAAY,OAAsB;YAChC,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,UAAU,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YACrF,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAC3B,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,KAAK,CAAC;YAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC;YAC5C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;YAC1C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,sBAAsB,CAAC;QACxD,CAAC;QAED,QAAQ,CAAC,KAAoB,IAAU,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;QAE7D,yBAAyB;QAGzB,SAAS,CAAC,KAAe;YACvB,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAC1B,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;gBAC1B,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,UAAU,EAAE,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;gBAC1B,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,CAAC;QACH,CAAC;QAGQ,WAAW,CAAC,KAAuB;YAC1C,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC9B,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,CAAC;QACH,CAAC;QAED,2CAA2C;QAG3C,UAAU,CAAC,KAAc,IAAU,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC;QAE1D,oBAAoB;QAEpB,MAAM,CAAC,QAAuB;YAC5B,4DAA4D;YAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9C,MAAM,IAAI,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAE1C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7F,CAAC;YAED,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjE,MAAM,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAEjE,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7F,CAAC;QAED,OAAO,CAAC,QAAuB;YAC7B,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YACxC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5C,CAAC;QAED,6BAA6B;QAErB,cAAc,CAAC,GAAW;YAChC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC1C,+FAA+F;YAC/F,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAK,CAAC,CAAC;QACnC,CAAC;;;SAhFU,MAAM"}

package/dist/widgets/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Interactive widget event types and core interfaces.
+ * [LAW:one-source-of-truth] These types are the single authority for the widget contract.
+ * Widgets are MobX-observable state machines that implement Renderable,
+ * producing Segment[] from current state. They have no knowledge of stdin,
+ * terminal escape sequences, or their host environment.
+ */
+import type { Renderable, Measurable, RenderOptions } from "../core/protocol.js";
+import type { Segment } from "../core/segment.js";
+export interface KeyEvent {
+    key: string;
+    character: string;
+    shift: boolean;
+    ctrl: boolean;
+    meta: boolean;
+}
+export interface WidgetMouseEvent {
+    type: "click" | "mouse_down" | "mouse_up" | "mouse_move" | "scroll_up" | "scroll_down";
+    x: number;
+    y: number;
+    button: number;
+    shift: boolean;
+    ctrl: boolean;
+}
+export interface WidgetFocusEvent {
+    type: "focus" | "blur";
+}
+export interface WidgetBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface InteractiveWidget extends Renderable, Measurable {
+    readonly id: string;
+    readonly focusable: boolean;
+    focused: boolean;
+    hovered: boolean;
+    active: boolean;
+    disabled: boolean;
+    visible: boolean;
+    bounds: WidgetBounds | null;
+    handleKey(event: KeyEvent): void;
+    handleMouse(event: WidgetMouseEvent): void;
+    handleFocus(event: WidgetFocusEvent): void;
+    focus(): void;
+    blur(): void;
+    setDisabled(value: boolean): void;
+    containsPoint(x: number, y: number): boolean;
+    onChange(handler: (widget: InteractiveWidget) => void): () => void;
+    onSubmit(handler: (widget: InteractiveWidget) => void): () => void;
+}
+export type Placement = {
+    kind: "flow";
+} | {
+    kind: "inline";
+} | {
+    kind: "fixed";
+    x: number;
+    y: number;
+};
+export declare const FLOW: Placement;
+export interface OverlayRenderable {
+    renderOverlay(options: RenderOptions): Iterable<Segment> | null;
+}
+export declare function hasOverlay(value: object): value is OverlayRenderable;
+export type Unsubscribe = () => void;
+export interface FocusManager {
+    readonly current: InteractiveWidget | null;
+    readonly widgets: readonly InteractiveWidget[];
+    register(widget: InteractiveWidget): void;
+    unregister(widget: InteractiveWidget): void;
+    next(): void;
+    prev(): void;
+    focus(widget: InteractiveWidget): void;
+    blur(): void;
+    onChange(handler: (current: InteractiveWidget | null) => void): Unsubscribe;
+}
+export type MountEntry = InteractiveWidget | {
+    widget: InteractiveWidget;
+    placement: Placement;
+};
+export interface Screen {
+    mount(...entries: MountEntry[]): void;
+    unmount(widget: InteractiveWidget): void;
+    start(): void;
+    stop(): void;
+    readonly focusManager: FocusManager;
+    readonly running: boolean;
+    readonly widgets: readonly InteractiveWidget[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/widgets/types.js

@@ -0,0 +1,13 @@
+/**
+ * Interactive widget event types and core interfaces.
+ * [LAW:one-source-of-truth] These types are the single authority for the widget contract.
+ * Widgets are MobX-observable state machines that implement Renderable,
+ * producing Segment[] from current state. They have no knowledge of stdin,
+ * terminal escape sequences, or their host environment.
+ */
+export const FLOW = { kind: "flow" };
+export function hasOverlay(value) {
+    return ("renderOverlay" in value &&
+        typeof value.renderOverlay === "function");
+}
+//# sourceMappingURL=types.js.map

package/dist/widgets/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/widgets/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+FH,MAAM,CAAC,MAAM,IAAI,GAAc,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAsBhD,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,CACL,eAAe,IAAI,KAAK;QACxB,OAAQ,KAA2B,CAAC,aAAa,KAAK,UAAU,CACjE,CAAC;AACJ,CAAC"}

package/dist/widgets/widget-base.d.ts

@@ -0,0 +1,41 @@
+/**
+ * WidgetBase — shared MobX observable foundation for interactive widgets.
+ * [LAW:one-type-per-behavior] All widgets share the same base; differences
+ * are in configuration and state, not in infrastructure.
+ *
+ * Uses makeObservable (not makeAutoObservable) because subclasses extend this.
+ * MobX 6.x with TC39 decorators requires `accessor` keyword.
+ */
+import type { Segment } from "../core/segment.js";
+import type { RenderOptions } from "../core/protocol.js";
+import type { InteractiveWidget, KeyEvent, WidgetMouseEvent, WidgetFocusEvent, WidgetBounds, Unsubscribe } from "./types.js";
+export declare abstract class WidgetBase implements InteractiveWidget {
+    abstract readonly id: string;
+    abstract readonly focusable: boolean;
+    accessor focused: boolean;
+    accessor hovered: boolean;
+    accessor active: boolean;
+    accessor disabled: boolean;
+    accessor visible: boolean;
+    accessor bounds: WidgetBounds | null;
+    private readonly changeHandlers;
+    private readonly submitHandlers;
+    constructor();
+    abstract handleKey(event: KeyEvent): void;
+    handleMouse(_event: WidgetMouseEvent): void;
+    handleFocus(event: WidgetFocusEvent): void;
+    focus(): void;
+    blur(): void;
+    setDisabled(value: boolean): void;
+    containsPoint(x: number, y: number): boolean;
+    onChange(handler: (widget: InteractiveWidget) => void): Unsubscribe;
+    onSubmit(handler: (widget: InteractiveWidget) => void): Unsubscribe;
+    protected emitChange(): void;
+    protected emitSubmit(): void;
+    abstract render(options: RenderOptions): Iterable<Segment>;
+    abstract measure(options: RenderOptions): {
+        minimum: number;
+        maximum: number;
+    };
+}
+//# sourceMappingURL=widget-base.d.ts.map