@askdkc/dsh-cli 0.11.3

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

@@ -0,0 +1,17 @@
+/**
+ * The Ink app's exit handler and output stream.
+ */
+export type Props = {
+    /** The output stream supplied to this app's render call. */
+    readonly stdout: NodeJS.WriteStream;
+    /**
+     * Exit (unmount) the whole Ink app.
+     */
+    readonly exit: (error?: Error) => void;
+};
+/**
+ * App-scoped services shared by the renderer and its descendants.
+ */
+declare const AppContext: import("react").Context<Props>;
+export default AppContext;
+//# sourceMappingURL=AppContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AppContext.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/AppContext.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG;IAClB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAA;IACnC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;CACvC,CAAA;AAED;;GAEG;AAEH,QAAA,MAAM,UAAU,gCAGd,CAAA;AAKF,eAAe,UAAU,CAAA"}

package/lib/types/ink/components/AppContext.js

@@ -0,0 +1,12 @@
+import { createContext } from 'react';
+/**
+ * App-scoped services shared by the renderer and its descendants.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const AppContext = createContext({
+    stdout: process.stdout,
+    exit() { },
+});
+// eslint-disable-next-line custom-rules/no-top-level-side-effects
+AppContext.displayName = 'InternalAppContext';
+export default AppContext;

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

@@ -0,0 +1,85 @@
+import React, { type PropsWithChildren, type Ref } from 'react';
+import type { Except } from 'type-fest';
+import type { DOMElement } from '../dom.js';
+import type { ClickEvent } from '../events/click-event.js';
+import type { ContextMenuEvent } from '../events/context-menu-event.js';
+import type { DragEvent } from '../events/drag-event.js';
+import type { FocusEvent } from '../events/focus-event.js';
+import type { KeyboardEvent } from '../events/keyboard-event.js';
+import type { PointerEvent } from '../events/pointer-event.js';
+import type { WheelEvent } from '../events/wheel-event.js';
+import type { Styles } from '../styles.js';
+export type Props = Except<Styles, 'textWrap'> & {
+    ref?: Ref<DOMElement>;
+    /**
+     * Tab order index. Nodes with `tabIndex >= 0` participate in
+     * Tab/Shift+Tab cycling; `-1` means programmatically focusable only.
+     */
+    tabIndex?: number;
+    /**
+     * Focus this element when it mounts. Like the HTML `autofocus`
+     * attribute — the FocusManager calls `focus(node)` during the
+     * reconciler's `commitMount` phase.
+     */
+    autoFocus?: boolean;
+    /**
+     * Fired on left-button click (press + release without drag). Only works
+     * inside `<AlternateScreen>` where mouse tracking is enabled — no-op
+     * otherwise. The event bubbles from the deepest hit Box up through
+     * ancestors; call `event.stopImmediatePropagation()` to stop bubbling.
+     */
+    onClick?: (event: ClickEvent) => void;
+    /**
+     * Fired on right-button press (SGR button 2). Only works inside
+     * `<AlternateScreen>` where mouse tracking is enabled — no-op
+     * otherwise. The event bubbles from the deepest hit Box up through
+     * ancestors; call `event.stopImmediatePropagation()` to stop bubbling.
+     * Carries absolute `col`/`row` so a handler can anchor a popup menu at
+     * the pointer.
+     */
+    onContextMenu?: (event: ContextMenuEvent) => void;
+    /**
+     * Drag protocol (DOM HTML5 drag semantics subset). Fired when the
+     * pointer FIRST MOVES after an unmodified left-button press inside
+     * this Box (DOM fires dragstart on first move, not on press) — only
+     * inside `<AlternateScreen>` with mouse tracking enabled, and only
+     * when no modifier (shift/alt/ctrl) was held at press. `onDragMove`
+     * fires on every further motion (bubbles from this Box up through
+     * ancestors), `onDragEnd` on release or when the session is
+     * interrupted (focus loss / screen swap). A press+release without
+     * movement fires NO drag events and still triggers `onClick`.
+     */
+    onDragStart?: (event: DragEvent) => void;
+    /** Fired on each pointer motion after dragstart. See onDragStart. */
+    onDragMove?: (event: DragEvent) => void;
+    /** Fired on release after dragstart. See onDragStart. */
+    onDragEnd?: (event: DragEvent) => void;
+    onFocus?: (event: FocusEvent) => void;
+    onFocusCapture?: (event: FocusEvent) => void;
+    onBlur?: (event: FocusEvent) => void;
+    onBlurCapture?: (event: FocusEvent) => void;
+    onKeyDown?: (event: KeyboardEvent) => void;
+    onKeyDownCapture?: (event: KeyboardEvent) => void;
+    /**
+     * Fired when the mouse moves into this Box's rendered rect. Like DOM
+     * `mouseenter`, does NOT bubble — moving between children does not
+     * re-fire on the parent. Only works inside `<AlternateScreen>` where
+     * mode-1003 mouse tracking is enabled.
+     */
+    onMouseEnter?: (event: PointerEvent) => void;
+    /** Fired when the mouse moves out of this Box's rendered rect. */
+    onMouseLeave?: (event: PointerEvent) => void;
+    /**
+     * Fired when a wheel event occurs over this Box's rendered rect (the
+     * position-routed path: dispatchWheel hit-tests the deepest node whose
+     * ancestor chain carries an onWheel handler — ScrollBox receives its
+     * scrolls this way). `deltaY`/`deltaX` are terminal rows/columns per
+     * wheel notch, positive = scroll down/right.
+     */
+    onWheel?: (event: WheelEvent) => void;
+};
+/** Flex layout container with renderer event forwarding. */
+declare function Box({ children, ref, tabIndex, autoFocus, onClick, onContextMenu, onDragStart, onDragMove, onDragEnd, onWheel, onFocus, onFocusCapture, onBlur, onBlurCapture, onKeyDown, onKeyDownCapture, onMouseEnter, onMouseLeave, flexDirection, flexWrap, flexGrow, flexShrink, ...layout }: PropsWithChildren<Props>): React.JSX.Element;
+declare const _default: React.MemoExoticComponent<typeof Box>;
+export default _default;
+//# sourceMappingURL=Box.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Box.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/Box.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,KAAK,GAAG,EAAE,MAAM,OAAO,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG;IAC/C,GAAG,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACzC,qEAAqE;IACrE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACxC,yDAAyD;IACzD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC7C,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACrC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC5C,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3C,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAClD;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC7C,kEAAkE;IAClE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC7C;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,4DAA4D;AAC5D,iBAAS,GAAG,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EACvE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EACpE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAC9E,aAAqB,EAAE,QAAmB,EAAE,QAAY,EAAE,UAAc,EACxE,GAAG,MAAM,EACV,EAAE,iBAAiB,CAAC,KAAK,CAAC,qBAW1B;;AAQD,wBAA8B"}

