@kingkoo1985/ink 6.6.6

package/build/components/Text.d.ts

@@ -0,0 +1,63 @@
+import React, { type ReactNode } from 'react';
+import { type ForegroundColorName } from 'chalk';
+import { type LiteralUnion } from 'type-fest';
+import { type Styles } from '../styles.js';
+export type Props = {
+    /**
+    A label for the element for screen readers.
+    */
+    readonly 'aria-label'?: string;
+    /**
+    Hide the element from screen readers.
+    */
+    readonly 'aria-hidden'?: boolean;
+    /**
+    Change text color. Ink uses Chalk under the hood, so all its functionality is supported.
+    */
+    readonly color?: LiteralUnion<ForegroundColorName, string>;
+    /**
+    Same as `color`, but for the background.
+    */
+    readonly backgroundColor?: LiteralUnion<ForegroundColorName, string>;
+    /**
+    Dim the color (make it less bright).
+    */
+    readonly dimColor?: boolean;
+    /**
+    Make the text bold.
+    */
+    readonly bold?: boolean;
+    /**
+    Make the text italic.
+    */
+    readonly italic?: boolean;
+    /**
+    Make the text underlined.
+    */
+    readonly underline?: boolean;
+    /**
+    Make the text crossed out with a line.
+    */
+    readonly strikethrough?: boolean;
+    /**
+    Inverse background and foreground colors.
+    */
+    readonly inverse?: boolean;
+    /**
+    This property tells Ink to wrap or truncate text if its width is larger than the container. If `wrap` is passed (the default), Ink will wrap text and split it into multiple lines. If `truncate-*` is passed, Ink will truncate text instead, resulting in one line of text with the rest cut off.
+    */
+    readonly wrap?: Styles['textWrap'];
+    /**
+    When enabled, the terminal cursor will be positioned at the end of this Text component's content. Useful for input fields where IME (Input Method Editor) cursor synchronization is needed.
+    */
+    readonly terminalCursorFocus?: boolean;
+    /**
+    Specifies the cursor position within the text content (character index). Only works when `terminalCursorFocus` is true. If not specified, the cursor will be positioned at the end of the text (default behavior).
+    */
+    readonly terminalCursorPosition?: number;
+    readonly children?: ReactNode;
+};
+/**
+This component can display text and change its style to make it bold, underlined, italic, or strikethrough.
+*/
+export default function Text({ color, backgroundColor, dimColor, bold, italic, underline, strikethrough, inverse, wrap, terminalCursorFocus, terminalCursorPosition, children, 'aria-label': ariaLabel, 'aria-hidden': ariaHidden, }: Props): React.JSX.Element | null;

package/build/components/Text.js

@@ -0,0 +1,50 @@
+import React, { useContext } from 'react';
+import chalk from 'chalk';
+import colorize from '../colorize.js';
+import { accessibilityContext } from './AccessibilityContext.js';
+import { backgroundContext } from './BackgroundContext.js';
+/**
+This component can display text and change its style to make it bold, underlined, italic, or strikethrough.
+*/
+export default function Text({ color, backgroundColor, dimColor = false, bold = false, italic = false, underline = false, strikethrough = false, inverse = false, wrap = 'wrap', terminalCursorFocus = false, terminalCursorPosition, children, 'aria-label': ariaLabel, 'aria-hidden': ariaHidden = false, }) {
+    const { isScreenReaderEnabled } = useContext(accessibilityContext);
+    const inheritedBackgroundColor = useContext(backgroundContext);
+    const childrenOrAriaLabel = isScreenReaderEnabled && ariaLabel ? ariaLabel : children;
+    if (childrenOrAriaLabel === undefined || childrenOrAriaLabel === null) {
+        return null;
+    }
+    const transform = (children) => {
+        if (dimColor) {
+            children = chalk.dim(children);
+        }
+        if (bold) {
+            children = chalk.bold(children);
+        }
+        if (italic) {
+            children = chalk.italic(children);
+        }
+        if (underline) {
+            children = chalk.underline(children);
+        }
+        if (strikethrough) {
+            children = chalk.strikethrough(children);
+        }
+        if (inverse) {
+            children = chalk.inverse(children);
+        }
+        if (color) {
+            children = colorize(children, color, 'foreground');
+        }
+        // Use explicit backgroundColor if provided, otherwise use inherited from parent Box
+        const effectiveBackgroundColor = backgroundColor ?? inheritedBackgroundColor;
+        if (effectiveBackgroundColor) {
+            children = colorize(children, effectiveBackgroundColor, 'background');
+        }
+        return children;
+    };
+    if (isScreenReaderEnabled && ariaHidden) {
+        return null;
+    }
+    return (React.createElement("ink-text", { style: { flexGrow: 0, flexShrink: 1, flexDirection: 'row', textWrap: wrap }, internal_transform: transform, internal_terminalCursorFocus: terminalCursorFocus, internal_terminalCursorPosition: terminalCursorPosition }, isScreenReaderEnabled && ariaLabel ? ariaLabel : children));
+}
+//# sourceMappingURL=Text.js.map

