@mlightcad/cad-simple-viewer 1.2.4 → 1.3.0

package/lib/editor/input/ui/AcEdFloatingInputBoxes.d.ts

@@ -0,0 +1,104 @@
+import { AcEdFloatingInputBox } from './AcEdFloatingInputBox';
+import { AcEdFloatingInputCancelCallback, AcEdFloatingInputChangeCallback, AcEdFloatingInputCommitCallback, AcEdFloatingInputRawData, AcEdFloatingInputValidationCallback } from './AcEdFloatingInputTypes';
+/**
+ * Construction options for {@link AcEdFloatingInputBoxes}.
+ */
+export interface AcEdFloatingInputBoxesOptions<T> {
+    /**
+     * The parent element to constrain the floating input within.
+     */
+    parent: HTMLElement;
+    /**
+     * If true, display both X and Y inputs.
+     * If false, display only X input (useful for distance, angle, etc.).
+     *
+     * Default: `true`
+     */
+    twoInputs?: boolean;
+    /**
+     * Custom validation function.
+     */
+    validate: AcEdFloatingInputValidationCallback<T>;
+    /**
+     * Callback invoked when user confirms valid input by pressing Enter.
+     */
+    onCommit?: AcEdFloatingInputCommitCallback<T>;
+    /**
+     * Callback invoked on each input event after validation completes.
+     */
+    onChange?: AcEdFloatingInputChangeCallback<T>;
+    /**
+     * Callback invoked on cancellation (Escape or hide()).
+     */
+    onCancel?: AcEdFloatingInputCancelCallback;
+}
+/**
+ * Container holding one or two floating input boxes.
+ *
+ * Always contains:
+ *      - X input box
+ *
+ * Contains Y input box only if `twoInputs` is true.
+ */
+export declare class AcEdFloatingInputBoxes<T> {
+    /** Root DOM node that contains X and optional Y input boxes */
+    readonly parent: HTMLElement;
+    /** Whether this input uses X+Y fields or X-only. @private */
+    readonly twoInputs: boolean;
+    /** Always present */
+    readonly xInput: AcEdFloatingInputBox;
+    /** Only present when twoInputs = true */
+    readonly yInput?: AcEdFloatingInputBox;
+    /**
+     * Cached bound handler for keyboard events—ensures removal works.
+     */
+    private boundOnKeyDown;
+    /**
+     * Cached bound handler for input events—ensures removal works.
+     */
+    private boundOnInput;
+    private onCommit?;
+    private onChange?;
+    private onCancel?;
+    private validateFn;
+    /**
+     * Constructs one instance of this class
+     * @param parent - The container element of X and Y inputs
+     * @param twoInputs - The flag whether to show Y input
+     */
+    constructor(options: AcEdFloatingInputBoxesOptions<T>);
+    /** Returns true if user typed in ANY input box */
+    get userTyped(): boolean;
+    /** Return one flag to indicate whether one of inputs is focused. */
+    get focused(): boolean | undefined;
+    /** Focus on X input */
+    focus(): void;
+    /** Sets text value of X and Y inputs if user doesn't type value */
+    setValue(value: AcEdFloatingInputRawData): void;
+    /**
+     * Disposes the floating input widget permanently.
+     *
+     * - Removes all event listeners (keyboard, input, mouse move).
+     * - Removes the widget's DOM container from the parent.
+     * - Marks the widget as disposed; after this, it cannot be shown again.
+     *
+     * Safe to call multiple times; subsequent calls have no effect.
+     */
+    dispose(): void;
+    /**
+     * Handles input events from X or Y fields.
+     * Triggers validation and notifies listeners through `onChange`.
+     */
+    private handleInput;
+    /**
+     * Handles keyboard events (Enter for commit, Escape for cancel).
+     */
+    private handleKeyDown;
+    /**
+     * Validates the input values using either:
+     * - the user-provided custom validation function, OR
+     * - the built-in numeric parser.
+     */
+    private validate;
+}
+//# sourceMappingURL=AcEdFloatingInputBoxes.d.ts.map

