@vybestack/llxprt-code 0.5.0 → 0.6.1

package/dist/src/ui/hooks/useExtensionAutoUpdate.js

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useEffect, useMemo } from 'react';
+import { ExtensionAutoUpdater } from '../../extensions/extensionAutoUpdater.js';
+export function useExtensionAutoUpdate({ settings, onConsoleMessage, }) {
+    const autoUpdateSettings = settings.merged.extensions?.autoUpdate;
+    const perExtensionSignature = useMemo(() => JSON.stringify(autoUpdateSettings?.perExtension ?? {}), [autoUpdateSettings?.perExtension]);
+    useEffect(() => {
+        if (!autoUpdateSettings?.enabled) {
+            return;
+        }
+        const updater = new ExtensionAutoUpdater({
+            settings: autoUpdateSettings,
+            notify: (message, level) => {
+                const type = level === 'error' ? 'error' : level === 'warn' ? 'warn' : 'info';
+                onConsoleMessage({
+                    type,
+                    content: message,
+                    count: 1,
+                });
+            },
+        });
+        const stop = updater.start();
+        return () => {
+            stop();
+        };
+    }, [
+        autoUpdateSettings,
+        autoUpdateSettings?.enabled,
+        autoUpdateSettings?.checkIntervalHours,
+        autoUpdateSettings?.installMode,
+        autoUpdateSettings?.notificationLevel,
+        perExtensionSignature,
+        onConsoleMessage,
+    ]);
+}
+//# sourceMappingURL=useExtensionAutoUpdate.js.map

package/dist/src/ui/hooks/useExtensionAutoUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExtensionAutoUpdate.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useExtensionAutoUpdate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAShF,MAAM,UAAU,sBAAsB,CAAC,EACrC,QAAQ,EACR,gBAAgB,GACc;IAC9B,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC;IAClE,MAAM,qBAAqB,GAAG,OAAO,CACnC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE,YAAY,IAAI,EAAE,CAAC,EAC5D,CAAC,kBAAkB,EAAE,YAAY,CAAC,CACnC,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,kBAAkB,EAAE,OAAO,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,oBAAoB,CAAC;YACvC,QAAQ,EAAE,kBAAkB;YAC5B,MAAM,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;gBACzB,MAAM,IAAI,GACR,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;gBACnE,gBAAgB,CAAC;oBACf,IAAI;oBACJ,OAAO,EAAE,OAAO;oBAChB,KAAK,EAAE,CAAC;iBACT,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QAE7B,OAAO,GAAG,EAAE;YACV,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;IACJ,CAAC,EAAE;QACD,kBAAkB;QAClB,kBAAkB,EAAE,OAAO;QAC3B,kBAAkB,EAAE,kBAAkB;QACtC,kBAAkB,EAAE,WAAW;QAC/B,kBAAkB,EAAE,iBAAiB;QACrC,qBAAqB;QACrB,gBAAgB;KACjB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/ui/hooks/useExtensionUpdates.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { GeminiCLIExtension } from '@vybestack/llxprt-code-core';
+import { ExtensionUpdateState } from '../state/extensions.js';
+import type { UseHistoryManagerReturn } from './useHistoryManager.js';
+import { type ConfirmationRequest } from '../types.js';
+type ConfirmationRequestWrapper = {
+    prompt: React.ReactNode;
+    onConfirm: (confirmed: boolean) => void;
+};
+export declare const useExtensionUpdates: (extensions: GeminiCLIExtension[], addItem: UseHistoryManagerReturn["addItem"], cwd: string) => {
+    extensionsUpdateState: Map<string, ExtensionUpdateState>;
+    extensionsUpdateStateInternal: Map<string, import("../state/extensions.js").ExtensionUpdateStatus>;
+    dispatchExtensionStateUpdate: import("react").ActionDispatch<[action: import("../state/extensions.js").ExtensionUpdateAction]>;
+    confirmUpdateExtensionRequests: ConfirmationRequestWrapper[];
+    addConfirmUpdateExtensionRequest: (original: ConfirmationRequest) => void;
+};
+export {};