package/build/components/Text.js.map

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

package/build/components/Transform.d.ts

@@ -0,0 +1,16 @@
+import React, { type ReactNode } from 'react';
+export type Props = {
+    /**
+    Screen-reader-specific text to output. If this is set, all children will be ignored.
+    */
+    readonly accessibilityLabel?: string;
+    /**
+    Function that transforms children output. It accepts children and must return transformed children as well.
+    */
+    readonly transform: (children: string, index: number) => string;
+    readonly children?: ReactNode;
+};
+/**
+Transform a string representation of React components before they're written to output. For example, you might want to apply a gradient to text, add a clickable link, or create some text effects. These use cases can't accept React nodes as input; they expect a string. That's what the <Transform> component does: it gives you an output string of its child components and lets you transform it in any way.
+*/
+export default function Transform({ children, transform, accessibilityLabel, }: Props): React.JSX.Element | null;

package/build/components/Transform.js

@@ -0,0 +1,15 @@
+import React, { useContext } from 'react';
+import { accessibilityContext } from './AccessibilityContext.js';
+/**
+Transform a string representation of React components before they're written to output. For example, you might want to apply a gradient to text, add a clickable link, or create some text effects. These use cases can't accept React nodes as input; they expect a string. That's what the <Transform> component does: it gives you an output string of its child components and lets you transform it in any way.
+*/
+export default function Transform({ children, transform, accessibilityLabel, }) {
+    const { isScreenReaderEnabled } = useContext(accessibilityContext);
+    if (children === undefined || children === null) {
+        return null;
+    }
+    return (React.createElement("ink-text", { style: { flexGrow: 0, flexShrink: 1, flexDirection: 'row' }, internal_transform: transform }, isScreenReaderEnabled && accessibilityLabel
+        ? accessibilityLabel
+        : children));
+}
+//# sourceMappingURL=Transform.js.map

package/build/components/Transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transform.js","sourceRoot":"","sources":["../../src/components/Transform.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAC,UAAU,EAAiB,MAAM,OAAO,CAAC;AACxD,OAAO,EAAC,oBAAoB,EAAC,MAAM,2BAA2B,CAAC;AAgB/D;;EAEE;AACF,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EACjC,QAAQ,EACR,SAAS,EACT,kBAAkB,GACX;IACP,MAAM,EAAC,qBAAqB,EAAC,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAEjE,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,CACN,kCACC,KAAK,EAAE,EAAC,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,aAAa,EAAE,KAAK,EAAC,EACzD,kBAAkB,EAAE,SAAS,IAE5B,qBAAqB,IAAI,kBAAkB;QAC3C,CAAC,CAAC,kBAAkB;QACpB,CAAC,CAAC,QAAQ,CACD,CACX,CAAC;AACH,CAAC"}

package/build/data-limited-lru-map.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A specialized LRU map that enforces limits on both the number of entries and
+ * the total character length of the keys.
+ *
+ * When adding a new item, if the new key's length would exceed `maxDataSize`,
+ * it evicts the least recently used items until space is available.
+ *
+ * @template V - The type of the values stored in the map.
+ */
+export declare class DataLimitedLruMap<V> {
+    private readonly map;
+    private readonly maxDataSize;
+    private currentDataSize;
+    constructor(maxKeys: number, maxDataSize: number);
+    get(key: string): V | undefined;
+    set(key: string, value: V): void;
+    get size(): number;
+    get currentDataSizeValue(): number;
+    clear(): void;
+}