package/lib/editor/input/ui/AcEdFloatingInputBoxes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdFloatingInputBoxes.d.ts","sourceRoot":"","sources":["../../../../src/editor/input/ui/AcEdFloatingInputBoxes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,EAC/B,+BAA+B,EAC/B,wBAAwB,EACxB,mCAAmC,EAEpC,MAAM,0BAA0B,CAAA;AAEjC;;GAEG;AACH,MAAM,WAAW,6BAA6B,CAAC,CAAC;IAC9C;;OAEG;IACH,MAAM,EAAE,WAAW,CAAA;IAEnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;OAEG;IACH,QAAQ,EAAE,mCAAmC,CAAC,CAAC,CAAC,CAAA;IAEhD;;OAEG;IACH,QAAQ,CAAC,EAAE,+BAA+B,CAAC,CAAC,CAAC,CAAA;IAE7C;;OAEG;IACH,QAAQ,CAAC,EAAE,+BAA+B,CAAC,CAAC,CAAC,CAAA;IAE7C;;OAEG;IACH,QAAQ,CAAC,EAAE,+BAA+B,CAAA;CAC3C;AAED;;;;;;;GAOG;AACH,qBAAa,sBAAsB,CAAC,CAAC;IACnC,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAE5B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAE3B,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IAErC,yCAAyC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAA;IAEtC;;OAEG;IACH,OAAO,CAAC,cAAc,CAA4B;IAElD;;OAEG;IACH,OAAO,CAAC,YAAY,CAAY;IAKhC,OAAO,CAAC,QAAQ,CAAC,CAAoC;IACrD,OAAO,CAAC,QAAQ,CAAC,CAAoC;IACrD,OAAO,CAAC,QAAQ,CAAC,CAAiC;IAClD,OAAO,CAAC,UAAU,CAAwC;IAE1D;;;;OAIG;gBACS,OAAO,EAAE,6BAA6B,CAAC,CAAC,CAAC;IA8BrD,kDAAkD;IAClD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,oEAAoE;IACpE,IAAI,OAAO,wBAEV;IAED,uBAAuB;IACvB,KAAK;IAIL,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,wBAAwB;IAOxC;;;;;;;;OAQG;IACH,OAAO;IAYP;;;OAGG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgCrB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;CAMjB"}

package/lib/editor/input/ui/AcEdFloatingInputBoxes.js