package/lib/types/ink/components/Box.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import * as warn from '../warn.js';
+/** Flex layout container with renderer event forwarding. */
+function Box({ children, ref, tabIndex, autoFocus, onClick, onContextMenu, onDragStart, onDragMove, onDragEnd, onWheel, onFocus, onFocusCapture, onBlur, onBlurCapture, onKeyDown, onKeyDownCapture, onMouseEnter, onMouseLeave, flexDirection = 'row', flexWrap = 'nowrap', flexGrow = 0, flexShrink = 1, ...layout }) {
+    for (const key of SPACING_KEYS)
+        warn.ifNotInteger(layout[key], key);
+    const style = {
+        ...layout, flexDirection, flexWrap, flexGrow, flexShrink,
+        overflowX: layout.overflowX ?? layout.overflow ?? 'visible',
+        overflowY: layout.overflowY ?? layout.overflow ?? 'visible',
+    };
+    return _jsx("ink-box", { ref, tabIndex, autoFocus, style, onClick, onContextMenu,
+        onDragStart, onDragMove, onDragEnd, onWheel, onFocus, onFocusCapture,
+        onBlur, onBlurCapture, onKeyDown, onKeyDownCapture, onMouseEnter, onMouseLeave, children: children });
+}
+const SPACING_KEYS = [
+    'margin', 'marginX', 'marginY', 'marginTop', 'marginBottom', 'marginLeft', 'marginRight',
+    'padding', 'paddingX', 'paddingY', 'paddingTop', 'paddingBottom', 'paddingLeft', 'paddingRight',
+    'gap', 'columnGap', 'rowGap',
+];
+export default React.memo(Box);

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