package/dist/src/ui/hooks/useExtensionUpdates.js

@@ -0,0 +1,168 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getErrorMessage } from '../../utils/errors.js';
+import { ExtensionUpdateState, extensionUpdatesReducer, initialExtensionUpdatesState, } from '../state/extensions.js';
+import { useCallback, useEffect, useMemo, useReducer } from 'react';
+import { MessageType } from '../types.js';
+import { checkForAllExtensionUpdates, updateExtension, } from '../../config/extensions/update.js';
+import { requestConsentInteractive, } from '../../config/extension.js';
+import { checkExhaustive } from '../../utils/checks.js';
+function confirmationRequestsReducer(state, action) {
+    switch (action.type) {
+        case 'add':
+            return [...state, action.request];
+        case 'remove':
+            return state.filter((r) => r !== action.request);
+        default:
+            checkExhaustive(action);
+    }
+}
+export const useExtensionUpdates = (extensions, addItem, cwd) => {
+    const [extensionsUpdateState, dispatchExtensionStateUpdate] = useReducer(extensionUpdatesReducer, initialExtensionUpdatesState);
+    const [confirmUpdateExtensionRequests, dispatchConfirmUpdateExtensionRequests,] = useReducer(confirmationRequestsReducer, []);
+    const addConfirmUpdateExtensionRequest = useCallback((original) => {
+        const wrappedRequest = {
+            prompt: original.prompt,
+            onConfirm: (confirmed) => {
+                // Remove it from the outstanding list of requests by identity.
+                dispatchConfirmUpdateExtensionRequests({
+                    type: 'remove',
+                    request: wrappedRequest,
+                });
+                original.onConfirm(confirmed);
+            },
+        };
+        dispatchConfirmUpdateExtensionRequests({
+            type: 'add',
+            request: wrappedRequest,
+        });
+    }, [dispatchConfirmUpdateExtensionRequests]);
+    useEffect(() => {
+        const extensionsToCheck = extensions.filter((extension) => {
+            const currentStatus = extensionsUpdateState.extensionStatuses.get(extension.name);
+            if (!currentStatus)
+                return true;
+            const currentState = currentStatus.status;
+            return !currentState || currentState === ExtensionUpdateState.UNKNOWN;
+        });
+        if (extensionsToCheck.length === 0)
+            return;
+        checkForAllExtensionUpdates(extensionsToCheck, dispatchExtensionStateUpdate, cwd);
+    }, [
+        extensions,
+        extensionsUpdateState.extensionStatuses,
+        cwd,
+        dispatchExtensionStateUpdate,
+    ]);
+    useEffect(() => {
+        if (extensionsUpdateState.batchChecksInProgress > 0) {
+            return;
+        }
+        const scheduledUpdate = extensionsUpdateState.scheduledUpdate;
+        if (scheduledUpdate) {
+            dispatchExtensionStateUpdate({
+                type: 'CLEAR_SCHEDULED_UPDATE',
+            });
+        }
+        function shouldDoUpdate(extension) {
+            if (scheduledUpdate) {
+                if (scheduledUpdate.all) {
+                    return true;
+                }
+                return scheduledUpdate.names?.includes(extension.name) === true;
+            }
+            else {
+                return extension.installMetadata?.autoUpdate === true;
+            }
+        }
+        let extensionsWithUpdatesCount = 0;
+        // We only notify if we have unprocessed extensions in the UPDATE_AVAILABLE
+        // state.
+        let shouldNotifyOfUpdates = false;
+        const updatePromises = [];
+        for (const extension of extensions) {
+            const currentState = extensionsUpdateState.extensionStatuses.get(extension.name);
+            if (!currentState ||
+                currentState.status !== ExtensionUpdateState.UPDATE_AVAILABLE) {
+                continue;
+            }
+            const shouldUpdate = shouldDoUpdate(extension);
+            if (!shouldUpdate) {
+                extensionsWithUpdatesCount++;
+                if (!currentState.notified) {
+                    // Mark as processed immediately to avoid re-triggering.
+                    dispatchExtensionStateUpdate({
+                        type: 'SET_NOTIFIED',
+                        payload: { name: extension.name, notified: true },
+                    });
+                    shouldNotifyOfUpdates = true;
+                }
+            }
+            else {
+                const updatePromise = updateExtension(extension, cwd, (description) => requestConsentInteractive(description, addConfirmUpdateExtensionRequest), currentState.status, dispatchExtensionStateUpdate);
+                updatePromises.push(updatePromise);
+                updatePromise
+                    .then((result) => {
+                    if (!result)
+                        return;
+                    addItem({
+                        type: MessageType.INFO,
+                        text: `Extension "${extension.name}" successfully updated: ${result.originalVersion} → ${result.updatedVersion}.`,
+                    }, Date.now());
+                })
+                    .catch((error) => {
+                    addItem({
+                        type: MessageType.ERROR,
+                        text: getErrorMessage(error),
+                    }, Date.now());
+                });
+            }
+        }
+        if (shouldNotifyOfUpdates) {
+            const s = extensionsWithUpdatesCount > 1 ? 's' : '';
+            addItem({
+                type: MessageType.INFO,
+                text: `You have ${extensionsWithUpdatesCount} extension${s} with an update available, run "/extensions list" for more information.`,
+            }, Date.now());
+        }
+        if (scheduledUpdate) {
+            Promise.allSettled(updatePromises).then((results) => {
+                const nonNullResults = results
+                    .filter((result) => result.status === 'fulfilled' && result.value != null)
+                    .map((result) => result.value);
+                scheduledUpdate.onCompleteCallbacks.forEach((callback) => {
+                    try {
+                        callback(nonNullResults);
+                    }
+                    catch (e) {
+                        console.error(getErrorMessage(e));
+                    }
+                });
+            });
+        }
+    }, [
+        extensions,
+        extensionsUpdateState,
+        addConfirmUpdateExtensionRequest,
+        addItem,
+        cwd,
+    ]);
+    const extensionsUpdateStateComputed = useMemo(() => {
+        const result = new Map();
+        for (const [key, value,] of extensionsUpdateState.extensionStatuses.entries()) {
+            result.set(key, value.status);
+        }
+        return result;
+    }, [extensionsUpdateState]);
+    return {
+        extensionsUpdateState: extensionsUpdateStateComputed,
+        extensionsUpdateStateInternal: extensionsUpdateState.extensionStatuses,
+        dispatchExtensionStateUpdate,
+        confirmUpdateExtensionRequests,
+        addConfirmUpdateExtensionRequest,
+    };
+};
+//# sourceMappingURL=useExtensionUpdates.js.map