@@ -0,0 +1,154 @@
+import { AcEdFloatingInputBox } from './AcEdFloatingInputBox';
+/**
+ * Container holding one or two floating input boxes.
+ *
+ * Always contains:
+ *      - X input box
+ *
+ * Contains Y input box only if `twoInputs` is true.
+ */
+var AcEdFloatingInputBoxes = /** @class */ (function () {
+    /**
+     * Constructs one instance of this class
+     * @param parent - The container element of X and Y inputs
+     * @param twoInputs - The flag whether to show Y input
+     */
+    function AcEdFloatingInputBoxes(options) {
+        var _this = this;
+        var _a;
+        this.parent = options.parent;
+        this.twoInputs = (_a = options.twoInputs) !== null && _a !== void 0 ? _a : true;
+        // Bind events
+        this.boundOnInput = function () { return _this.handleInput(); };
+        this.boundOnKeyDown = function (e) { return _this.handleKeyDown(e); };
+        this.xInput = new AcEdFloatingInputBox(this.parent);
+        this.xInput.addEventListener('input', this.boundOnInput);
+        this.xInput.addEventListener('keydown', this.boundOnKeyDown);
+        if (this.twoInputs) {
+            this.yInput = new AcEdFloatingInputBox(this.parent);
+            this.yInput.addEventListener('input', this.boundOnInput);
+            this.yInput.addEventListener('keydown', this.boundOnKeyDown);
+        }
+        this.validateFn = options.validate;
+        this.onCommit = options.onCommit;
+        this.onChange = options.onChange;
+        this.onCancel = options.onCancel;
+        // Focus/select after mount
+        setTimeout(function () {
+            if (_this.yInput)
+                _this.yInput.select();
+            _this.xInput.focus();
+            _this.xInput.select();
+        }, 0);
+    }
+    Object.defineProperty(AcEdFloatingInputBoxes.prototype, "userTyped", {
+        /** Returns true if user typed in ANY input box */
+        get: function () {
+            var _a;
+            return this.xInput.userTyped || !!((_a = this.xInput) === null || _a === void 0 ? void 0 : _a.userTyped);
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcEdFloatingInputBoxes.prototype, "focused", {
+        /** Return one flag to indicate whether one of inputs is focused. */
+        get: function () {
+            var _a;
+            return this.xInput.focused || ((_a = this.yInput) === null || _a === void 0 ? void 0 : _a.focused);
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /** Focus on X input */
+    AcEdFloatingInputBoxes.prototype.focus = function () {
+        this.xInput.focus();
+    };
+    /** Sets text value of X and Y inputs if user doesn't type value */
+    AcEdFloatingInputBoxes.prototype.setValue = function (value) {
+        var _a;
+        if (!this.xInput.userTyped)
+            this.xInput.value = value.x;
+        if (this.twoInputs && this.yInput && !this.yInput.userTyped) {
+            this.yInput.value = (_a = value.y) !== null && _a !== void 0 ? _a : '';
+        }
+    };
+    /**
+     * Disposes the floating input widget permanently.
+     *
+     * - Removes all event listeners (keyboard, input, mouse move).
+     * - Removes the widget's DOM container from the parent.
+     * - Marks the widget as disposed; after this, it cannot be shown again.
+     *
+     * Safe to call multiple times; subsequent calls have no effect.
+     */
+    AcEdFloatingInputBoxes.prototype.dispose = function () {
+        var _a;
+        this.xInput.removeEventListener('input', this.boundOnInput);
+        this.xInput.removeEventListener('keydown', this.boundOnKeyDown);
+        this.xInput.dispose();
+        if (this.yInput) {
+            this.yInput.removeEventListener('input', this.boundOnInput);
+            this.yInput.removeEventListener('keydown', this.boundOnKeyDown);
+            (_a = this.yInput) === null || _a === void 0 ? void 0 : _a.dispose();
+        }
+    };
+    /**
+     * Handles input events from X or Y fields.
+     * Triggers validation and notifies listeners through `onChange`.
+     */
+    AcEdFloatingInputBoxes.prototype.handleInput = function () {
+        var _a;
+        var state = this.validate();
+        (_a = this.onChange) === null || _a === void 0 ? void 0 : _a.call(this, state);
+    };
+    /**
+     * Handles keyboard events (Enter for commit, Escape for cancel).
+     */
+    AcEdFloatingInputBoxes.prototype.handleKeyDown = function (e) {
+        var _a, _b;
+        // Find out which input element triggers this event
+        var currentInput = this.xInput;
+        var nextInput = this.yInput;
+        if (this.yInput && this.yInput.isEventTarget(e)) {
+            currentInput = this.yInput;
+            nextInput = this.xInput;
+        }
+        if (e.key === 'Enter') {
+            var state = this.validate();
+            if (state.isValid && state.value != null) {
+                (_a = this.onCommit) === null || _a === void 0 ? void 0 : _a.call(this, state.value);
+                currentInput.markValid();
+            }
+            else {
+                currentInput.markInvalid();
+            }
+            e.preventDefault();
+            e.stopPropagation();
+        }
+        else if (e.key === 'Escape') {
+            (_b = this.onCancel) === null || _b === void 0 ? void 0 : _b.call(this);
+            e.preventDefault();
+            e.stopPropagation();
+        }
+        else if (e.key === 'Tab') {
+            e.preventDefault();
+            if (nextInput) {
+                nextInput === null || nextInput === void 0 ? void 0 : nextInput.focus();
+                nextInput === null || nextInput === void 0 ? void 0 : nextInput.select();
+            }
+        }
+    };
+    /**
+     * Validates the input values using either:
+     * - the user-provided custom validation function, OR
+     * - the built-in numeric parser.
+     */
+    AcEdFloatingInputBoxes.prototype.validate = function () {
+        var rawX = this.xInput.value.trim();
+        var rawY = this.twoInputs && this.yInput ? this.yInput.value.trim() : undefined;
+        return this.validateFn({ x: rawX, y: rawY });
+    };
+    return AcEdFloatingInputBoxes;
+}());
+export { AcEdFloatingInputBoxes };
+//# sourceMappingURL=AcEdFloatingInputBoxes.js.map

package/lib/editor/input/ui/AcEdFloatingInputBoxes.js.map

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

package/lib/editor/input/ui/AcEdFloatingInputTypes.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Describes the raw text values from the X and Y fields in {@link AcEdFloatingInput}.
+ */
+export interface AcEdFloatingInputRawData {
+    /** Raw text value in the X input box */
+    x: string;
+    /** Raw text value in the Y input box */
+    y?: string;
+}
+export interface AcEdFloatingInputDynamicValue<T> {
+    /** Parsed data value */
+    value: T;
+    /** Raw text values set to the X and Y fields in {@link AcEdFloatingInput}. */
+    raw: AcEdFloatingInputRawData;
+}
+/**
+ * Describes the output of a validation operation performed on the user-typed
+ * raw text values from the X and Y fields in {@link AcEdFloatingInput}.
+ */
+export interface AcEdFloatingInputValidationResult<T> {
+    /** Parsed data value */
+    value?: T;
+    /** Whether the validation succeeded. */
+    isValid: boolean;
+}
+/**
+ * A callback capable of validating the raw textual contents of the X and Y
+ * input fields.
+ *
+ * The caller receives two raw strings:
+ * - `x`: raw string in the X textbox
+ * - `y`: raw string in the Y textbox, or `null` if Y input is disabled
+ *
+ * The callback should parse these strings and determine whether the input set
+ * is valid. It then returns an {@link AcEdFloatingInputValidationResult}.
+ */
+export type AcEdFloatingInputValidationCallback<T> = (raw: AcEdFloatingInputRawData) => AcEdFloatingInputValidationResult<T>;
+/**
+ * Callback invoked when the user confirms input via the Enter key.
+ * Receives the parsed (and validated) X and Y values.
+ *
+ * When `twoInputs` is `false`, Y will always be `null`.
+ */
+export type AcEdFloatingInputCommitCallback<T> = (point: T) => void;
+/**
+ * Callback invoked whenever the user edits either input field.
+ *
+ * Called only after validation (custom or built-in). Useful for dynamic
+ * real-time preview, updating temporary graphics, or displaying error states.
+ */
+export type AcEdFloatingInputChangeCallback<T> = (state: AcEdFloatingInputValidationResult<T>) => void;
+/**
+ * Callback invoked when input box closes due to user cancelling,
+ * typically by pressing Escape or programmatically via `hide()`.
+ */
+export type AcEdFloatingInputCancelCallback = () => void;
+/**
+ * Callback invoked on mousemove to update the preview geometry.
+ */
+export type AcEdFloatingInputDrawPreviewCallback = (x: number, y: number) => void;
+/**
+ * Callback used to dynamically compute input values for the floating input fields.
+ */
+export type AcEdFloatingInputDynamicValueCallback<T> = (x: number, y: number) => AcEdFloatingInputDynamicValue<T>;
+/**
+ * Construction options for {@link AcEdFloatingInput}.
+ */
+export interface AcEdFloatingInputOptions<T> {
+    /**
+     * Optional parent element to constrain the floating input within.
+     * If not provided, the container is added to document.body.
+     */
+    parent?: HTMLElement;
+    /**
+     * If true, display both X and Y inputs.
+     * If false, display only X input (useful for distance, angle, etc.).
+     *
+     * Default: `true`
+     */
+    twoInputs?: boolean;
+    /**
+     * A message or hint displayed above the input fields.
+     * Useful for describing expected input (e.g., "Specify next point").
+     */
+    message?: string;
+    /**
+     * Custom validation function.
+     */
+    validate: AcEdFloatingInputValidationCallback<T>;
+    /**
+     * Optional callback to dynamically compute values for X/Y inputs.
+     * Called whenever the input is empty and the mouse moves, providing
+     * context-dependent defaults for the user.
+     */
+    getDynamicValue: AcEdFloatingInputDynamicValueCallback<T>;
+    /**
+     * Callback invoked on mousemove to update the preview geometry.
+     */
+    drawPreview?: AcEdFloatingInputDrawPreviewCallback;
+    /**
+     * Callback invoked when user confirms valid input by pressing Enter.
+     */
+    onCommit?: AcEdFloatingInputCommitCallback<T>;
+    /**
+     * Callback invoked on each input event after validation completes.
+     */
+    onChange?: AcEdFloatingInputChangeCallback<T>;
+    /**
+     * Callback invoked on cancellation (Escape or hide()).
+     */
+    onCancel?: AcEdFloatingInputCancelCallback;
+}
+//# sourceMappingURL=AcEdFloatingInputTypes.d.ts.map

package/lib/editor/input/ui/AcEdFloatingInputTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdFloatingInputTypes.d.ts","sourceRoot":"","sources":["../../../../src/editor/input/ui/AcEdFloatingInputTypes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,CAAC,EAAE,MAAM,CAAA;IACT,wCAAwC;IACxC,CAAC,CAAC,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,6BAA6B,CAAC,CAAC;IAC9C,wBAAwB;IACxB,KAAK,EAAE,CAAC,CAAA;IACR,8EAA8E;IAC9E,GAAG,EAAE,wBAAwB,CAAA;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,iCAAiC,CAAC,CAAC;IAClD,wBAAwB;IACxB,KAAK,CAAC,EAAE,CAAC,CAAA;IACT,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mCAAmC,CAAC,CAAC,IAAI,CACnD,GAAG,EAAE,wBAAwB,KAC1B,iCAAiC,CAAC,CAAC,CAAC,CAAA;AAEzC;;;;;GAKG;AACH,MAAM,MAAM,+BAA+B,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAA;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,+BAA+B,CAAC,CAAC,IAAI,CAC/C,KAAK,EAAE,iCAAiC,CAAC,CAAC,CAAC,KACxC,IAAI,CAAA;AAET;;;GAGG;AACH,MAAM,MAAM,+BAA+B,GAAG,MAAM,IAAI,CAAA;AAExD;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG,CACjD,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,KACN,IAAI,CAAA;AAET;;GAEG;AACH,MAAM,MAAM,qCAAqC,CAAC,CAAC,IAAI,CACrD,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,KACN,6BAA6B,CAAC,CAAC,CAAC,CAAA;AAErC;;GAEG;AACH,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IAEpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,QAAQ,EAAE,mCAAmC,CAAC,CAAC,CAAC,CAAA;IAEhD;;;;OAIG;IACH,eAAe,EAAE,qCAAqC,CAAC,CAAC,CAAC,CAAA;IAEzD;;OAEG;IACH,WAAW,CAAC,EAAE,oCAAoC,CAAA;IAElD;;OAEG;IACH,QAAQ,CAAC,EAAE,+BAA+B,CAAC,CAAC,CAAC,CAAA;IAE7C;;OAEG;IACH,QAAQ,CAAC,EAAE,+BAA+B,CAAC,CAAC,CAAC,CAAA;IAE7C;;OAEG;IACH,QAAQ,CAAC,EAAE,+BAA+B,CAAA;CAC3C"}

package/lib/editor/input/ui/AcEdFloatingInputTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AcEdFloatingInputTypes.js.map

package/lib/editor/input/ui/AcEdFloatingInputTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdFloatingInputTypes.js","sourceRoot":"","sources":["../../../../src/editor/input/ui/AcEdFloatingInputTypes.ts"],"names":[],"mappings":""}

package/lib/editor/input/ui/AcEdInputManager.d.ts

@@ -0,0 +1,132 @@
+import { AcGeBox2d, AcGePoint3dLike } from '@mlightcad/data-model';
+import { AcEdBaseView } from '../../view';
+import { AcEdPromptAngleOptions, AcEdPromptDistanceOptions, AcEdPromptIntegerOptions, AcEdPromptPointOptions, AcEdPromptStringOptions } from '../prompt';
+/**
+ * A fully type-safe TypeScript class providing CAD-style interactive user input
+ * using floating HTML input boxes and mouse events. Supports collecting points,
+ * distances, angles, numbers, strings, and selecting a 2-point rectangular box
+ * using an HTML overlay rectangle (suitable when the main canvas is a THREE.js
+ * WebGL canvas).
+ */
+export declare class AcEdInputManager {
+    /** Inject styles only once */
+    private static stylesInjected;
+    /** The view associated with this input operation */
+    protected view: AcEdBaseView;
+    /** Stores last confirmed point from getPoint() or getBox() */
+    private lastPoint;
+    /** Stores last confirmed osnap point */
+    private lastOSnapPoint?;
+    /**
+     * The flag to indicate whether it is currently in an “input acquisition” mode (e.g., point
+     * selection, distance/angle prompt, string prompt, etc.),
+     */
+    private active;
+    /**
+     * Construct the manager and attach mousemove listener used for floating input
+     * positioning and live preview updates.
+     *
+     * @param view - The view associated with the input manager
+     */
+    constructor(view: AcEdBaseView);
+    /**
+     * The flag to indicate whether it is currently in an “input acquisition” mode (e.g., point
+     * selection, distance/angle prompt, string prompt, etc.),
+     */
+    get isActive(): boolean;
+    /**
+     * Injects minimal CSS required for the floating input and preview rectangle.
+     * Useful when you do not have a separate CSS file.
+     */
+    private injectCSS;
+    /**
+     * Format a number for display in input box.
+     * Default: 3 decimal places for points/distance, 2 decimal places for angles.
+     * @param value The numeric value
+     * @param type Optional type: 'point' | 'distance' | 'angle'
+     */
+    private formatNumber;
+    /**
+     * Public point input API.
+     */
+    getPoint(options: AcEdPromptPointOptions): Promise<AcGePoint3dLike>;
+    /**
+     * Prompt the user to type a numeric value. If integerOnly is true, integers
+     * are enforced. The input is validated and the box will be marked invalid if
+     * the typed value does not conform, allowing the user to retype.
+     */
+    private getNumberTyped;
+    /** Request a distance (number) from the user. */
+    getDistance(options: AcEdPromptDistanceOptions): Promise<number>;
+    /** Request an angle in degrees from the user. */
+    getAngle(options: AcEdPromptAngleOptions): Promise<number>;
+    /** Request a double/float from the user. */
+    getDouble(options: AcEdPromptDistanceOptions): Promise<number>;
+    /** Request an integer from the user. */
+    getInteger(options: AcEdPromptIntegerOptions): Promise<number>;
+    /**
+     * Prompt the user to type an arbitrary string. Resolved when Enter is pressed.
+     */
+    getString(options: AcEdPromptStringOptions): Promise<string>;
+    /**
+     * Prompt the user to specify a rectangular box by selecting two corners.
+     * Each corner may be specified by clicking on the canvas or typing "x,y".
+     * A live HTML overlay rectangle previews the box as the user moves the mouse.
+     */
+    getBox(): Promise<AcGeBox2d>;
+    /**
+     * Shared point input logic used by getPoint() and getBox(). Accepts "x,y"
+     * typed input OR mouse click.
+     */
+    private getPointInternal;
+    /**
+     * Creates a Promise that will be resolved or rejected by user input.
+     *
+     * This method centralizes the lifecycle of an interactive input operation,
+     * including handling the Escape key to cancel, resolving with user-provided
+     * values, and guaranteeing cleanup of UI elements and event handlers.
+     */
+    private makePromise;
+    /**
+     * Picks entities that intersect a hit-region centered at the specified point
+     * in world coordinates.
+     *
+     * The hit-region is defined as a square (or bounding box) centered at the
+     * input point, whose half-size is determined by the `hitRadius` parameter.
+     * Only entities whose geometry intersects this region are returned.
+     *
+     * @param point The center point of the hit-region in world coordinates.
+     * If omitted, the current cursor position is used.
+     *
+     * @param hitRadius The half-width (in world coordinate system) of the
+     * hit-region around the point. This creates a square bounding box:
+     * [point.x ± hitRadius, point.y ± hitRadius].
+     * A larger value increases the pick sensitivity. If omitted, a reasonable
+     * default is used.
+     * @returns - Returns The OSNAP point in the specified position in world coordinate system
+     * if found. Return undefined if no OSNAP point found.
+     */
+    /**
+     * Gets OSNAP point of entities that intersect a hit-region centered at the
+     * specified point in world coordinates.
+     *
+     * The hit-region is defined as a square (or bounding box) centered at the
+     * input point, whose half-size is determined by the `hitRadius` parameter.
+     * Only entities whose geometry intersects this region are returned.
+     *
+     * @param point The center point of the hit-region in world coordinates.
+     * If omitted, the current cursor position is used.
+     *
+     * @param hitRadius The half-width (in pixel size) of the hit-region around
+     * the point. It will be converted on one value in the world
+     * coordinate 'wcsHitRadius' and creates a square bounding box:
+     * [point.x ± wcsHitRadius, point.y ± wcsHitRadius].
+     * A larger value increases the pick sensitivity. If omitted, a reasonable
+     * default is used.
+     *
+     * @returns An array of object IDs representing the entities that intersect
+     * the hit-region.
+     */
+    private getOSnapPoint;
+}
+//# sourceMappingURL=AcEdInputManager.d.ts.map

package/lib/editor/input/ui/AcEdInputManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdInputManager.d.ts","sourceRoot":"","sources":["../../../../src/editor/input/ui/AcEdInputManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,SAAS,EAGT,eAAe,EAChB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAazC,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EAExB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,WAAW,CAAA;AASlB;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,8BAA8B;IAC9B,OAAO,CAAC,MAAM,CAAC,cAAc,CAAQ;IAErC,oDAAoD;IACpD,SAAS,CAAC,IAAI,EAAE,YAAY,CAAA;IAE5B,8DAA8D;IAC9D,OAAO,CAAC,SAAS,CAA+B;IAEhD,wCAAwC;IACxC,OAAO,CAAC,cAAc,CAAC,CAAiB;IAExC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAiB;IAE/B;;;;;OAKG;gBACS,IAAI,EAAE,YAAY;IAK9B;;;OAGG;IACH,IAAI,QAAQ,YAEX;IAED;;;OAGG;IACH,OAAO,CAAC,SAAS;IAyBjB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAInE;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAsBtB,iDAAiD;IACjD,WAAW,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BhE,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB1D,4CAA4C;IAC5C,SAAS,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D,wCAAwC;IACxC,UAAU,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB5D;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IA0ClC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA8BxB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IA2GnB;;;;;;;;;;;;;;;;;;OAkBG;IACH;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,aAAa;CAoCtB"}