@@ -0,0 +1,37 @@
+import React, { type Ref } from 'react';
+import type { Except } from 'type-fest';
+import type { DOMElement } from '../dom.js';
+import type { Styles } from '../styles.js';
+type ButtonState = {
+    focused: boolean;
+    hovered: boolean;
+    active: boolean;
+};
+export type Props = Except<Styles, 'textWrap'> & {
+    ref?: Ref<DOMElement>;
+    /**
+     * Called when the button is activated via Enter, Space, or click.
+     */
+    onAction: () => void;
+    /**
+     * Tab order index. Defaults to 0 (in tab order).
+     * Set to -1 for programmatically focusable only.
+     */
+    tabIndex?: number;
+    /**
+     * Focus this button when it mounts.
+     */
+    autoFocus?: boolean;
+    /**
+     * Render prop receiving the interactive state. Use this to
+     * style children based on focus/hover/active — Button itself
+     * is intentionally unstyled.
+     *
+     * If not provided, children render as-is (no state-dependent styling).
+     */
+    children: ((state: ButtonState) => React.ReactNode) | React.ReactNode;
+};
+declare function Button({ onAction, children, tabIndex, ref, autoFocus, ...style }: Props): React.JSX.Element;
+export default Button;
+export type { ButtonState };
+//# sourceMappingURL=Button.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,GAAG,EAA4C,MAAM,OAAO,CAAC;AAClF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAI5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,KAAK,WAAW,GAAG;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AACF,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG;IAC/C,GAAG,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACtB;;OAEG;IACH,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;CACvE,CAAC;AACF,iBAAS,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAY,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,qBAoBpF;AACD,eAAe,MAAM,CAAA;AACrB,YAAY,EAAE,WAAW,EAAE,CAAA"}

package/lib/types/ink/components/Button.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from 'react';
+import Box from './Box.js';
+function Button({ onAction, children, tabIndex = 0, ref, autoFocus, ...style }) {
+    const [state, setState] = useState({ focused: false, hovered: false, active: false });
+    const timer = useRef(undefined);
+    useEffect(() => () => clearTimeout(timer.current), []);
+    const handleKey = useCallback((event) => {
+        if (event.key !== 'return' && event.key !== ' ')
+            return;
+        event.preventDefault();
+        clearTimeout(timer.current);
+        setState(current => ({ ...current, active: true }));
+        timer.current = setTimeout(() => setState(current => ({ ...current, active: false })), 100);
+        onAction();
+    }, [onAction]);
+    const onFocus = useCallback(() => setState(current => ({ ...current, focused: true })), []);
+    const onBlur = useCallback(() => setState(current => ({ ...current, focused: false })), []);
+    const onMouseEnter = useCallback(() => setState(current => ({ ...current, hovered: true })), []);
+    const onMouseLeave = useCallback(() => setState(current => ({ ...current, hovered: false })), []);
+    return _jsx(Box, { ...style, ref: ref, autoFocus: autoFocus, tabIndex: tabIndex, onClick: onAction, onKeyDown: handleKey, onFocus, onBlur, onMouseEnter, onMouseLeave, children: typeof children === 'function' ? children(state) : children });
+}
+export default Button;

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

@@ -0,0 +1,17 @@
+import React from 'react';
+export type Clock = {
+    subscribe: (onChange: () => void, keepAlive: boolean) => () => void;
+    now: () => number;
+    setTickInterval: (ms: number) => void;
+    /**
+     * Pause the clock for `ms` (circuit-breaker quench, see
+     * update-overflow-guard). Animations freeze for the window; no data is
+     * lost — consumers re-read fresh values on the next tick after resume.
+     */
+    suspend: (ms: number) => void;
+};
+export declare function createClock(tickIntervalMs: number): Clock;
+export declare const ClockContext: React.Context<Clock | null>;
+/** Stable clock ownership; focus only changes its scheduling interval. */
+export declare function ClockProvider({ children }: React.PropsWithChildren): React.JSX.Element;
+//# sourceMappingURL=ClockContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ClockContext.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/ClockContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAKlE,MAAM,MAAM,KAAK,GAAG;IAClB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;IACpE,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC;;;;OAIG;IACH,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B,CAAC;AACF,wBAAgB,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,KAAK,CA+EzD;AACD,eAAO,MAAM,YAAY,6BAAoC,CAAC;AAG9D,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,iBAAiB,qBAOlE"}

package/lib/types/ink/components/ClockContext.js

