@iflow-mcp/shaun0927-openchrome 1.7.13

package/dist/tools/interact.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Interact Tool - Composite tool that finds an element, performs an action,
+ * waits for stability, and returns a comprehensive state summary.
+ *
+ * Reduces multi-step find→click→screenshot sequences to a single call.
+ */
+import { MCPServer } from '../mcp-server';
+export declare function registerInteractTool(server: MCPServer): void;
+//# sourceMappingURL=interact.d.ts.map

package/dist/tools/interact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interact.d.ts","sourceRoot":"","sources":["../../src/tools/interact.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAwY1C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAE5D"}

package/dist/tools/interact.js

@@ -0,0 +1,366 @@
+"use strict";
+/**
+ * Interact Tool - Composite tool that finds an element, performs an action,
+ * waits for stability, and returns a comprehensive state summary.
+ *
+ * Reduces multi-step find→click→screenshot sequences to a single call.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInteractTool = registerInteractTool;
+const session_manager_1 = require("../session-manager");
+const ref_id_manager_1 = require("../utils/ref-id-manager");
+const dom_delta_1 = require("../utils/dom-delta");
+const defaults_1 = require("../config/defaults");
+const element_finder_1 = require("../utils/element-finder");
+const element_discovery_1 = require("../utils/element-discovery");
+const with_timeout_1 = require("../utils/with-timeout");
+const definition = {
+    name: 'interact',
+    description: 'Find element, act, wait, return state summary.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tabId: {
+                type: 'string',
+                description: 'Tab ID to execute on',
+            },
+            query: {
+                type: 'string',
+                description: 'Element to act on (natural language)',
+            },
+            action: {
+                type: 'string',
+                enum: ['click', 'double_click', 'hover'],
+                description: 'Action to perform. Default: click',
+            },
+            waitAfter: {
+                type: 'number',
+                description: 'DOM settle wait in ms. Default: 500',
+            },
+            returnFormat: {
+                type: 'string',
+                enum: ['state_summary', 'dom_delta', 'both'],
+                description: 'Response content. Default: both',
+            },
+            verify: {
+                type: 'boolean',
+                description: 'Return screenshot after action',
+            },
+            waitForMs: {
+                type: 'number',
+                description: 'Poll timeout for element in ms. Max: 30000',
+            },
+            pollInterval: {
+                type: 'number',
+                description: 'Poll interval in ms. Default: 200',
+            },
+        },
+        required: ['tabId', 'query'],
+    },
+};
+const handler = async (sessionId, args) => {
+    const tabId = args.tabId;
+    const query = args.query;
+    const action = args.action || 'click';
+    const waitAfter = Math.min(Math.max(args.waitAfter || 500, 0), 10000);
+    const returnFormat = args.returnFormat || 'both';
+    const verify = args.verify;
+    const waitForMs = args.waitForMs;
+    const pollInterval = Math.min(Math.max(args.pollInterval || 200, 50), 2000);
+    const sessionManager = (0, session_manager_1.getSessionManager)();
+    const refIdManager = (0, ref_id_manager_1.getRefIdManager)();
+    if (!tabId) {
+        return {
+            content: [{ type: 'text', text: 'Error: tabId is required' }],
+            isError: true,
+        };
+    }
+    if (!query) {
+        return {
+            content: [{ type: 'text', text: 'Error: query is required' }],
+            isError: true,
+        };
+    }
+    try {
+        const page = await sessionManager.getPage(sessionId, tabId, undefined, 'interact');
+        if (!page) {
+            return {
+                content: [{ type: 'text', text: `Error: Tab ${tabId} not found` }],
+                isError: true,
+            };
+        }
+        const queryLower = query.toLowerCase();
+        const queryTokens = (0, element_finder_1.tokenizeQuery)(query);
+        // Optional polling for dynamic/lazy content
+        const maxWait = waitForMs ? Math.min(Math.max(waitForMs, 100), 30000) : 0;
+        let bestElement = null;
+        const startTime = Date.now();
+        const cdpClient = sessionManager.getCDPClient();
+        do {
+            // Find elements matching the query using the shared discovery module
+            let results;
+            try {
+                results = await (0, element_discovery_1.discoverElements)(page, cdpClient, queryLower, {
+                    maxResults: 30,
+                    useCenter: true,
+                    timeout: 10000,
+                    toolName: 'interact',
+                });
+            }
+            catch {
+                // CDP evaluate timed out — retry if budget remains
+                if (maxWait > 0 && Date.now() - startTime < maxWait) {
+                    await new Promise(resolve => setTimeout(resolve, pollInterval));
+                    continue;
+                }
+                results = [];
+            }
+            if (results.length === 0) {
+                if (maxWait > 0 && Date.now() - startTime < maxWait) {
+                    await new Promise(resolve => setTimeout(resolve, pollInterval));
+                    continue;
+                }
+                return {
+                    content: [{ type: 'text', text: `No elements found matching "${query}"` }],
+                    isError: true,
+                };
+            }
+            // Score and sort, preserving original index for tagged element re-lookup
+            const scoredResults = results
+                .map((el, i) => ({ ...el, score: (0, element_finder_1.scoreElement)(el, queryLower, queryTokens), _origIdx: i }))
+                .sort((a, b) => b.score - a.score);
+            if (scoredResults.length > 0 && scoredResults[0].score >= 10) {
+                bestElement = scoredResults[0];
+                break;
+            }
+            if (maxWait > 0 && Date.now() - startTime < maxWait) {
+                await new Promise(resolve => setTimeout(resolve, pollInterval));
+            }
+            else {
+                // No polling or timeout reached — use best available even if low score
+                if (scoredResults.length > 0) {
+                    bestElement = scoredResults[0];
+                }
+                break;
+            }
+        } while (Date.now() - startTime < maxWait);
+        const bestMatch = bestElement;
+        if (!bestMatch || bestMatch.score < 10) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `No good match found for "${query}". Best candidate was "${bestMatch?.name || 'unknown'}" with low confidence.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Scroll into view first if needed
+        if (bestMatch.backendDOMNodeId) {
+            try {
+                await cdpClient.send(page, 'DOM.scrollIntoViewIfNeeded', {
+                    backendNodeId: bestMatch.backendDOMNodeId,
+                });
+                await new Promise(resolve => setTimeout(resolve, defaults_1.DEFAULT_DOM_SETTLE_DELAY_MS));
+                // Re-get position after scroll using the shared utility
+                const newRect = await (0, element_discovery_1.getTaggedElementRect)(page, cdpClient, element_discovery_1.DISCOVERY_TAG, bestMatch._origIdx, true);
+                if (newRect) {
+                    bestMatch.rect.x = newRect.x;
+                    bestMatch.rect.y = newRect.y;
+                }
+            }
+            catch {
+                // Continue with original coordinates
+            }
+        }
+        const finalX = Math.round(bestMatch.rect.x);
+        const finalY = Math.round(bestMatch.rect.y);
+        // Perform the action with DOM delta capture
+        const { delta } = await (0, dom_delta_1.withDomDelta)(page, async () => {
+            if (action === 'double_click') {
+                await page.mouse.click(finalX, finalY, { clickCount: 2 });
+            }
+            else if (action === 'hover') {
+                await page.mouse.move(finalX, finalY);
+            }
+            else {
+                await page.mouse.click(finalX, finalY);
+            }
+        }, { settleMs: Math.max(150, waitAfter) });
+        // Generate ref for the interacted element
+        let refId = '';
+        if (bestMatch.backendDOMNodeId) {
+            refId = refIdManager.generateRef(sessionId, tabId, bestMatch.backendDOMNodeId, bestMatch.role, bestMatch.name, bestMatch.tagName, bestMatch.textContent);
+        }
+        // Clean up discovery tags to prevent stale properties
+        await (0, element_discovery_1.cleanupTags)(page, element_discovery_1.DISCOVERY_TAG).catch(() => { });
+        // Build compact action label
+        const actionVerb = action === 'double_click' ? 'Double-clicked' : action === 'hover' ? 'Hovered' : 'Clicked';
+        const textSample = bestMatch.textContent?.slice(0, 50) || bestMatch.name.slice(0, 50);
+        const textPart = textSample ? ` "${textSample}"` : '';
+        const refPart = refId ? ` [${refId}]` : '';
+        const interactedLine = `\u2713 ${actionVerb} ${bestMatch.tagName}${textPart}${refPart}`;
+        // Gather state summary via page.evaluate
+        const stateSummary = await (0, with_timeout_1.withTimeout)(page.evaluate(() => {
+            const url = window.location.href;
+            const title = document.title;
+            const scrollX = Math.round(window.scrollX);
+            const scrollY = Math.round(window.scrollY);
+            // Active element info
+            const active = document.activeElement;
+            let activeInfo = 'none';
+            if (active && active !== document.body) {
+                const inputEl = active;
+                const role = active.getAttribute('role') ||
+                    (active.tagName === 'BUTTON'
+                        ? 'button'
+                        : active.tagName === 'INPUT'
+                            ? inputEl.type || 'textbox'
+                            : active.tagName.toLowerCase());
+                const name = active.getAttribute('aria-label') ||
+                    active.getAttribute('title') ||
+                    active.textContent?.trim().slice(0, 40) ||
+                    '';
+                activeInfo = `${role}${name ? ` "${name}"` : ''}`;
+            }
+            // Visible panel contents (first 80 chars each, max 3)
+            const panels = [];
+            const panelSelectors = [
+                '[role="tabpanel"]',
+                '[role="dialog"]',
+                '[role="main"]',
+                'main',
+                '.panel',
+                '[class*="panel"]',
+                '[class*="content"]',
+            ];
+            for (const sel of panelSelectors) {
+                if (panels.length >= 3)
+                    break;
+                try {
+                    const els = document.querySelectorAll(sel);
+                    for (const el of els) {
+                        if (panels.length >= 3)
+                            break;
+                        const rect = el.getBoundingClientRect();
+                        if (rect.width === 0 || rect.height === 0)
+                            continue;
+                        const style = window.getComputedStyle(el);
+                        if (style.display === 'none' || style.visibility === 'hidden')
+                            continue;
+                        const text = el.textContent?.trim().slice(0, 80) || '';
+                        if (text.length > 10) {
+                            panels.push(text);
+                        }
+                    }
+                }
+                catch {
+                    // skip bad selectors
+                }
+            }
+            // Visible headings
+            const headings = [];
+            for (const hEl of document.querySelectorAll('h1, h2, h3, [role="heading"]')) {
+                const rect = hEl.getBoundingClientRect();
+                if (rect.width === 0 || rect.height === 0)
+                    continue;
+                const style = window.getComputedStyle(hEl);
+                if (style.display === 'none' || style.visibility === 'hidden')
+                    continue;
+                const text = hEl.textContent?.trim().slice(0, 60) || '';
+                if (text)
+                    headings.push(text);
+                if (headings.length >= 3)
+                    break;
+            }
+            return { url, title, scrollX, scrollY, activeInfo, panels, headings };
+        }), 10000, 'interact');
+        // Build the response — compact success format
+        const lines = [interactedLine];
+        if (returnFormat === 'dom_delta' || returnFormat === 'both') {
+            if (delta) {
+                lines.push(delta);
+            }
+        }
+        if (returnFormat === 'state_summary' || returnFormat === 'both') {
+            lines.push(`[State Summary] url: ${stateSummary.url} | scroll: ${stateSummary.scrollX},${stateSummary.scrollY} | active: ${stateSummary.activeInfo}`);
+            if (stateSummary.headings.length > 0) {
+                lines.push(`[Headings] ${stateSummary.headings.map(h => `"${h}"`).join(' | ')}`);
+            }
+            if (stateSummary.panels.length > 0) {
+                const panelParts = stateSummary.panels.map((p, i) => `Panel ${i + 1}: "${p}"`);
+                lines.push(`[Visible] ${panelParts.join(' | ')}`);
+            }
+        }
+        // Optional screenshot verification — WebP via CDP, fallback to Puppeteer PNG
+        let screenshotContent = null;
+        if (verify) {
+            try {
+                const screenshotResult = await Promise.race([
+                    (async () => {
+                        const cdpSession = await page.target().createCDPSession();
+                        try {
+                            const { data } = await cdpSession.send('Page.captureScreenshot', {
+                                format: 'webp',
+                                quality: 60,
+                                optimizeForSpeed: true,
+                            });
+                            return { data: data, mimeType: 'image/webp' };
+                        }
+                        finally {
+                            await cdpSession.detach().catch(() => { });
+                        }
+                    })(),
+                    new Promise((resolve) => setTimeout(() => resolve(null), defaults_1.DEFAULT_SCREENSHOT_RACE_TIMEOUT_MS)),
+                ]);
+                if (screenshotResult) {
+                    screenshotContent = { type: 'image', ...screenshotResult };
+                }
+                else {
+                    throw new Error('CDP screenshot timed out');
+                }
+            }
+            catch {
+                // Fallback to Puppeteer PNG with timeout
+                try {
+                    let fallbackTimer;
+                    const screenshot = await Promise.race([
+                        page.screenshot({ encoding: 'base64', type: 'png', fullPage: false }).finally(() => clearTimeout(fallbackTimer)),
+                        new Promise((_, reject) => {
+                            fallbackTimer = setTimeout(() => reject(new Error('Fallback screenshot timed out')), defaults_1.DEFAULT_SCREENSHOT_TIMEOUT_MS);
+                        }),
+                    ]);
+                    screenshotContent = { type: 'image', data: screenshot, mimeType: 'image/png' };
+                }
+                catch {
+                    // Screenshot failure is non-fatal
+                }
+            }
+        }
+        const responseContent = [
+            { type: 'text', text: lines.join('\n') },
+        ];
+        if (screenshotContent) {
+            responseContent.push(screenshotContent);
+        }
+        return {
+            content: responseContent,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Interact error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+};
+function registerInteractTool(server) {
+    server.registerTool('interact', handler, definition);
+}
+//# sourceMappingURL=interact.js.map

package/dist/tools/interact.js.map

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

package/dist/tools/javascript.d.ts

@@ -0,0 +1,7 @@
+/**
+ * JavaScript Tool - Execute JavaScript in page context
+ */
+import { MCPServer } from '../mcp-server';
+export declare function wrapInIIFE(code: string): string;
+export declare function registerJavascriptTool(server: MCPServer): void;
+//# sourceMappingURL=javascript.d.ts.map