package/dist/src/ui/hooks/useExtensionUpdates.js.map

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

package/dist/src/ui/hooks/useExtensionUpdates.test.d.ts

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

package/dist/src/ui/hooks/useExtensionUpdates.test.js

@@ -0,0 +1,243 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi } from 'vitest';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { ExtensionStorage, annotateActiveExtensions, loadExtension, } from '../../config/extension.js';
+import { createExtension } from '../../test-utils/createExtension.js';
+import { useExtensionUpdates } from './useExtensionUpdates.js';
+import { GEMINI_DIR, } from '@vybestack/llxprt-code-core';
+import { renderHook, waitFor } from '@testing-library/react';
+import { MessageType } from '../types.js';
+import { ExtensionEnablementManager } from '../../config/extensions/extensionEnablement.js';
+import { checkForAllExtensionUpdates, updateExtension, } from '../../config/extensions/update.js';
+import { ExtensionUpdateState } from '../state/extensions.js';
+vi.mock('os', async (importOriginal) => {
+    const mockedOs = await importOriginal();
+    return {
+        ...mockedOs,
+        homedir: vi.fn(),
+    };
+});
+vi.mock('../../config/extensions/update.js', () => ({
+    checkForAllExtensionUpdates: vi.fn(),
+    updateExtension: vi.fn(),
+}));
+describe('useExtensionUpdates', () => {
+    let tempHomeDir;
+    let userExtensionsDir;
+    beforeEach(() => {
+        tempHomeDir = fs.mkdtempSync(path.join(os.tmpdir(), 'gemini-cli-test-home-'));
+        vi.mocked(os.homedir).mockReturnValue(tempHomeDir);
+        userExtensionsDir = path.join(tempHomeDir, GEMINI_DIR, 'extensions');
+        fs.mkdirSync(userExtensionsDir, { recursive: true });
+        vi.mocked(checkForAllExtensionUpdates).mockReset();
+        vi.mocked(updateExtension).mockReset();
+    });
+    afterEach(() => {
+        fs.rmSync(tempHomeDir, { recursive: true, force: true });
+    });
+    it('should check for updates and log a message if an update is available', async () => {
+        const extensions = [
+            {
+                name: 'test-extension',
+                type: 'git',
+                version: '1.0.0',
+                path: '/some/path',
+                isActive: true,
+                installMetadata: {
+                    type: 'git',
+                    source: 'https://some/repo',
+                    autoUpdate: false,
+                },
+            },
+        ];
+        const addItem = vi.fn();
+        const cwd = '/test/cwd';
+        vi.mocked(checkForAllExtensionUpdates).mockImplementation(async (_extensions, dispatch, _cwd) => {
+            dispatch({
+                type: 'SET_STATE',
+                payload: {
+                    name: 'test-extension',
+                    state: ExtensionUpdateState.UPDATE_AVAILABLE,
+                },
+            });
+        });
+        renderHook(() => useExtensionUpdates(extensions, addItem, cwd));
+        await waitFor(() => {
+            expect(addItem).toHaveBeenCalledWith({
+                type: MessageType.INFO,
+                text: 'You have 1 extension with an update available, run "/extensions list" for more information.',
+            }, expect.any(Number));
+        });
+    });
+    it('should check for updates and automatically update if autoUpdate is true', async () => {
+        const extensionDir = createExtension({
+            extensionsDir: userExtensionsDir,
+            name: 'test-extension',
+            version: '1.0.0',
+            installMetadata: {
+                source: 'https://some.git/repo',
+                type: 'git',
+                autoUpdate: true,
+            },
+        });
+        const extension = annotateActiveExtensions([loadExtension({ extensionDir, workspaceDir: tempHomeDir })], tempHomeDir, new ExtensionEnablementManager(ExtensionStorage.getUserExtensionsDir()))[0];
+        const addItem = vi.fn();
+        vi.mocked(checkForAllExtensionUpdates).mockImplementation(async (_extensions, dispatch, _cwd) => {
+            dispatch({
+                type: 'SET_STATE',
+                payload: {
+                    name: 'test-extension',
+                    state: ExtensionUpdateState.UPDATE_AVAILABLE,
+                },
+            });
+        });
+        vi.mocked(updateExtension).mockResolvedValue({
+            originalVersion: '1.0.0',
+            updatedVersion: '1.1.0',
+            name: '',
+        });
+        renderHook(() => useExtensionUpdates([extension], addItem, tempHomeDir));
+        await waitFor(() => {
+            expect(addItem).toHaveBeenCalledWith({
+                type: MessageType.INFO,
+                text: 'Extension "test-extension" successfully updated: 1.0.0 → 1.1.0.',
+            }, expect.any(Number));
+        }, { timeout: 4000 });
+    });
+    it('should batch update notifications for multiple extensions', async () => {
+        const extensionDir1 = createExtension({
+            extensionsDir: userExtensionsDir,
+            name: 'test-extension-1',
+            version: '1.0.0',
+            installMetadata: {
+                source: 'https://some.git/repo1',
+                type: 'git',
+                autoUpdate: true,
+            },
+        });
+        const extensionDir2 = createExtension({
+            extensionsDir: userExtensionsDir,
+            name: 'test-extension-2',
+            version: '2.0.0',
+            installMetadata: {
+                source: 'https://some.git/repo2',
+                type: 'git',
+                autoUpdate: true,
+            },
+        });
+        const extensions = annotateActiveExtensions([
+            loadExtension({
+                extensionDir: extensionDir1,
+                workspaceDir: tempHomeDir,
+            }),
+            loadExtension({
+                extensionDir: extensionDir2,
+                workspaceDir: tempHomeDir,
+            }),
+        ], tempHomeDir, new ExtensionEnablementManager(ExtensionStorage.getUserExtensionsDir()));
+        const addItem = vi.fn();
+        vi.mocked(checkForAllExtensionUpdates).mockImplementation(async (_extensions, dispatch, _cwd) => {
+            dispatch({
+                type: 'SET_STATE',
+                payload: {
+                    name: 'test-extension-1',
+                    state: ExtensionUpdateState.UPDATE_AVAILABLE,
+                },
+            });
+            dispatch({
+                type: 'SET_STATE',
+                payload: {
+                    name: 'test-extension-2',
+                    state: ExtensionUpdateState.UPDATE_AVAILABLE,
+                },
+            });
+        });
+        vi.mocked(updateExtension)
+            .mockResolvedValueOnce({
+            originalVersion: '1.0.0',
+            updatedVersion: '1.1.0',
+            name: '',
+        })
+            .mockResolvedValueOnce({
+            originalVersion: '2.0.0',
+            updatedVersion: '2.1.0',
+            name: '',
+        });
+        renderHook(() => useExtensionUpdates(extensions, addItem, tempHomeDir));
+        await waitFor(() => {
+            expect(addItem).toHaveBeenCalledTimes(2);
+            expect(addItem).toHaveBeenCalledWith({
+                type: MessageType.INFO,
+                text: 'Extension "test-extension-1" successfully updated: 1.0.0 → 1.1.0.',
+            }, expect.any(Number));
+            expect(addItem).toHaveBeenCalledWith({
+                type: MessageType.INFO,
+                text: 'Extension "test-extension-2" successfully updated: 2.0.0 → 2.1.0.',
+            }, expect.any(Number));
+        }, { timeout: 4000 });
+    });
+    it('should batch update notifications for multiple extensions with autoUpdate: false', async () => {
+        const extensions = [
+            {
+                name: 'test-extension-1',
+                type: 'git',
+                version: '1.0.0',
+                path: '/some/path1',
+                isActive: true,
+                installMetadata: {
+                    type: 'git',
+                    source: 'https://some/repo1',
+                    autoUpdate: false,
+                },
+            },
+            {
+                name: 'test-extension-2',
+                type: 'git',
+                version: '2.0.0',
+                path: '/some/path2',
+                isActive: true,
+                installMetadata: {
+                    type: 'git',
+                    source: 'https://some/repo2',
+                    autoUpdate: false,
+                },
+            },
+        ];
+        const addItem = vi.fn();
+        const cwd = '/test/cwd';
+        vi.mocked(checkForAllExtensionUpdates).mockImplementation(async (_extensions, dispatch, _cwd) => {
+            dispatch({ type: 'BATCH_CHECK_START' });
+            dispatch({
+                type: 'SET_STATE',
+                payload: {
+                    name: 'test-extension-1',
+                    state: ExtensionUpdateState.UPDATE_AVAILABLE,
+                },
+            });
+            await new Promise((r) => setTimeout(r, 50));
+            dispatch({
+                type: 'SET_STATE',
+                payload: {
+                    name: 'test-extension-2',
+                    state: ExtensionUpdateState.UPDATE_AVAILABLE,
+                },
+            });
+            dispatch({ type: 'BATCH_CHECK_END' });
+        });
+        renderHook(() => useExtensionUpdates(extensions, addItem, cwd));
+        await waitFor(() => {
+            expect(addItem).toHaveBeenCalledTimes(1);
+            expect(addItem).toHaveBeenCalledWith({
+                type: MessageType.INFO,
+                text: 'You have 2 extensions with an update available, run "/extensions list" for more information.',
+            }, expect.any(Number));
+        });
+    });
+});
+//# sourceMappingURL=useExtensionUpdates.test.js.map