@@ -0,0 +1,99 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useEffect, useState } from 'react';
+import { FRAME_INTERVAL_MS } from '../constants.js';
+import { noteFrameCause } from '../geometry-trace.js';
+import { useTerminalFocus } from '../hooks/use-terminal-focus.js';
+import { callWithUpdateOverflowGuard, registerOverflowQuench } from '../update-overflow-guard.js';
+export function createClock(tickIntervalMs) {
+    const subscribers = new Map();
+    let interval = null;
+    let currentTickIntervalMs = tickIntervalMs;
+    let startTime = 0;
+    // Snapshot of the current tick's time, ensuring all subscribers in the same
+    // tick see the same value (keeps animations synchronized)
+    let tickTime = 0;
+    function tick() {
+        tickTime = Date.now() - startTime;
+        noteFrameCause('animation');
+        for (const onChange of subscribers.keys()) {
+            // #185 self-heal: a thrown overflow resets React's nested-update
+            // counter, so absorbing it here drops at most one animation frame.
+            callWithUpdateOverflowGuard('clock.tick', onChange);
+        }
+    }
+    function updateInterval() {
+        const anyKeepAlive = [...subscribers.values()].some(Boolean);
+        if (anyKeepAlive) {
+            if (interval) {
+                clearInterval(interval);
+                interval = null;
+            }
+            if (startTime === 0) {
+                startTime = Date.now();
+            }
+            interval = setInterval(tick, currentTickIntervalMs);
+        }
+        else if (interval) {
+            clearInterval(interval);
+            interval = null;
+        }
+    }
+    function suspendFor(ms) {
+        if (interval) {
+            clearInterval(interval);
+            interval = null;
+        }
+        // Resume after the backoff window. unref: a paused clock must never
+        // hold the process open by itself.
+        const resume = setTimeout(() => {
+            updateInterval();
+        }, ms);
+        resume.unref?.();
+    }
+    const clock = {
+        subscribe(onChange, keepAlive) {
+            subscribers.set(onChange, keepAlive);
+            updateInterval();
+            return () => {
+                subscribers.delete(onChange);
+                updateInterval();
+            };
+        },
+        now() {
+            if (startTime === 0) {
+                startTime = Date.now();
+            }
+            // When the clock interval is running, return the synchronized tickTime
+            // so all subscribers in the same tick see the same value.
+            // When paused (no keepAlive subscribers), return real-time to avoid
+            // returning a stale tickTime from the last tick before the pause.
+            if (interval && tickTime) {
+                return tickTime;
+            }
+            return Date.now() - startTime;
+        },
+        setTickInterval(ms) {
+            if (ms === currentTickIntervalMs)
+                return;
+            currentTickIntervalMs = ms;
+            updateInterval();
+        },
+        suspend: suspendFor
+    };
+    // Circuit-breaker quench: a sustained #185 oscillation at this tick
+    // pauses the shared clock instead of being absorbed forever (which would
+    // leave the process alive but burning CPU on the oscillation's commits).
+    registerOverflowQuench('clock.tick', ms => clock.suspend(ms));
+    return clock;
+}
+export const ClockContext = createContext(null);
+const BLURRED_TICK_INTERVAL_MS = FRAME_INTERVAL_MS * 2;
+/** Stable clock ownership; focus only changes its scheduling interval. */
+export function ClockProvider({ children }) {
+    const [clock] = useState(() => createClock(FRAME_INTERVAL_MS));
+    const focused = useTerminalFocus();
+    useEffect(() => {
+        clock.setTickInterval(focused ? FRAME_INTERVAL_MS : BLURRED_TICK_INTERVAL_MS);
+    }, [clock, focused]);
+    return _jsx(ClockContext.Provider, { value: clock, children: children });
+}

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