package/dist/tools/javascript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"javascript.d.ts","sourceRoot":"","sources":["../../src/tools/javascript.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AA8C1C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkD/C;AA8JD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAE9D"}

package/dist/tools/javascript.js

@@ -0,0 +1,214 @@
+"use strict";
+/**
+ * JavaScript Tool - Execute JavaScript in page context
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapInIIFE = wrapInIIFE;
+exports.registerJavascriptTool = registerJavascriptTool;
+const session_manager_1 = require("../session-manager");
+const domain_guard_1 = require("../security/domain-guard");
+const definition = {
+    name: 'javascript_tool',
+    description: 'Execute JavaScript in page context. Supports await.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tabId: {
+                type: 'string',
+                description: 'Tab ID to execute code in',
+            },
+            code: {
+                type: 'string',
+                description: 'JS code. Last expression returned',
+            },
+            text: {
+                type: 'string',
+                description: 'Deprecated. Use "code" instead',
+            },
+            timeout: {
+                type: 'number',
+                description: 'Timeout in ms. Default: 30000',
+            },
+        },
+        required: ['tabId'],
+    },
+};
+function wrapInIIFE(code) {
+    const trimmed = code.trim();
+    // Single expression without semicolons, newlines, or return: evaluate as-is
+    // so the expression value is returned naturally by Runtime.evaluate.
+    if (!trimmed.includes('\n') && !trimmed.includes(';') && !/\breturn\b/.test(trimmed)) {
+        return trimmed;
+    }
+    // Multi-statement code or code with explicit return: wrap in async IIFE.
+    // This fixes two common LLM errors:
+    //   1. SyntaxError: Illegal return statement  (return outside a function)
+    //   2. SyntaxError: Identifier 'x' has already been declared  (let/const redeclaration)
+    //
+    // If there is no explicit `return`, try to auto-return the last expression so
+    // that `let x = 5;\nx` still returns 5 instead of undefined.
+    if (!/\breturn\b/.test(trimmed)) {
+        const lines = trimmed.split('\n').filter((l) => l.trim());
+        const lastLine = lines[lines.length - 1]?.trim() ?? '';
+        // Auto-return the last line if it looks like an expression (not a
+        // declaration, control-flow statement, closing brace, or comment).
+        const isAutoReturnable = lastLine.length > 0 &&
+            !lastLine.startsWith('let ') &&
+            !lastLine.startsWith('const ') &&
+            !lastLine.startsWith('var ') &&
+            !lastLine.startsWith('function ') &&
+            !lastLine.startsWith('class ') &&
+            !lastLine.startsWith('if') &&
+            !lastLine.startsWith('else') &&
+            !lastLine.startsWith('for') &&
+            !lastLine.startsWith('while') &&
+            !lastLine.startsWith('do') &&
+            !lastLine.startsWith('switch') &&
+            !lastLine.startsWith('try') &&
+            !lastLine.startsWith('catch') &&
+            !lastLine.startsWith('finally') &&
+            !lastLine.startsWith('//') &&
+            !lastLine.startsWith('/*') &&
+            !lastLine.startsWith('}');
+        if (isAutoReturnable) {
+            const bodyLines = lines.slice(0, -1).join('\n');
+            const body = bodyLines ? `${bodyLines}\nreturn ${lastLine}` : `return ${lastLine}`;
+            return `(async () => { ${body}\n})()`;
+        }
+    }
+    return `(async () => { ${code}\n})()`;
+}
+function formatCDPResult(evalResult) {
+    const { type, subtype, value, description, className } = evalResult;
+    if (type === 'undefined') {
+        return 'undefined';
+    }
+    if (subtype === 'null') {
+        return 'null';
+    }
+    if (type === 'function') {
+        return description || '[Function]';
+    }
+    if (type === 'symbol') {
+        return description || '[Symbol]';
+    }
+    // DOM element: returnByValue can't serialize nodes, use description
+    // description for DOM nodes is like "div#id.class" — reformat to match old output
+    if (subtype === 'node' || className?.startsWith('HTML')) {
+        if (description) {
+            // description format from V8: "div#myId.myClass" or "span.foo.bar"
+            const match = description.match(/^([a-z][a-z0-9]*)(#[^\s.>]*)?(\.[^\s>]*)?$/i);
+            if (match) {
+                const tag = match[1].toLowerCase();
+                const idPart = match[2] ? ` id="${match[2].slice(1)}"` : '';
+                // class part may contain dots: ".foo.bar" -> "foo bar"
+                const classPart = match[3] ? ` class="${match[3].slice(1).replace(/\./g, ' ')}"` : '';
+                return `<${tag}${idPart}${classPart}>`;
+            }
+            return description;
+        }
+        return `[${className || type}]`;
+    }
+    // NodeList / HTMLCollection
+    if (className === 'NodeList' || className === 'HTMLCollection') {
+        if (description) {
+            // description is like "NodeList(3)" — extract count
+            const countMatch = description.match(/\((\d+)\)/);
+            if (countMatch) {
+                return `[${countMatch[1]} elements]`;
+            }
+        }
+        return description || `[${className}]`;
+    }
+    if (value !== undefined) {
+        if (typeof value === 'object' && value !== null) {
+            try {
+                return JSON.stringify(value, null, 2);
+            }
+            catch {
+                return String(value);
+            }
+        }
+        return String(value);
+    }
+    return description || `[${type}]`;
+}
+const handler = async (sessionId, args) => {
+    const tabId = args.tabId;
+    const code = args.code || args.text;
+    const timeout = args.timeout || 30000;
+    const sessionManager = (0, session_manager_1.getSessionManager)();
+    if (!tabId) {
+        return {
+            content: [{ type: 'text', text: 'Error: tabId is required' }],
+            isError: true,
+        };
+    }
+    if (!code) {
+        return {
+            content: [{ type: 'text', text: 'Error: code is required (JS code to execute)' }],
+            isError: true,
+        };
+    }
+    if (!code) {
+        return {
+            content: [{ type: 'text', text: 'Error: text (JavaScript code) is required' }],
+            isError: true,
+        };
+    }
+    try {
+        const page = await sessionManager.getPage(sessionId, tabId, undefined, 'javascript_tool');
+        if (!page) {
+            return {
+                content: [{ type: 'text', text: `Error: Tab ${tabId} not found. Hint: The tab may have been closed or the session expired. Use navigate() to open a new tab.` }],
+                isError: true,
+            };
+        }
+        // Domain blocklist check
+        (0, domain_guard_1.assertDomainAllowed)(page.url());
+        const cdpClient = sessionManager.getCDPClient();
+        let jsTid;
+        const cdpResult = await Promise.race([
+            cdpClient
+                .send(page, 'Runtime.evaluate', {
+                expression: wrapInIIFE(code),
+                returnByValue: true,
+                awaitPromise: true,
+                userGesture: true,
+                replMode: true,
+            })
+                .finally(() => clearTimeout(jsTid)),
+            new Promise((_, reject) => {
+                jsTid = setTimeout(() => reject(new Error(`JS execution timed out after ${timeout}ms`)), timeout);
+            }),
+        ]);
+        if (cdpResult.exceptionDetails) {
+            const errorMsg = cdpResult.exceptionDetails.exception?.description ||
+                cdpResult.exceptionDetails.text ||
+                'Unknown error';
+            return {
+                content: [{ type: 'text', text: `JavaScript error: ${errorMsg}` }],
+                isError: true,
+            };
+        }
+        const output = formatCDPResult(cdpResult.result);
+        return {
+            content: [{ type: 'text', text: output }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `JavaScript execution error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+};
+function registerJavascriptTool(server) {
+    server.registerTool('javascript_tool', handler, definition);
+}
+//# sourceMappingURL=javascript.js.map

package/dist/tools/javascript.js.map

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

package/dist/tools/lightweight-scroll.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Lightweight Scroll Tool - JavaScript-based scrolling without screenshots
+ *
+ * Eliminates the CDP screenshot serialization bottleneck that caused
+ * 185-second timeouts under high concurrency (20+ tabs).
+ *
+ * Performance impact: Scroll from 185s (timeout) to <5ms per call
+ */
+import { MCPServer } from '../mcp-server';
+export declare function registerLightweightScrollTool(server: MCPServer): void;
+//# sourceMappingURL=lightweight-scroll.d.ts.map

package/dist/tools/lightweight-scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightweight-scroll.d.ts","sourceRoot":"","sources":["../../src/tools/lightweight-scroll.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AA2V1C,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAErE"}