package/dist/src/ui/hooks/useExtensionUpdates.test.js.map

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

package/dist/src/ui/hooks/useFlickerDetector.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type DOMElement } from 'ink';
+/**
+ * Hook to detect UI flicker by measuring the root element's height
+ * against the terminal height.
+ *
+ * This hook is for TELEMETRY ONLY - it detects overflow and emits
+ * a Flicker event for monitoring purposes. It does NOT prevent flicker.
+ *
+ * Actual flicker prevention is handled in AppContainer by:
+ * 1. Measuring footer height
+ * 2. Calculating available terminal height
+ * 3. Passing constraints to child components
+ *
+ * This addresses issue #456 - flicker resistance for narrow terminals
+ * and dialogs/long output scenarios.
+ */
+export declare function useFlickerDetector(rootUiRef: React.RefObject<DOMElement | null>, terminalHeight: number, constrainHeight: boolean): void;

package/dist/src/ui/hooks/useFlickerDetector.js

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useEffect } from 'react';
+import { measureElement } from 'ink';
+import { appEvents, AppEvent } from '../../utils/events.js';
+/**
+ * Hook to detect UI flicker by measuring the root element's height
+ * against the terminal height.
+ *
+ * This hook is for TELEMETRY ONLY - it detects overflow and emits
+ * a Flicker event for monitoring purposes. It does NOT prevent flicker.
+ *
+ * Actual flicker prevention is handled in AppContainer by:
+ * 1. Measuring footer height
+ * 2. Calculating available terminal height
+ * 3. Passing constraints to child components
+ *
+ * This addresses issue #456 - flicker resistance for narrow terminals
+ * and dialogs/long output scenarios.
+ */
+export function useFlickerDetector(rootUiRef, terminalHeight, constrainHeight) {
+    useEffect(() => {
+        if (rootUiRef.current) {
+            const measurement = measureElement(rootUiRef.current);
+            if (measurement.height > terminalHeight && constrainHeight) {
+                appEvents.emit(AppEvent.Flicker, {
+                    contentHeight: measurement.height,
+                    terminalHeight,
+                    overflow: measurement.height - terminalHeight,
+                });
+            }
+        }
+    }); // NO dependency array - runs after every render
+}
+//# sourceMappingURL=useFlickerDetector.js.map

package/dist/src/ui/hooks/useFlickerDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFlickerDetector.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useFlickerDetector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAmB,cAAc,EAAE,MAAM,KAAK,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAA6C,EAC7C,cAAsB,EACtB,eAAwB;IAExB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACtD,IAAI,WAAW,CAAC,MAAM,GAAG,cAAc,IAAI,eAAe,EAAE,CAAC;gBAC3D,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE;oBAC/B,aAAa,EAAE,WAAW,CAAC,MAAM;oBACjC,cAAc;oBACd,QAAQ,EAAE,WAAW,CAAC,MAAM,GAAG,cAAc;iBAC9C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC,CAAC,gDAAgD;AACtD,CAAC"}

package/dist/src/ui/hooks/useFlickerDetector.test.d.ts

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