@@ -0,0 +1,30 @@
+import type { DOMElement } from '../dom.js';
+/**
+ * A declared cursor parking position: a node plus the line and column within
+ * it where the terminal cursor should sit.
+ */
+export type CursorDeclaration = {
+    /** Display column (terminal cell width) within the declared node */
+    readonly relativeX: number;
+    /** Line number within the declared node */
+    readonly relativeY: number;
+    /** The ink-box DOMElement whose yoga layout provides the absolute origin */
+    readonly node: DOMElement;
+};
+/**
+ * Setter for the declared cursor position.
+ *
+ * The optional second argument makes `null` a conditional clear: the
+ * declaration is only cleared if the currently-declared node matches
+ * `clearIfNode`. This makes the hook safe for sibling components
+ * (e.g. list items) that transfer focus among themselves — without the
+ * node check, a newly-unfocused item's clear could clobber a
+ * newly-focused sibling's set depending on layout-effect order.
+ */
+export type CursorDeclarationSetter = (declaration: CursorDeclaration | null, clearIfNode?: DOMElement | null) => void;
+/**
+ * React context that provides the cursor-declaration setter to descendants.
+ */
+declare const CursorDeclarationContext: import("react").Context<CursorDeclarationSetter>;
+export default CursorDeclarationContext;
+//# sourceMappingURL=CursorDeclarationContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CursorDeclarationContext.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/CursorDeclarationContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAC1B,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,uBAAuB,GAAG,CACpC,WAAW,EAAE,iBAAiB,GAAG,IAAI,EACrC,WAAW,CAAC,EAAE,UAAU,GAAG,IAAI,KAC5B,IAAI,CAAA;AAET;;GAEG;AACH,QAAA,MAAM,wBAAwB,kDAE7B,CAAA;AAED,eAAe,wBAAwB,CAAA"}

package/lib/types/ink/components/CursorDeclarationContext.js

@@ -0,0 +1,6 @@
+import { createContext } from 'react';
+/**
+ * React context that provides the cursor-declaration setter to descendants.
+ */
+const CursorDeclarationContext = createContext(() => { });
+export default CursorDeclarationContext;

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

@@ -0,0 +1,7 @@
+import React from 'react';
+type Props = {
+    readonly error: Error;
+};
+export default function ErrorOverview({ error }: Props): React.JSX.Element;
+export {};
+//# sourceMappingURL=ErrorOverview.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorOverview.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/ErrorOverview.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAsB1B,KAAK,KAAK,GAAG;IACX,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB,CAAC;AACF,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EACpC,KAAK,EACN,EAAE,KAAK,qBA8EP"}

package/lib/types/ink/components/ErrorOverview.js

@@ -0,0 +1,49 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import codeExcerpt from 'code-excerpt';
+import { readFileSync } from 'fs';
+import StackUtils from 'stack-utils';
+import Box from './Box.js';
+import Text from './Text.js';
+/* eslint-disable custom-rules/no-process-cwd -- stack trace file:// paths are relative to the real OS cwd, not the virtual cwd */
+// Error's source file is reported as file:///home/user/file.js
+// This function removes the file://[cwd] part
+const cleanupPath = (path) => {
+    return path?.replace(`file://${process.cwd()}/`, '');
+};
+let stackUtils;
+function getStackUtils() {
+    return stackUtils ??= new StackUtils({
+        cwd: process.cwd(),
+        internals: StackUtils.nodeInternals()
+    });
+}
+export default function ErrorOverview({ error }) {
+    const stack = error.stack ? error.stack.split('\n').slice(1) : undefined;
+    const origin = stack ? getStackUtils().parseLine(stack[0]) : undefined;
+    const filePath = cleanupPath(origin?.file);
+    let excerpt;
+    let lineWidth = 0;
+    if (filePath && origin?.line) {
+        try {
+            // eslint-disable-next-line custom-rules/no-sync-fs -- sync render path; error overlay can't go async without suspense restructuring
+            const sourceCode = readFileSync(filePath, 'utf8');
+            excerpt = codeExcerpt(sourceCode, origin.line);
+            if (excerpt) {
+                for (const { line } of excerpt) {
+                    lineWidth = Math.max(lineWidth, String(line).length);
+                }
+            }
+        }
+        catch {
+            // file not readable — skip source context
+        }
+    }
+    return _jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsxs(Box, { children: [_jsxs(Text, { backgroundColor: "ansi:red", color: "ansi:white", children: [' ', "ERROR", ' '] }), _jsxs(Text, { children: [" ", error.message] })] }), origin && filePath && _jsx(Box, { marginTop: 1, children: _jsxs(Text, { dim: true, children: [filePath, ":", origin.line, ":", origin.column] }) }), origin && excerpt && _jsx(Box, { marginTop: 1, flexDirection: "column", children: excerpt.map(({ line: line_0, value }) => _jsxs(Box, { children: [_jsx(Box, { width: lineWidth + 1, children: _jsxs(Text, { dim: line_0 !== origin.line, backgroundColor: line_0 === origin.line ? 'ansi:red' : undefined, color: line_0 === origin.line ? 'ansi:white' : undefined, children: [String(line_0).padStart(lineWidth, ' '), ":"] }) }), _jsx(Text, { backgroundColor: line_0 === origin.line ? 'ansi:red' : undefined, color: line_0 === origin.line ? 'ansi:white' : undefined, children: ' ' + value }, line_0)] }, line_0)) }), error.stack && _jsx(Box, { marginTop: 1, flexDirection: "column", children: error.stack.split('\n').slice(1).map(line_1 => {
+                    const parsedLine = getStackUtils().parseLine(line_1);
+                    // If the line from the stack cannot be parsed, we print out the unparsed line.
+                    if (!parsedLine) {
+                        return _jsxs(Box, { children: [_jsx(Text, { dim: true, children: "- " }), _jsx(Text, { bold: true, children: line_1 })] }, line_1);
+                    }
+                    return _jsxs(Box, { children: [_jsx(Text, { dim: true, children: "- " }), _jsx(Text, { bold: true, children: parsedLine.function }), _jsxs(Text, { dim: true, children: [' ', "(", cleanupPath(parsedLine.file) ?? '', ":", parsedLine.line, ":", parsedLine.column, ")"] })] }, line_1);
+                }) })] });
+}

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