package/build/data-limited-lru-map.js

@@ -0,0 +1,65 @@
+import { LRUMapWithDelete } from 'mnemonist';
+/**
+ * A specialized LRU map that enforces limits on both the number of entries and
+ * the total character length of the keys.
+ *
+ * When adding a new item, if the new key's length would exceed `maxDataSize`,
+ * it evicts the least recently used items until space is available.
+ *
+ * @template V - The type of the values stored in the map.
+ */
+export class DataLimitedLruMap {
+    map;
+    maxDataSize;
+    currentDataSize = 0;
+    constructor(maxKeys, maxDataSize) {
+        this.map = new LRUMapWithDelete(maxKeys);
+        this.maxDataSize = maxDataSize;
+    }
+    get(key) {
+        return this.map.get(key);
+    }
+    set(key, value) {
+        const size = key.length;
+        const hasKey = this.map.has(key);
+        while (this.currentDataSize + size > this.maxDataSize &&
+            this.map.size > 0) {
+            const map = this.map;
+            const lruKey = map.K[map.tail];
+            if (lruKey === undefined) {
+                break;
+            }
+            // If the key is not found in the map, we can't evict it.
+            // This can happen if the map is in an inconsistent state.
+            // To avoid an infinite loop, we break here.
+            // The LRUMap still has its own size limit so it is acceptable
+            // for us to make a best effort to stay within the data size limit.
+            // The alternative would be to continue searching for a valid key
+            // to delete but that would risk making calling set O(n) instead of
+            // O(1).
+            if (!this.map.delete(lruKey)) {
+                break;
+            }
+            this.currentDataSize -= lruKey.length;
+        }
+        const result = this.map.setpop(key, value);
+        if (result?.evicted) {
+            this.currentDataSize -= result.key.length;
+        }
+        if (hasKey) {
+            this.currentDataSize -= size;
+        }
+        this.currentDataSize += size;
+    }
+    get size() {
+        return this.map.size;
+    }
+    get currentDataSizeValue() {
+        return this.currentDataSize;
+    }
+    clear() {
+        this.map.clear();
+        this.currentDataSize = 0;
+    }
+}
+//# sourceMappingURL=data-limited-lru-map.js.map

package/build/data-limited-lru-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-limited-lru-map.js","sourceRoot":"","sources":["../src/data-limited-lru-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,WAAW,CAAC;AAO3C;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAiB;IACZ,GAAG,CAA8B;IACjC,WAAW,CAAS;IAC7B,eAAe,GAAG,CAAC,CAAC;IAE5B,YAAY,OAAe,EAAE,WAAmB;QAC/C,IAAI,CAAC,GAAG,GAAG,IAAI,gBAAgB,CAAY,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,GAAW;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAQ;QACxB,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEjC,OACC,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC,WAAW;YAC9C,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,EAChB,CAAC;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAwC,CAAC;YAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAE/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM;YACP,CAAC;YAED,yDAAyD;YACzD,0DAA0D;YAC1D,4CAA4C;YAC5C,8DAA8D;YAC9D,mEAAmE;YACnE,iEAAiE;YACjE,mEAAmE;YACnE,QAAQ;YACR,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,MAAM;YACP,CAAC;YAED,IAAI,CAAC,eAAe,IAAI,MAAM,CAAC,MAAM,CAAC;QACvC,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAE7B,CAAC;QAEb,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACrB,IAAI,CAAC,eAAe,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;QAC3C,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;QAC9B,CAAC;QAED,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;IAC9B,CAAC;IAED,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACtB,CAAC;IAED,IAAI,oBAAoB;QACvB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC7B,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACjB,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;IAC1B,CAAC;CACD"}

package/build/debug-log.d.ts

