@machina.ai/cell-cli 1.13.0-rc5 → 1.16.0-rc2

package/dist/src/ui/components/shared/VirtualizedList.js

@@ -0,0 +1,312 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useState, useRef, useLayoutEffect, forwardRef, useImperativeHandle, useEffect, useMemo, useCallback, } from 'react';
+import { theme } from '../../semantic-colors.js';
+import { useBatchedScroll } from '../../hooks/useBatchedScroll.js';
+import { measureElement, Box } from 'ink';
+export const SCROLL_TO_ITEM_END = Number.MAX_SAFE_INTEGER;
+function findLastIndex(array, predicate) {
+    for (let i = array.length - 1; i >= 0; i--) {
+        if (predicate(array[i], i, array)) {
+            return i;
+        }
+    }
+    return -1;
+}
+function VirtualizedList(props, ref) {
+    const { data, renderItem, estimatedItemHeight, keyExtractor, initialScrollIndex, initialScrollOffsetInIndex, } = props;
+    const dataRef = useRef(data);
+    useEffect(() => {
+        dataRef.current = data;
+    }, [data]);
+    const [scrollAnchor, setScrollAnchor] = useState(() => {
+        const scrollToEnd = initialScrollIndex === SCROLL_TO_ITEM_END ||
+            (typeof initialScrollIndex === 'number' &&
+                initialScrollIndex >= data.length - 1 &&
+                initialScrollOffsetInIndex === SCROLL_TO_ITEM_END);
+        if (scrollToEnd) {
+            return {
+                index: data.length > 0 ? data.length - 1 : 0,
+                offset: SCROLL_TO_ITEM_END,
+            };
+        }
+        if (typeof initialScrollIndex === 'number') {
+            return {
+                index: Math.max(0, Math.min(data.length - 1, initialScrollIndex)),
+                offset: initialScrollOffsetInIndex ?? 0,
+            };
+        }
+        return { index: 0, offset: 0 };
+    });
+    const [isStickingToBottom, setIsStickingToBottom] = useState(() => {
+        const scrollToEnd = initialScrollIndex === SCROLL_TO_ITEM_END ||
+            (typeof initialScrollIndex === 'number' &&
+                initialScrollIndex >= data.length - 1 &&
+                initialScrollOffsetInIndex === SCROLL_TO_ITEM_END);
+        return scrollToEnd;
+    });
+    const containerRef = useRef(null);
+    const [containerHeight, setContainerHeight] = useState(0);
+    const itemRefs = useRef([]);
+    const [heights, setHeights] = useState([]);
+    const isInitialScrollSet = useRef(false);
+    const { totalHeight, offsets } = useMemo(() => {
+        const offsets = [0];
+        let totalHeight = 0;
+        for (let i = 0; i < data.length; i++) {
+            const height = heights[i] ?? estimatedItemHeight(i);
+            totalHeight += height;
+            offsets.push(totalHeight);
+        }
+        return { totalHeight, offsets };
+    }, [heights, data, estimatedItemHeight]);
+    useEffect(() => {
+        setHeights((prevHeights) => {
+            if (data.length === prevHeights.length) {
+                return prevHeights;
+            }
+            const newHeights = [...prevHeights];
+            if (data.length < prevHeights.length) {
+                newHeights.length = data.length;
+            }
+            else {
+                for (let i = prevHeights.length; i < data.length; i++) {
+                    newHeights[i] = estimatedItemHeight(i);
+                }
+            }
+            return newHeights;
+        });
+    }, [data, estimatedItemHeight]);
+    // This layout effect needs to run on every render to correctly measure the
+    // container and ensure we recompute the layout if it has changed.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    useLayoutEffect(() => {
+        if (containerRef.current) {
+            const height = Math.round(measureElement(containerRef.current).height);
+            if (containerHeight !== height) {
+                setContainerHeight(height);
+            }
+        }
+        let newHeights = null;
+        for (let i = startIndex; i <= endIndex; i++) {
+            const itemRef = itemRefs.current[i];
+            if (itemRef) {
+                const height = Math.round(measureElement(itemRef).height);
+                if (height !== heights[i]) {
+                    if (!newHeights) {
+                        newHeights = [...heights];
+                    }
+                    newHeights[i] = height;
+                }
+            }
+        }
+        if (newHeights) {
+            setHeights(newHeights);
+        }
+    });
+    const scrollableContainerHeight = containerRef.current
+        ? Math.round(measureElement(containerRef.current).height)
+        : containerHeight;
+    const getAnchorForScrollTop = useCallback((scrollTop, offsets) => {
+        const index = findLastIndex(offsets, (offset) => offset <= scrollTop);
+        if (index === -1) {
+            return { index: 0, offset: 0 };
+        }
+        return { index, offset: scrollTop - offsets[index] };
+    }, []);
+    const scrollTop = useMemo(() => {
+        const offset = offsets[scrollAnchor.index];
+        if (typeof offset !== 'number') {
+            return 0;
+        }
+        if (scrollAnchor.offset === SCROLL_TO_ITEM_END) {
+            const itemHeight = heights[scrollAnchor.index] ?? 0;
+            return offset + itemHeight - scrollableContainerHeight;
+        }
+        return offset + scrollAnchor.offset;
+    }, [scrollAnchor, offsets, heights, scrollableContainerHeight]);
+    const prevDataLength = useRef(data.length);
+    const prevTotalHeight = useRef(totalHeight);
+    const prevScrollTop = useRef(scrollTop);
+    const prevContainerHeight = useRef(scrollableContainerHeight);
+    useLayoutEffect(() => {
+        const contentPreviouslyFit = prevTotalHeight.current <= prevContainerHeight.current;
+        const wasScrolledToBottomPixels = prevScrollTop.current >=
+            prevTotalHeight.current - prevContainerHeight.current - 1;
+        const wasAtBottom = contentPreviouslyFit || wasScrolledToBottomPixels;
+        // If the user was at the bottom, they are now sticking. This handles
+        // manually scrolling back to the bottom.
+        if (wasAtBottom && scrollTop >= prevScrollTop.current) {
+            setIsStickingToBottom(true);
+        }
+        const listGrew = data.length > prevDataLength.current;
+        const containerChanged = prevContainerHeight.current !== scrollableContainerHeight;
+        // We scroll to the end if:
+        // 1. The list grew AND we were already at the bottom (or sticking).
+        // 2. We are sticking to the bottom AND the container size changed.
+        if ((listGrew && (isStickingToBottom || wasAtBottom)) ||
+            (isStickingToBottom && containerChanged)) {
+            setScrollAnchor({
+                index: data.length > 0 ? data.length - 1 : 0,
+                offset: SCROLL_TO_ITEM_END,
+            });
+            // If we are scrolling to the bottom, we are by definition sticking.
+            if (!isStickingToBottom) {
+                setIsStickingToBottom(true);
+            }
+        }
+        // Scenario 2: The list has changed (shrunk) in a way that our
+        // current scroll position or anchor is invalid. We should adjust to the bottom.
+        else if ((scrollAnchor.index >= data.length ||
+            scrollTop > totalHeight - scrollableContainerHeight) &&
+            data.length > 0) {
+            const newScrollTop = Math.max(0, totalHeight - scrollableContainerHeight);
+            setScrollAnchor(getAnchorForScrollTop(newScrollTop, offsets));
+        }
+        else if (data.length === 0) {
+            // List is now empty, reset scroll to top.
+            setScrollAnchor({ index: 0, offset: 0 });
+        }
+        // Update refs for the next render cycle.
+        prevDataLength.current = data.length;
+        prevTotalHeight.current = totalHeight;
+        prevScrollTop.current = scrollTop;
+        prevContainerHeight.current = scrollableContainerHeight;
+    }, [
+        data.length,
+        totalHeight,
+        scrollTop,
+        scrollableContainerHeight,
+        scrollAnchor.index,
+        getAnchorForScrollTop,
+        offsets,
+        isStickingToBottom,
+    ]);
+    useLayoutEffect(() => {
+        if (isInitialScrollSet.current ||
+            offsets.length <= 1 ||
+            totalHeight <= 0 ||
+            containerHeight <= 0) {
+            return;
+        }
+        if (typeof initialScrollIndex === 'number') {
+            const scrollToEnd = initialScrollIndex === SCROLL_TO_ITEM_END ||
+                (initialScrollIndex >= data.length - 1 &&
+                    initialScrollOffsetInIndex === SCROLL_TO_ITEM_END);
+            if (scrollToEnd) {
+                setScrollAnchor({
+                    index: data.length - 1,
+                    offset: SCROLL_TO_ITEM_END,
+                });
+                setIsStickingToBottom(true);
+                isInitialScrollSet.current = true;
+                return;
+            }
+            const index = Math.max(0, Math.min(data.length - 1, initialScrollIndex));
+            const offset = initialScrollOffsetInIndex ?? 0;
+            const newScrollTop = (offsets[index] ?? 0) + offset;
+            const clampedScrollTop = Math.max(0, Math.min(totalHeight - scrollableContainerHeight, newScrollTop));
+            setScrollAnchor(getAnchorForScrollTop(clampedScrollTop, offsets));
+            isInitialScrollSet.current = true;
+        }
+    }, [
+        initialScrollIndex,
+        initialScrollOffsetInIndex,
+        offsets,
+        totalHeight,
+        containerHeight,
+        getAnchorForScrollTop,
+        data.length,
+        heights,
+        scrollableContainerHeight,
+    ]);
+    const startIndex = Math.max(0, findLastIndex(offsets, (offset) => offset <= scrollTop) - 1);
+    const endIndexOffset = offsets.findIndex((offset) => offset > scrollTop + scrollableContainerHeight);
+    const endIndex = endIndexOffset === -1
+        ? data.length - 1
+        : Math.min(data.length - 1, endIndexOffset);
+    const topSpacerHeight = offsets[startIndex] ?? 0;
+    const bottomSpacerHeight = totalHeight - (offsets[endIndex + 1] ?? totalHeight);
+    const renderedItems = [];
+    for (let i = startIndex; i <= endIndex; i++) {
+        const item = data[i];
+        if (item) {
+            renderedItems.push(_jsx(Box, { width: "100%", ref: (el) => {
+                    itemRefs.current[i] = el;
+                }, children: renderItem({ item, index: i }) }, keyExtractor(item, i)));
+        }
+    }
+    const { getScrollTop, setPendingScrollTop } = useBatchedScroll(scrollTop);
+    useImperativeHandle(ref, () => ({
+        scrollBy: (delta) => {
+            if (delta < 0) {
+                setIsStickingToBottom(false);
+            }
+            const currentScrollTop = getScrollTop();
+            const newScrollTop = Math.max(0, Math.min(totalHeight - scrollableContainerHeight, currentScrollTop + delta));
+            setPendingScrollTop(newScrollTop);
+            setScrollAnchor(getAnchorForScrollTop(newScrollTop, offsets));
+        },
+        scrollTo: (offset) => {
+            setIsStickingToBottom(false);
+            const newScrollTop = Math.max(0, Math.min(totalHeight - scrollableContainerHeight, offset));
+            setPendingScrollTop(newScrollTop);
+            setScrollAnchor(getAnchorForScrollTop(newScrollTop, offsets));
+        },
+        scrollToEnd: () => {
+            setIsStickingToBottom(true);
+            if (data.length > 0) {
+                setScrollAnchor({
+                    index: data.length - 1,
+                    offset: SCROLL_TO_ITEM_END,
+                });
+            }
+        },
+        scrollToIndex: ({ index, viewOffset = 0, viewPosition = 0, }) => {
+            setIsStickingToBottom(false);
+            const offset = offsets[index];
+            if (offset !== undefined) {
+                const newScrollTop = Math.max(0, Math.min(totalHeight - scrollableContainerHeight, offset - viewPosition * scrollableContainerHeight + viewOffset));
+                setPendingScrollTop(newScrollTop);
+                setScrollAnchor(getAnchorForScrollTop(newScrollTop, offsets));
+            }
+        },
+        scrollToItem: ({ item, viewOffset = 0, viewPosition = 0, }) => {
+            setIsStickingToBottom(false);
+            const index = data.indexOf(item);
+            if (index !== -1) {
+                const offset = offsets[index];
+                if (offset !== undefined) {
+                    const newScrollTop = Math.max(0, Math.min(totalHeight - scrollableContainerHeight, offset - viewPosition * scrollableContainerHeight + viewOffset));
+                    setPendingScrollTop(newScrollTop);
+                    setScrollAnchor(getAnchorForScrollTop(newScrollTop, offsets));
+                }
+            }
+        },
+        getScrollIndex: () => scrollAnchor.index,
+        getScrollState: () => ({
+            scrollTop: getScrollTop(),
+            scrollHeight: totalHeight,
+            innerHeight: containerHeight,
+        }),
+    }), [
+        offsets,
+        scrollAnchor,
+        totalHeight,
+        getAnchorForScrollTop,
+        data,
+        scrollableContainerHeight,
+        getScrollTop,
+        setPendingScrollTop,
+        containerHeight,
+    ]);
+    return (_jsx(Box, { ref: containerRef, overflowY: "scroll", overflowX: "hidden", scrollTop: scrollTop, scrollbarThumbColor: props.scrollbarThumbColor ?? theme.text.secondary, width: "100%", height: "100%", flexDirection: "column", paddingRight: 1, children: _jsxs(Box, { flexShrink: 0, width: "100%", flexDirection: "column", children: [_jsx(Box, { height: topSpacerHeight, flexShrink: 0 }), renderedItems, _jsx(Box, { height: bottomSpacerHeight, flexShrink: 0 })] }) }));
+}
+const VirtualizedListWithForwardRef = forwardRef(VirtualizedList);
+export { VirtualizedListWithForwardRef as VirtualizedList };
+VirtualizedList.displayName = 'VirtualizedList';
+//# sourceMappingURL=VirtualizedList.js.map