@@ -0,0 +1,28 @@
+import React, { type ReactNode } from 'react';
+import type { TerminalImageSource } from '../terminal-image.js';
+export interface ImageProps {
+    /**
+     * Decoded immutable RGBA snapshot. Allocate a new buffer when pixels change;
+     * invalid or oversized sources use the fallback.
+     */
+    readonly source?: TerminalImageSource;
+    /** Width reserved in terminal columns. */
+    readonly width: number;
+    /** Height reserved in terminal rows. */
+    readonly height: number;
+    /** Text alternative. Use an empty string for a decorative image. */
+    readonly alt: string;
+    /** Opt into Sixel for a modal or scrollable transcript. Default keeps Kitty only. */
+    readonly presentation?: 'preview' | 'transcript';
+    /** Same-size terminal-cell fallback rendered when graphics are unavailable. */
+    readonly children?: ReactNode;
+}
+/**
+ * A renderer-owned terminal image with a deterministic cell fallback.
+ *
+ * The component never emits protocol bytes itself. It contributes a normal
+ * Yoga leaf; the Ink host decides after layout whether to paint its fallback
+ * children or attach a terminal-graphics placement over the same cells.
+ */
+export default function Image({ source, width, height, alt, presentation, children, }: ImageProps): React.ReactNode;
+//# sourceMappingURL=Image.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Image.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/Image.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAO/D,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAA;IACrC,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,qFAAqF;IACrF,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,GAAG,YAAY,CAAA;IAChD,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,EAC5B,MAAM,EACN,KAAK,EACL,MAAM,EACN,GAAG,EACH,YAAY,EACZ,QAAQ,GACT,EAAE,UAAU,GAAG,KAAK,CAAC,SAAS,CA4B9B"}

package/lib/types/ink/components/Image.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { isTerminalImageSource, TERMINAL_IMAGE_MAX_CELLS, } from '../terminal-image.js';
+import Text from './Text.js';
+/**
+ * A renderer-owned terminal image with a deterministic cell fallback.
+ *
+ * The component never emits protocol bytes itself. It contributes a normal
+ * Yoga leaf; the Ink host decides after layout whether to paint its fallback
+ * children or attach a terminal-graphics placement over the same cells.
+ */
+export default function Image({ source, width, height, alt, presentation, children, }) {
+    const [columns, rows] = normalizeSize(width, height);
+    const image = isTerminalImageSource(source, presentation) ? source : undefined;
+    const alternative = cleanAlternative(alt);
+    return (_jsx("ink-image", { imageData: image?.data, imageWidth: image?.width, imageHeight: image?.height, imageAlt: alternative, imagePresentation: presentation, style: {
+            width: columns,
+            height: rows,
+            flexGrow: 0,
+            flexShrink: 0,
+            overflow: 'hidden',
+        }, children: children ??
+            (alternative === '' ? null : (_jsx(Text, { dim: true, wrap: "truncate", children: alternative }))) }));
+}
+function normalizeSize(width, height) {
+    let columns = normalizeEdge(width);
+    let rows = normalizeEdge(height);
+    const cells = columns * rows;
+    if (cells > TERMINAL_IMAGE_MAX_CELLS) {
+        const scale = Math.sqrt(TERMINAL_IMAGE_MAX_CELLS / cells);
+        columns = Math.max(1, Math.floor(columns * scale));
+        rows = Math.max(1, Math.floor(rows * scale));
+    }
+    return [columns, rows];
+}
+function normalizeEdge(value) {
+    if (!Number.isFinite(value))
+        return 1;
+    return Math.max(1, Math.min(TERMINAL_IMAGE_MAX_CELLS, Math.floor(value)));
+}
+function cleanAlternative(value) {
+    if (typeof value !== 'string')
+        return '';
+    return value.replace(/[\u0000-\u001f\u007f-\u009f]/gu, ' ').slice(0, 200);
+}

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