@@ -0,0 +1,2 @@
+export declare const debugLog: (message: string) => void;
+export declare const clearDebugLog: () => void;

package/build/debug-log.js

@@ -0,0 +1,44 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+const debugLogEnabled = false;
+let isFirstRun = true;
+const logFilePath = path.join(process.cwd(), 'debug.log');
+let logStream;
+export const debugLog = (message) => {
+    if (!debugLogEnabled) {
+        return;
+    }
+    if (isFirstRun) {
+        try {
+            logStream = fs.createWriteStream(logFilePath, { flags: 'w' });
+        }
+        catch (error) {
+            process.stderr.write(`[debug-log] Failed to start writing to debug file ${logFilePath} in debugLog: ${String(error)}\n`);
+        }
+        isFirstRun = false;
+    }
+    if (logStream) {
+        try {
+            logStream.write(message + '\n');
+        }
+        catch (error) {
+            process.stderr.write(`[debug-log] Failed to write to debug file ${logFilePath} in debugLog: ${String(error)}\n`);
+        }
+    }
+};
+export const clearDebugLog = () => {
+    if (!debugLogEnabled) {
+        return;
+    }
+    if (logStream) {
+        logStream.end();
+    }
+    try {
+        logStream = fs.createWriteStream(logFilePath, { flags: 'w' });
+    }
+    catch (error) {
+        process.stderr.write(`[debug-log] Failed to start writing to debug file ${logFilePath} in clearDebugLog: ${String(error)}\n`);
+    }
+};
+//# sourceMappingURL=debug-log.js.map

package/build/debug-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-log.js","sourceRoot":"","sources":["../src/debug-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,MAAM,eAAe,GAAG,KAAK,CAAC;AAC9B,IAAI,UAAU,GAAG,IAAI,CAAC;AACtB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;AAC1D,IAAI,SAAqC,CAAC;AAE1C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,OAAe,EAAE,EAAE;IAC3C,IAAI,CAAC,eAAe,EAAE,CAAC;QACtB,OAAO;IACR,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QAChB,IAAI,CAAC;YACJ,SAAS,GAAG,EAAE,CAAC,iBAAiB,CAAC,WAAW,EAAE,EAAC,KAAK,EAAE,GAAG,EAAC,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,qDAAqD,WAAW,iBAAiB,MAAM,CAAC,KAAK,CAAC,IAAI,CAClG,CAAC;QACH,CAAC;QAED,UAAU,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACf,IAAI,CAAC;YACJ,SAAS,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,6CAA6C,WAAW,iBAAiB,MAAM,CAAC,KAAK,CAAC,IAAI,CAC1F,CAAC;QACH,CAAC;IACF,CAAC;AACF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,EAAE;IACjC,IAAI,CAAC,eAAe,EAAE,CAAC;QACtB,OAAO;IACR,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACf,SAAS,CAAC,GAAG,EAAE,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACJ,SAAS,GAAG,EAAE,CAAC,iBAAiB,CAAC,WAAW,EAAE,EAAC,KAAK,EAAE,GAAG,EAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,qDAAqD,WAAW,sBAAsB,MAAM,CAAC,KAAK,CAAC,IAAI,CACvG,CAAC;IACH,CAAC;AACF,CAAC,CAAC"}

package/build/devtools-window-polyfill.d.ts

@@ -0,0 +1 @@
+export {};

package/build/devtools-window-polyfill.js