package/dist/src/ui/components/shared/VirtualizedList.js.map

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

package/dist/src/ui/components/shared/VirtualizedList.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/ui/components/shared/VirtualizedList.test.js

@@ -0,0 +1,171 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { render } from '../../../test-utils/render.js';
+import { VirtualizedList } from './VirtualizedList.js';
+import { Text, Box } from 'ink';
+import { createRef, act, useEffect, createContext, useContext, useState, } from 'react';
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+describe('<VirtualizedList />', () => {
+    const keyExtractor = (item) => item;
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('with 10px height and 100 items', () => {
+        const longData = Array.from({ length: 100 }, (_, i) => `Item ${i}`);
+        // We use 1px for items. Container is 10px.
+        // Viewport shows 10 items. Overscan adds 10 items.
+        const itemHeight = 1;
+        const renderItem1px = ({ item }) => (_jsx(Box, { height: itemHeight, children: _jsx(Text, { children: item }) }));
+        it.each([
+            {
+                name: 'top',
+                initialScrollIndex: undefined,
+                visible: ['Item 0', 'Item 7'],
+                notVisible: ['Item 8', 'Item 15', 'Item 50', 'Item 99'],
+            },
+            {
+                name: 'scrolled to bottom',
+                initialScrollIndex: 99,
+                visible: ['Item 99', 'Item 92'],
+                notVisible: ['Item 91', 'Item 85', 'Item 50', 'Item 0'],
+            },
+        ])('renders only visible items ($name)', async ({ initialScrollIndex, visible, notVisible }) => {
+            const { lastFrame } = render(_jsx(Box, { height: 10, width: 100, borderStyle: "round", children: _jsx(VirtualizedList, { data: longData, renderItem: renderItem1px, keyExtractor: keyExtractor, estimatedItemHeight: () => itemHeight, initialScrollIndex: initialScrollIndex }) }));
+            await act(async () => {
+                await delay(0);
+            });
+            const frame = lastFrame();
+            visible.forEach((item) => {
+                expect(frame).toContain(item);
+            });
+            notVisible.forEach((item) => {
+                expect(frame).not.toContain(item);
+            });
+            expect(frame).toMatchSnapshot();
+        });
+        it('sticks to bottom when new items added', async () => {
+            const { lastFrame, rerender } = render(_jsx(Box, { height: 10, width: 100, borderStyle: "round", children: _jsx(VirtualizedList, { data: longData, renderItem: renderItem1px, keyExtractor: keyExtractor, estimatedItemHeight: () => itemHeight, initialScrollIndex: 99 }) }));
+            await act(async () => {
+                await delay(0);
+            });
+            expect(lastFrame()).toContain('Item 99');
+            // Add items
+            const newData = [...longData, 'Item 100', 'Item 101'];
+            rerender(_jsx(Box, { height: 10, width: 100, borderStyle: "round", children: _jsx(VirtualizedList, { data: newData, renderItem: renderItem1px, keyExtractor: keyExtractor, estimatedItemHeight: () => itemHeight }) }));
+            await act(async () => {
+                await delay(0);
+            });
+            const frame = lastFrame();
+            expect(frame).toContain('Item 101');
+            expect(frame).not.toContain('Item 0');
+        });
+        it('scrolls down to show new items when requested via ref', async () => {
+            const ref = createRef();
+            const { lastFrame } = render(_jsx(Box, { height: 10, width: 100, borderStyle: "round", children: _jsx(VirtualizedList, { ref: ref, data: longData, renderItem: renderItem1px, keyExtractor: keyExtractor, estimatedItemHeight: () => itemHeight }) }));
+            await act(async () => {
+                await delay(0);
+            });
+            expect(lastFrame()).toContain('Item 0');
+            // Scroll to bottom via ref
+            await act(async () => {
+                ref.current?.scrollToEnd();
+                await delay(0);
+            });
+            const frame = lastFrame();
+            expect(frame).toContain('Item 99');
+        });
+        it.each([
+            { initialScrollIndex: 0, expectedMountedCount: 5 },
+            { initialScrollIndex: 500, expectedMountedCount: 6 },
+            { initialScrollIndex: 999, expectedMountedCount: 5 },
+        ])('mounts only visible items with 1000 items and 10px height (scroll: $initialScrollIndex)', async ({ initialScrollIndex, expectedMountedCount }) => {
+            let mountedCount = 0;
+            const tallItemHeight = 5;
+            const ItemWithEffect = ({ item }) => {
+                useEffect(() => {
+                    mountedCount++;
+                    return () => {
+                        mountedCount--;
+                    };
+                }, []);
+                return (_jsx(Box, { height: tallItemHeight, children: _jsx(Text, { children: item }) }));
+            };
+            const veryLongData = Array.from({ length: 1000 }, (_, i) => `Item ${i}`);
+            const { lastFrame } = render(_jsx(Box, { height: 20, width: 100, borderStyle: "round", children: _jsx(VirtualizedList, { data: veryLongData, renderItem: ({ item }) => (_jsx(ItemWithEffect, { item: item }, item)), keyExtractor: keyExtractor, estimatedItemHeight: () => tallItemHeight, initialScrollIndex: initialScrollIndex }) }));
+            await act(async () => {
+                await delay(0);
+            });
+            const frame = lastFrame();
+            expect(mountedCount).toBe(expectedMountedCount);
+            expect(frame).toMatchSnapshot();
+        });
+    });
+    it('renders more items when a visible item shrinks via context update', async () => {
+        const SizeContext = createContext({
+            firstItemHeight: 10,
+            setFirstItemHeight: () => { },
+        });
+        const items = Array.from({ length: 20 }, (_, i) => ({
+            id: `Item ${i}`,
+        }));
+        const ItemWithContext = ({ item, index, }) => {
+            const { firstItemHeight } = useContext(SizeContext);
+            const height = index === 0 ? firstItemHeight : 1;
+            return (_jsx(Box, { height: height, children: _jsx(Text, { children: item.id }) }));
+        };
+        const TestComponent = () => {
+            const [firstItemHeight, setFirstItemHeight] = useState(10);
+            return (_jsxs(SizeContext.Provider, { value: { firstItemHeight, setFirstItemHeight }, children: [_jsx(Box, { height: 10, width: 100, children: _jsx(VirtualizedList, { data: items, renderItem: ({ item, index }) => (_jsx(ItemWithContext, { item: item, index: index })), keyExtractor: (item) => item.id, estimatedItemHeight: () => 1 }) }), _jsx(TestControl, { setFirstItemHeight: setFirstItemHeight })] }));
+        };
+        let setHeightFn = () => { };
+        const TestControl = ({ setFirstItemHeight, }) => {
+            setHeightFn = setFirstItemHeight;
+            return null;
+        };
+        const { lastFrame } = render(_jsx(TestComponent, {}));
+        await act(async () => {
+            await delay(0);
+        });
+        // Initially, only Item 0 (height 10) fills the 10px viewport
+        expect(lastFrame()).toContain('Item 0');
+        expect(lastFrame()).not.toContain('Item 1');
+        // Shrink Item 0 to 1px via context
+        await act(async () => {
+            setHeightFn(1);
+            await delay(0);
+        });
+        // Now Item 0 is 1px, so Items 1-9 should also be visible to fill 10px
+        expect(lastFrame()).toContain('Item 0');
+        expect(lastFrame()).toContain('Item 1');
+        expect(lastFrame()).toContain('Item 9');
+    });
+    it('updates scroll position correctly when scrollBy is called multiple times in the same tick', async () => {
+        const ref = createRef();
+        const longData = Array.from({ length: 100 }, (_, i) => `Item ${i}`);
+        const itemHeight = 1;
+        const renderItem1px = ({ item }) => (_jsx(Box, { height: itemHeight, children: _jsx(Text, { children: item }) }));
+        const keyExtractor = (item) => item;
+        render(_jsx(Box, { height: 10, width: 100, borderStyle: "round", children: _jsx(VirtualizedList, { ref: ref, data: longData, renderItem: renderItem1px, keyExtractor: keyExtractor, estimatedItemHeight: () => itemHeight }) }));
+        await act(async () => {
+            await delay(0);
+        });
+        expect(ref.current?.getScrollState().scrollTop).toBe(0);
+        await act(async () => {
+            ref.current?.scrollBy(1);
+            ref.current?.scrollBy(1);
+            await delay(0);
+        });
+        expect(ref.current?.getScrollState().scrollTop).toBe(2);
+        await act(async () => {
+            ref.current?.scrollBy(2);
+            await delay(0);
+        });
+        expect(ref.current?.getScrollState().scrollTop).toBe(4);
+    });
+});
+//# sourceMappingURL=VirtualizedList.test.js.map