@@ -0,0 +1,8 @@
+import React, { type ReactNode } from 'react';
+export type Props = {
+    readonly children?: ReactNode;
+    readonly url: string;
+    readonly fallback?: ReactNode;
+};
+export default function Link({ children, url, fallback }: Props): React.JSX.Element;
+//# sourceMappingURL=Link.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/Link.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAI7C,MAAM,MAAM,KAAK,GAAG;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAA;AAE1G,MAAM,CAAC,OAAO,UAAU,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,KAAK,qBAG9D"}

package/lib/types/ink/components/Link.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { supportsHyperlinks } from '../supports-hyperlinks.js';
+import Text from './Text.js';
+export default function Link({ children, url, fallback }) {
+    const label = children ?? url;
+    return _jsx(Text, { children: supportsHyperlinks() ? _jsx("ink-link", { href: url, children: label }) : (fallback ?? label) });
+}

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

@@ -0,0 +1,7 @@
+import React from 'react';
+export type Props = {
+    readonly count?: number;
+};
+/** Insert line separators inside a text container. */
+export default function Newline({ count }: Props): React.JSX.Element;
+//# sourceMappingURL=Newline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Newline.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/Newline.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,MAAM,KAAK,GAAG;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/C,sDAAsD;AACtD,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,KAAS,EAAE,EAAE,KAAK,qBAEnD"}

package/lib/types/ink/components/Newline.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/** Insert line separators inside a text container. */
+export default function Newline({ count = 1 }) {
+    return _jsx("ink-text", { children: '\n'.repeat(count) });
+}

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

@@ -0,0 +1,9 @@
+import React, { type PropsWithChildren } from 'react';
+import { type Props as BoxProps } from './Box.js';
+type Props = PropsWithChildren<Omit<BoxProps, 'noSelect'> & {
+    fromLeftEdge?: boolean;
+}>;
+/** Exclude rendered cells from fullscreen copy selection, optionally including their left gutter. */
+export declare function NoSelect({ fromLeftEdge, ...props }: Props): React.JSX.Element;
+export {};
+//# sourceMappingURL=NoSelect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NoSelect.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/NoSelect.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAA;AACrD,OAAY,EAAE,KAAK,KAAK,IAAI,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEtD,KAAK,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAA;AAEvF,qGAAqG;AACrG,wBAAgB,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,qBAEzD"}

package/lib/types/ink/components/NoSelect.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import Box from './Box.js';
+/** Exclude rendered cells from fullscreen copy selection, optionally including their left gutter. */
+export function NoSelect({ fromLeftEdge, ...props }) {
+    return _jsx(Box, { ...props, noSelect: fromLeftEdge ? 'from-left-edge' : true });
+}

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

@@ -0,0 +1,9 @@
+import React from 'react';
+type Props = {
+    lines: string[];
+    width: number;
+};
+/** Already wrapped terminal rows, measured without creating a tree per style span. */
+export declare const RawAnsi: React.MemoExoticComponent<({ lines, width }: Props) => React.JSX.Element | null>;
+export {};
+//# sourceMappingURL=RawAnsi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RawAnsi.d.ts","sourceRoot":"","sources":["../../../../src/ink/components/RawAnsi.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,KAAK,KAAK,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/C,sFAAsF;AACtF,eAAO,MAAM,OAAO,+CAAiD,KAAK,8BAGxE,CAAA"}

package/lib/types/ink/components/RawAnsi.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+/** Already wrapped terminal rows, measured without creating a tree per style span. */
+export const RawAnsi = React.memo(function RawAnsi({ lines, width }) {
+    const rawText = React.useMemo(() => lines.join('\n'), [lines]);
+    return lines.length ? _jsx("ink-raw-ansi", { rawText: rawText, rawWidth: width, rawHeight: lines.length }) : null;
+});