@@ -0,0 +1,65 @@
+// Ignoring missing types error to avoid adding another dependency for this hack to work
+import ws from 'ws';
+// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+const customGlobal = global;
+// These things must exist before importing `react-devtools-core`
+// eslint-disable-next-line n/no-unsupported-features/node-builtins
+customGlobal.WebSocket ||= ws;
+customGlobal.window ||= global;
+customGlobal.self ||= global;
+// Filter out Ink's internal components from devtools for a cleaner view.
+// Also, ince `react-devtools-shared` package isn't published on npm, we can't
+// use its types, that's why there are hard-coded values in `type` fields below.
+// See https://github.com/facebook/react/blob/edf6eac8a181860fd8a2d076a43806f1237495a1/packages/react-devtools-shared/src/types.js#L24
+customGlobal.window.__REACT_DEVTOOLS_COMPONENT_FILTERS__ = [
+    {
+        // ComponentFilterElementType
+        type: 1,
+        // ElementTypeHostComponent
+        value: 7,
+        isEnabled: true,
+    },
+    {
+        // ComponentFilterDisplayName
+        type: 2,
+        value: 'InternalApp',
+        isEnabled: true,
+        isValid: true,
+    },
+    {
+        // ComponentFilterDisplayName
+        type: 2,
+        value: 'InternalAppContext',
+        isEnabled: true,
+        isValid: true,
+    },
+    {
+        // ComponentFilterDisplayName
+        type: 2,
+        value: 'InternalStdoutContext',
+        isEnabled: true,
+        isValid: true,
+    },
+    {
+        // ComponentFilterDisplayName
+        type: 2,
+        value: 'InternalStderrContext',
+        isEnabled: true,
+        isValid: true,
+    },
+    {
+        // ComponentFilterDisplayName
+        type: 2,
+        value: 'InternalStdinContext',
+        isEnabled: true,
+        isValid: true,
+    },
+    {
+        // ComponentFilterDisplayName
+        type: 2,
+        value: 'InternalFocusContext',
+        isEnabled: true,
+        isValid: true,
+    },
+];
+//# sourceMappingURL=devtools-window-polyfill.js.map

package/build/devtools-window-polyfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-window-polyfill.js","sourceRoot":"","sources":["../src/devtools-window-polyfill.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,mEAAmE;AACnE,MAAM,YAAY,GAAG,MAAa,CAAC;AAEnC,iEAAiE;AAEjE,mEAAmE;AACnE,YAAY,CAAC,SAAS,KAAK,EAAE,CAAC;AAE9B,YAAY,CAAC,MAAM,KAAK,MAAM,CAAC;AAE/B,YAAY,CAAC,IAAI,KAAK,MAAM,CAAC;AAE7B,yEAAyE;AACzE,8EAA8E;AAC9E,gFAAgF;AAChF,sIAAsI;AACtI,YAAY,CAAC,MAAM,CAAC,oCAAoC,GAAG;IAC1D;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,2BAA2B;QAC3B,KAAK,EAAE,CAAC;QACR,SAAS,EAAE,IAAI;KACf;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,oBAAoB;QAC3B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,uBAAuB;QAC9B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,uBAAuB;QAC9B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,sBAAsB;QAC7B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,sBAAsB;QAC7B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;CACD,CAAC"}

package/build/devtools.d.ts

@@ -0,0 +1 @@
+import './devtools-window-polyfill.js';

package/build/devtools.js

@@ -0,0 +1,8 @@
+// eslint-disable-next-line import/no-unassigned-import
+import './devtools-window-polyfill.js';
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-expect-error
+import devtools from 'react-devtools-core';
+devtools.initialize();
+devtools.connectToDevTools();
+//# sourceMappingURL=devtools.js.map

package/build/devtools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools.js","sourceRoot":"","sources":["../src/devtools.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,+BAA+B,CAAC;AAEvC,6DAA6D;AAC7D,mBAAmB;AACnB,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAE1C,QAAgB,CAAC,UAAU,EAAE,CAAC;AAE9B,QAAgB,CAAC,iBAAiB,EAAE,CAAC"}

package/build/dom.d.ts

