@askdkc/dsh-cli 0.11.3

package/lib/types/ink/components/App.d.ts

@@ -0,0 +1,149 @@
+import React, { PureComponent, type ReactNode } from "react";
+import { EventEmitter } from "../events/emitter.js";
+import { DragEvent } from "../events/drag-event.js";
+import type { DOMElement } from "../dom.js";
+import { type ParsedKey, type ParsedMouse } from "../parse-keypress.js";
+import { type SelectionState } from "../selection.js";
+import { TerminalQuerier } from "../terminal-querier.js";
+import { type CursorDeclarationSetter } from "./CursorDeclarationContext.js";
+type Props = {
+    readonly children: ReactNode;
+    readonly stdin: NodeJS.ReadStream;
+    readonly stdout: NodeJS.WriteStream;
+    readonly stderr: NodeJS.WriteStream;
+    readonly exitOnCtrlC: boolean;
+    readonly onExit: (error?: Error) => void;
+    readonly terminalColumns: number;
+    readonly terminalRows: number;
+    readonly selection: SelectionState;
+    readonly onSelectionChange: () => void;
+    readonly onClickAt: (col: number, row: number, button?: number, deferProbe?: boolean) => boolean;
+    readonly onContextMenuAt: (col: number, row: number, button?: number) => boolean;
+    readonly onHoverAt: (col: number, row: number) => void;
+    readonly onWheelAt: (col: number, row: number, deltaY: number, deltaX: number, button?: number) => boolean;
+    readonly getHyperlinkAt: (col: number, row: number) => string | undefined;
+    readonly onOpenHyperlink: (url: string) => void;
+    readonly onMultiClick: (col: number, row: number, count: 2 | 3) => void;
+    readonly onSelectionDrag: (col: number, row: number) => void;
+    readonly onDragTargetAt?: (col: number, row: number) => DOMElement | null;
+    readonly onDragDispatch?: (target: DOMElement, event: DragEvent) => void;
+    readonly onPointerGestureChange?: (active: boolean) => void;
+    readonly onProtocolCandidateChange?: (active: boolean) => void;
+    readonly onReleaseTail?: () => void;
+    readonly onClickProbe?: () => void;
+    readonly onStdinResume?: () => void;
+    readonly onTerminalFocus?: (focused: boolean) => void;
+    readonly onCursorDeclaration?: CursorDeclarationSetter;
+    readonly dispatchKeyboardEvent: (parsedKey: ParsedKey) => void;
+};
+type State = {
+    readonly error?: Error;
+};
+export default class App extends PureComponent<Props, State> {
+    static displayName: string;
+    static getDerivedStateFromError(error: Error): {
+        error: Error;
+    };
+    state: {
+        error: undefined;
+    };
+    rawModeEnabledCount: number;
+    internal_eventEmitter: EventEmitter;
+    keyParseState: import("../parse-keypress.js").KeyParseState;
+    incompleteEscapeTimer: NodeJS.Timeout | null;
+    xtversionProbe: NodeJS.Immediate | null;
+    xtversionAttempted: boolean;
+    readonly NORMAL_TIMEOUT = 50;
+    readonly PASTE_TIMEOUT = 500;
+    querier: TerminalQuerier;
+    lastClickTime: number;
+    lastClickCol: number;
+    lastClickRow: number;
+    clickCount: number;
+    pendingHyperlinkTimer: ReturnType<typeof setTimeout> | null;
+    /**
+     * Bitmask of currently held mouse buttons (bit 0 = left, 1 = middle,
+     * 2 = right). Updated in the transport layer of handleMouseEvent BEFORE
+     * the click-disabled gate, so DSH_TUI_DISABLE_MOUSE=1 still maintains
+     * the physical latch. X10's generic release (low bits 3) cannot identify
+     * which button ended and conservatively clears the entire set — a
+     * no-button motion or focus-out is the reliable termination signal.
+     */
+    heldButtons: number;
+    /**
+     * Set when an X10 generic release (low bits 3) arrived with buttons still
+     * potentially held — the release carries no button identity, so the probe
+     * stays blocked until a reliable termination signal (no-button motion,
+     * focus-out, or a fresh press identifying the still-held button).
+     */
+    ambiguousHeld: boolean;
+    /**
+     * Set when a release, focus-out, or no-button motion cleared the gesture
+     * latch during the current batch. processKeysInBatch drains the deferred
+     * alt-screen re-entry / blocked probe at the batch tail, not mid-batch —
+     * a single stdin chunk can carry `release → next press`, and draining
+     * between them would write probe bytes into the next gesture's opening
+     * window.
+     */
+    pendingReleaseTail: boolean;
+    /**
+     * Set when FOCUS_IN arrived during the current batch. The focus probe
+     * (handleTerminalFocusProbe) is deferred to the batch tail so a single
+     * stdin chunk carrying FOCUS_IN + press doesn't write probe bytes before
+     * the press latch is established.
+     */
+    pendingFocusProbe: boolean;
+    /**
+     * Set when a release-path click deferred its health probe (deferProbe).
+     * The probe fires at the batch tail via onClickProbe.
+     */
+    pendingClickProbe: boolean;
+    lastHoverCol: number;
+    lastHoverRow: number;
+    dragSession: {
+        target: DOMElement;
+        startCol: number;
+        startRow: number;
+        lastCol: number;
+        lastRow: number;
+        started: boolean;
+    } | null;
+    /**
+     * End an in-flight drag session without a release event (focus lost,
+     * screen swap, pointer-state reset): fire dragend at the last known
+     * pointer position so consumers aren't left with an orphan session.
+     * A session that never started (press without movement) ends silently.
+     */
+    finishDragSession(): void;
+    /**
+     * Reset all transient pointer state. Called by Ink when the alt screen
+     * is entered/exited and on resize: rects, hover targets, and the click
+     * chain from the previous screen geometry/scene must not leak into the
+     * new one (stale hover sets would suppress the next real onMouseEnter;
+     * a stale clickCount could turn the first click on a fresh screen into
+     * a double-click).
+     */
+    resetPointerState(): void;
+    lastStdinTime: number;
+    writeRaw: (data: string) => void;
+    isRawModeSupported(): boolean;
+    render(): React.JSX.Element;
+    componentDidMount(): void;
+    componentWillUnmount(): void;
+    /** Release timers and stdin ownership without requiring a React unmount. */
+    detachForShutdown(): void;
+    componentDidCatch(error: Error): void;
+    scheduleXtversionProbe: () => void;
+    handleSetRawMode: (isEnabled: boolean) => void;
+    flushIncomplete: () => void;
+    processInput: (input: string | Buffer | null) => void;
+    handleReadable: () => void;
+    handleInput: (input: string | undefined) => void;
+    handleExit: (error?: Error) => void;
+    handleTerminalFocus: (isFocused: boolean) => void;
+    handleSuspend: () => void;
+}
+/** Exported for testing. Mutates app.props.selection and click/hover state. */
+export declare function handleMouseEvent(app: App, m: ParsedMouse): void;
+export {};
+//# sourceMappingURL=App.d.ts.map

package/lib/types/ink/components/App.d.ts.map

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