@promptctl/rich-js 0.1.0

package/dist/widgets/slider.js

@@ -0,0 +1,248 @@
+/**
+ * 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
+ *   unfilled — cells right of the marker use surface bg / foreground
+ *   focused  — underline on the segments
+ *   disabled — dim
+ */
+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 DEFAULT_WIDTH = 20;
+let Slider = (() => {
+    var _a, _b, _c, _d;
+    let _classSuper = WidgetBase;
+    let _instanceExtraInitializers = [];
+    let _value_decorators;
+    let _value_initializers = [];
+    let _value_extraInitializers = [];
+    let _min_decorators;
+    let _min_initializers = [];
+    let _min_extraInitializers = [];
+    let _max_decorators;
+    let _max_initializers = [];
+    let _max_extraInitializers = [];
+    let _step_decorators;
+    let _step_initializers = [];
+    let _step_extraInitializers = [];
+    let _width_decorators;
+    let _width_initializers = [];
+    let _width_extraInitializers = [];
+    let _handleKey_decorators;
+    let _handleMouse_decorators;
+    let _setHovered_decorators;
+    let _setValue_decorators;
+    return class Slider extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _value_decorators = [observable];
+            _min_decorators = [(_a = observable).ref.bind(_a)];
+            _max_decorators = [(_b = observable).ref.bind(_b)];
+            _step_decorators = [(_c = observable).ref.bind(_c)];
+            _width_decorators = [(_d = observable).ref.bind(_d)];
+            _handleKey_decorators = [action];
+            _handleMouse_decorators = [action];
+            _setHovered_decorators = [action];
+            _setValue_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, _min_decorators, { kind: "accessor", name: "min", static: false, private: false, access: { has: obj => "min" in obj, get: obj => obj.min, set: (obj, value) => { obj.min = value; } }, metadata: _metadata }, _min_initializers, _min_extraInitializers);
+            __esDecorate(this, null, _max_decorators, { kind: "accessor", name: "max", static: false, private: false, access: { has: obj => "max" in obj, get: obj => obj.max, set: (obj, value) => { obj.max = value; } }, metadata: _metadata }, _max_initializers, _max_extraInitializers);
+            __esDecorate(this, null, _step_decorators, { kind: "accessor", name: "step", static: false, private: false, access: { has: obj => "step" in obj, get: obj => obj.step, set: (obj, value) => { obj.step = value; } }, metadata: _metadata }, _step_initializers, _step_extraInitializers);
+            __esDecorate(this, null, _width_decorators, { kind: "accessor", name: "width", static: false, private: false, access: { has: obj => "width" in obj, get: obj => obj.width, set: (obj, value) => { obj.width = value; } }, metadata: _metadata }, _width_initializers, _width_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);
+            __esDecorate(this, null, _setValue_decorators, { kind: "method", name: "setValue", static: false, private: false, access: { has: obj => "setValue" in obj, get: obj => obj.setValue }, 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; }
+        #min_accessor_storage = (__runInitializers(this, _value_extraInitializers), __runInitializers(this, _min_initializers, void 0));
+        get min() { return this.#min_accessor_storage; }
+        set min(value) { this.#min_accessor_storage = value; }
+        #max_accessor_storage = (__runInitializers(this, _min_extraInitializers), __runInitializers(this, _max_initializers, void 0));
+        get max() { return this.#max_accessor_storage; }
+        set max(value) { this.#max_accessor_storage = value; }
+        #step_accessor_storage = (__runInitializers(this, _max_extraInitializers), __runInitializers(this, _step_initializers, void 0));
+        get step() { return this.#step_accessor_storage; }
+        set step(value) { this.#step_accessor_storage = value; }
+        #width_accessor_storage = (__runInitializers(this, _step_extraInitializers), __runInitializers(this, _width_initializers, void 0));
+        get width() { return this.#width_accessor_storage; }
+        set width(value) { this.#width_accessor_storage = value; }
+        _theme = __runInitializers(this, _width_extraInitializers);
+        _dragging = false;
+        constructor(options = {}) {
+            super();
+            this.id = options.id ?? `slider-${Math.random().toString(36).slice(2, 8)}`;
+            this.min = options.min ?? 0;
+            this.max = options.max ?? 100;
+            this.step = options.step ?? 1;
+            this.width = options.width ?? DEFAULT_WIDTH;
+            this.value = clampSnap(options.value ?? this.min, this.min, this.max, this.step);
+            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;
+            switch (event.key) {
+                case "left":
+                    this.setValue(this.value - this.step);
+                    return;
+                case "right":
+                    this.setValue(this.value + this.step);
+                    return;
+                case "home":
+                    this.setValue(this.min);
+                    return;
+                case "end":
+                    this.setValue(this.max);
+                    return;
+            }
+        }
+        handleMouse(event) {
+            if (this.disabled)
+                return;
+            if (event.type === "mouse_down") {
+                this._dragging = true;
+                this.setValueFromMouseX(event.x);
+                return;
+            }
+            if (event.type === "mouse_move") {
+                if (this._dragging)
+                    this.setValueFromMouseX(event.x);
+                return;
+            }
+            if (event.type === "mouse_up") {
+                const wasDragging = this._dragging;
+                this._dragging = false;
+                if (wasDragging) {
+                    this.setValueFromMouseX(event.x);
+                    this.emitSubmit();
+                }
+                return;
+            }
+        }
+        // --- Hover mutator (router fast-path) ---
+        setHovered(value) { this.hovered = value; }
+        // --- Value mutation ---
+        setValue(next) {
+            const snapped = clampSnap(next, this.min, this.max, this.step);
+            if (snapped === this.value)
+                return;
+            this.value = snapped;
+            this.emitChange();
+        }
+        setValueFromMouseX(x) {
+            const b = this.bounds;
+            if (!b)
+                return;
+            const cellsAvailable = Math.max(1, this.width - 1);
+            const clamped = Math.max(0, Math.min(this.width - 1, x - b.x));
+            const fraction = clamped / cellsAvailable;
+            const next = this.min + fraction * (this.max - this.min);
+            this.setValue(next);
+        }
+        // --- Rendering ---
+        render(options) {
+            const trackChar = options.asciiOnly ? "-" : "─";
+            const markerChar = options.asciiOnly ? "*" : "●";
+            const range = this.max - this.min;
+            const fraction = range === 0 ? 0 : (this.value - this.min) / range;
+            const markerIdx = Math.round(fraction * (this.width - 1));
+            const baseAttrs = { underline: this.focused };
+            const filledStyle = this.disabled
+                ? new Style({ color: "#666666", bgcolor: "#333333", dim: true, ...baseAttrs })
+                : new Style({ color: this.resolvePalette("primary"), ...baseAttrs });
+            const unfilledStyle = this.disabled
+                ? new Style({ color: "#666666", bgcolor: "#333333", dim: true, ...baseAttrs })
+                : new Style({ color: this.resolvePalette("surface"), ...baseAttrs });
+            const markerStyle = this.disabled
+                ? new Style({ color: "#666666", bgcolor: "#333333", dim: true, bold: true, ...baseAttrs })
+                : new Style({ color: this.resolvePalette("primary"), bold: true, ...baseAttrs });
+            const segments = [];
+            if (markerIdx > 0) {
+                segments.push(new Segment(trackChar.repeat(markerIdx), filledStyle));
+            }
+            segments.push(new Segment(markerChar, markerStyle));
+            const tail = this.width - markerIdx - 1;
+            if (tail > 0) {
+                segments.push(new Segment(trackChar.repeat(tail), unfilledStyle));
+            }
+            return segments;
+        }
+        measure(_options) {
+            return { minimum: this.width, maximum: this.width };
+        }
+        // --- 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 { Slider };
+// [LAW:single-enforcer] Single function clamps a numeric value into the
+// [min, max] range and snaps to the nearest step boundary. All value
+// mutations route through this; min/max/step never produce out-of-bounds
+// observable state.
+function clampSnap(value, min, max, step) {
+    const clamped = Math.max(min, Math.min(max, value));
+    if (step <= 0)
+        return clamped;
+    const snapped = min + Math.round((clamped - min) / step) * step;
+    // Floating-point cleanup: re-clamp in case rounding nudged past max.
+    return Math.max(min, Math.min(max, snapped));
+}
+//# sourceMappingURL=slider.js.map

package/dist/widgets/slider.js.map

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

package/dist/widgets/static-item.d.ts

@@ -0,0 +1,41 @@
+/**
+ * StaticItem — a non-focusable, non-interactive Renderable wrapped to fit
+ * the InteractiveWidget surface so it can be mounted by Screen alongside
+ * real widgets.
+ *
+ * [LAW:one-type-per-behavior] Screen.mount accepts a uniform array of
+ * InteractiveWidget. Static text, panels, swatches, and other display-only
+ * Renderables flow through the same pipeline by being expressed as the
+ * same type. The differences (no focus, no event handling) are configured
+ * via `focusable: false` plus the no-op handlers WidgetBase already
+ * provides — there is no second type, no "static vs interactive" branch in
+ * Screen's render loop.
+ *
+ * The wrapped renderable can be a function that re-evaluates each frame
+ * (so the host can read MobX observables inside `render` and have Screen
+ * re-render reactively) or a plain object that returns the same segments
+ * every time.
+ */
+import type { Segment } from "../core/segment.js";
+import type { Measurable, Renderable, RenderOptions } from "../core/protocol.js";
+import { WidgetBase } from "./widget-base.js";
+import type { KeyEvent } from "./types.js";
+export interface StaticItemOptions {
+    id: string;
+    render: Renderable | ((options: RenderOptions) => Iterable<Segment>);
+    measure?: Measurable["measure"];
+}
+export declare class StaticItem extends WidgetBase {
+    readonly id: string;
+    readonly focusable = false;
+    private readonly renderFn;
+    private readonly measureFn;
+    constructor(options: StaticItemOptions);
+    handleKey(_event: KeyEvent): void;
+    render(options: RenderOptions): Iterable<Segment>;
+    measure(options: RenderOptions): {
+        minimum: number;
+        maximum: number;
+    };
+}
+//# sourceMappingURL=static-item.d.ts.map

package/dist/widgets/static-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-item.d.ts","sourceRoot":"","sources":["../../src/widgets/static-item.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IAIX,MAAM,EAAE,UAAU,GAAG,CAAC,CAAC,OAAO,EAAE,aAAa,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAIrE,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;CACjC;AAED,qBAAa,UAAW,SAAQ,UAAU;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,SAAS;IAE3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;IACzE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;gBAElD,OAAO,EAAE,iBAAiB;IAatC,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAEjC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;IAIjD,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAgBtE"}

package/dist/widgets/static-item.js

@@ -0,0 +1,62 @@
+/**
+ * StaticItem — a non-focusable, non-interactive Renderable wrapped to fit
+ * the InteractiveWidget surface so it can be mounted by Screen alongside
+ * real widgets.
+ *
+ * [LAW:one-type-per-behavior] Screen.mount accepts a uniform array of
+ * InteractiveWidget. Static text, panels, swatches, and other display-only
+ * Renderables flow through the same pipeline by being expressed as the
+ * same type. The differences (no focus, no event handling) are configured
+ * via `focusable: false` plus the no-op handlers WidgetBase already
+ * provides — there is no second type, no "static vs interactive" branch in
+ * Screen's render loop.
+ *
+ * The wrapped renderable can be a function that re-evaluates each frame
+ * (so the host can read MobX observables inside `render` and have Screen
+ * re-render reactively) or a plain object that returns the same segments
+ * every time.
+ */
+import { WidgetBase } from "./widget-base.js";
+export class StaticItem extends WidgetBase {
+    id;
+    focusable = false;
+    renderFn;
+    measureFn;
+    constructor(options) {
+        super();
+        this.id = options.id;
+        const r = options.render;
+        this.renderFn =
+            typeof r === "function"
+                ? (opts) => r(opts)
+                : (opts) => r.render(opts);
+        this.measureFn = options.measure;
+    }
+    // Static items don't respond to keys. WidgetBase.handleMouse / handleFocus
+    // are already no-ops, so we only need to satisfy the abstract handleKey.
+    handleKey(_event) { }
+    render(options) {
+        return this.renderFn(options);
+    }
+    measure(options) {
+        if (this.measureFn)
+            return this.measureFn(options);
+        // Render once and use the resulting line width as both min and max.
+        let max = 0;
+        let cur = 0;
+        for (const seg of this.renderFn(options)) {
+            if (seg.text === "\n") {
+                if (cur > max)
+                    max = cur;
+                cur = 0;
+            }
+            else {
+                cur += seg.cellLength;
+            }
+        }
+        if (cur > max)
+            max = cur;
+        return { minimum: max, maximum: max };
+    }
+}
+//# sourceMappingURL=static-item.js.map

package/dist/widgets/static-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-item.js","sourceRoot":"","sources":["../../src/widgets/static-item.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAe9C,MAAM,OAAO,UAAW,SAAQ,UAAU;IAC/B,EAAE,CAAS;IACX,SAAS,GAAG,KAAK,CAAC;IAEV,QAAQ,CAAgD;IACxD,SAAS,CAAoC;IAE9D,YAAY,OAA0B;QACpC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,QAAQ;YACX,OAAO,CAAC,KAAK,UAAU;gBACrB,CAAC,CAAC,CAAC,IAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;gBAClC,CAAC,CAAC,CAAC,IAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IACnC,CAAC;IAED,2EAA2E;IAC3E,yEAAyE;IACzE,SAAS,CAAC,MAAgB,IAAS,CAAC;IAEpC,MAAM,CAAC,OAAsB;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,OAAsB;QAC5B,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACnD,oEAAoE;QACpE,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACtB,IAAI,GAAG,GAAG,GAAG;oBAAE,GAAG,GAAG,GAAG,CAAC;gBACzB,GAAG,GAAG,CAAC,CAAC;YACV,CAAC;iBAAM,CAAC;gBACN,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC;YACxB,CAAC;QACH,CAAC;QACD,IAAI,GAAG,GAAG,GAAG;YAAE,GAAG,GAAG,GAAG,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IACxC,CAAC;CACF"}

package/dist/widgets/text-input.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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
+ */
+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 TextInputOptions {
+    value?: string;
+    placeholder?: string;
+    id?: string;
+    disabled?: boolean;
+    theme?: TerminalTheme;
+    maxLength?: number;
+    password?: boolean;
+}
+export declare class TextInput extends WidgetBase {
+    readonly id: string;
+    readonly focusable = true;
+    accessor value: string;
+    accessor cursorPosition: number;
+    accessor placeholder: string;
+    private _theme;
+    private readonly _maxLength;
+    private readonly _password;
+    constructor(options?: TextInputOptions);
+    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=text-input.d.ts.map

package/dist/widgets/text-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-input.d.ts","sourceRoot":"","sources":["../../src/widgets/text-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;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,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAID,qBAAa,SAAU,SAAQ,UAAU;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,QAAQ;IAEd,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;gBAExB,OAAO,GAAE,gBAAqB;IAY1C,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAKpC,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAqDvB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAcnD,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAIhC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;IAuDjD,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAQtE,OAAO,CAAC,cAAc;CAKvB"}