@@ -0,0 +1,114 @@
+import { type Node as YogaNode } from 'yoga-layout';
+import { type StyledLine } from './styled-line.js';
+import { type Styles } from './styles.js';
+import { type OutputTransformer } from './render-node-to-output.js';
+import type ResizeObserver from './resize-observer.js';
+import { type Region } from './output.js';
+type InkNode = {
+    parentNode: DOMElement | undefined;
+    yogaNode?: YogaNode;
+    internal_static?: boolean;
+    style: Styles;
+};
+export type TextName = '#text';
+export type ElementNames = 'ink-root' | 'ink-box' | 'ink-text' | 'ink-virtual-text' | 'ink-static-render';
+export type NodeNames = ElementNames | TextName;
+export type StickyHeader = {
+    nodeId: number;
+    lines: readonly StyledLine[];
+    stuckLines?: readonly StyledLine[];
+    styledOutput: readonly StyledLine[];
+    x: number;
+    y: number;
+    naturalRow: number;
+    startRow: number;
+    endRow: number;
+    scrollContainerId: number | string;
+    isStuckOnly: boolean;
+    relativeX?: number;
+    relativeY?: number;
+    height?: number;
+    parentRelativeTop?: number;
+    parentHeight?: number;
+    parentBorderTop?: number;
+    parentBorderBottom?: number;
+    type?: 'top' | 'bottom';
+    node?: DOMElement;
+    maxStuckY?: number;
+    minStuckY?: number;
+};
+export type DOMElement = {
+    nodeName: ElementNames;
+    attributes: Record<string, DOMNodeAttribute>;
+    childNodes: DOMNode[];
+    internal_transform?: OutputTransformer;
+    internal_terminalCursorFocus?: boolean;
+    internal_terminalCursorPosition?: number;
+    internalOnBeforeRender?: (node: DOMElement, options?: {
+        trackSelection?: boolean;
+    }) => void;
+    cachedRender?: Region;
+    internal_accessibility?: {
+        role?: 'button' | 'checkbox' | 'combobox' | 'list' | 'listbox' | 'listitem' | 'menu' | 'menuitem' | 'option' | 'progressbar' | 'radio' | 'radiogroup' | 'tab' | 'tablist' | 'table' | 'textbox' | 'timer' | 'toolbar';
+        state?: {
+            busy?: boolean;
+            checked?: boolean;
+            disabled?: boolean;
+            expanded?: boolean;
+            multiline?: boolean;
+            multiselectable?: boolean;
+            readonly?: boolean;
+            required?: boolean;
+            selected?: boolean;
+        };
+    };
+    isStaticDirty?: boolean;
+    staticNode?: DOMElement;
+    onComputeLayout?: () => void;
+    onRender?: () => void;
+    onImmediateRender?: () => void;
+    internal_scrollState?: ScrollState;
+    internalSticky?: boolean | 'top' | 'bottom';
+    internalStickyAlternate?: boolean;
+    internalOpaque?: boolean;
+    internalScrollbar?: boolean;
+    resizeObservers?: Set<ResizeObserver>;
+    internal_lastMeasuredSize?: {
+        width: number;
+        height: number;
+    };
+    internalMaxScrollTop?: number;
+    internalIsScrollbackDirty?: boolean;
+    internalId: number;
+} & InkNode;
+export type ScrollState = {
+    scrollTop: number;
+    scrollLeft: number;
+    scrollHeight: number;
+    actualScrollHeight: number;
+    scrollWidth: number;
+    clientHeight: number;
+    clientWidth: number;
+};
+export type TextNode = {
+    nodeName: TextName;
+    nodeValue: string;
+} & InkNode;
+export type DOMNode<T = {
+    nodeName: NodeNames;
+}> = T extends {
+    nodeName: infer U;
+} ? U extends '#text' ? TextNode : DOMElement : never;
+export type DOMNodeAttribute = boolean | string | number;
+export declare const createNode: (nodeName: ElementNames) => DOMElement;
+export declare const appendChildNode: (node: DOMElement, childNode: DOMElement) => void;
+export declare const insertBeforeNode: (node: DOMElement, newChildNode: DOMNode, beforeChildNode: DOMNode) => void;
+export declare const removeChildNode: (node: DOMElement, removeNode: DOMNode) => void;
+export declare const setAttribute: (node: DOMElement, key: string, value: DOMNodeAttribute) => void;
+export declare const setStyle: (node: DOMNode, style: Styles) => void;
+export declare const createTextNode: (text: string) => TextNode;
+export declare const setCachedRender: (node: DOMElement, cachedRender: Region) => void;
+export declare const setTextNodeValue: (node: TextNode, text: string) => void;
+export declare const getPathToRoot: (node: DOMNode) => DOMNode[];
+export declare const isNodeSelectable: (node: DOMElement) => boolean;
+export {};