package/dist/src/ui/components/shared/VirtualizedList.test.js.map

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

package/dist/src/ui/components/shared/text-buffer.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import type { Key } from '../../contexts/KeypressContext.js';
 export type Direction = 'left' | 'right' | 'up' | 'down' | 'wordLeft' | 'wordRight' | 'home' | 'end';
 export declare const isWordCharStrict: (char: string) => boolean;
 export declare const isWhitespace: (char: string) => boolean;
@@ -336,14 +337,7 @@ export interface TextBuffer {
     /**
      * High level "handleInput" – receives what Ink gives us.
      */
-    handleInput: (key: {
-        name: string;
-        ctrl: boolean;
-        meta: boolean;
-        shift: boolean;
-        paste: boolean;
-        sequence: string;
-    }) => void;
+    handleInput: (key: Key) => void;
     /**
      * Opens the current buffer contents in the user's preferred terminal text
      * editor ($VISUAL or $EDITOR, falling back to "vi").  The method blocks

package/dist/src/ui/components/shared/text-buffer.js

@@ -1455,7 +1455,7 @@ export function useTextBuffer({ initialText = '', initialCursorOffset = 0, viewp
             undo();
         else if (key.ctrl && key.shift && key.name === 'z')
             redo();
-        else if (input && !key.ctrl && !key.meta && key.name !== 'tab') {
+        else if (key.insertable) {
             insert(input, { paste: key.paste });
         }
     }, [