@godscene/core 1.7.11

package/dist/es/device/index.mjs

@@ -0,0 +1,340 @@
+import { getMidsceneLocationSchema } from "../common.mjs";
+import { getDebug } from "@godscene/shared/logger";
+import { z } from "zod";
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class AbstractInterface {
+    constructor(){
+        _define_property(this, "mjpegStreamUrl", void 0);
+    }
+}
+const defineAction = (config)=>config;
+const actionTapParamSchema = z.object({
+    locate: getMidsceneLocationSchema().describe('The element to be tapped')
+});
+const defineActionTap = (call)=>defineAction({
+        name: 'Tap',
+        description: 'Tap the element',
+        interfaceAlias: 'aiTap',
+        paramSchema: actionTapParamSchema,
+        sample: {
+            locate: {
+                prompt: 'the "Submit" button'
+            }
+        },
+        call
+    });
+const actionRightClickParamSchema = z.object({
+    locate: getMidsceneLocationSchema().describe('The element to be right clicked')
+});
+const defineActionRightClick = (call)=>defineAction({
+        name: 'RightClick',
+        description: 'Right click the element',
+        interfaceAlias: 'aiRightClick',
+        paramSchema: actionRightClickParamSchema,
+        sample: {
+            locate: {
+                prompt: 'the file icon on the desktop'
+            }
+        },
+        call
+    });
+const actionDoubleClickParamSchema = z.object({
+    locate: getMidsceneLocationSchema().describe('The element to be double clicked')
+});
+const defineActionDoubleClick = (call)=>defineAction({
+        name: 'DoubleClick',
+        description: 'Double click the element',
+        interfaceAlias: 'aiDoubleClick',
+        paramSchema: actionDoubleClickParamSchema,
+        sample: {
+            locate: {
+                prompt: 'the folder icon'
+            }
+        },
+        call
+    });
+const actionHoverParamSchema = z.object({
+    locate: getMidsceneLocationSchema().describe('The element to be hovered')
+});
+const defineActionHover = (call)=>defineAction({
+        name: 'Hover',
+        description: 'Move the mouse to the element',
+        interfaceAlias: 'aiHover',
+        paramSchema: actionHoverParamSchema,
+        sample: {
+            locate: {
+                prompt: 'the navigation menu item "Products"'
+            }
+        },
+        call
+    });
+const inputLocateDescription = 'the position of the placeholder or text content in the target input field. If there is no content, locate the center of the input field.';
+const actionInputParamSchema = z.object({
+    value: z.union([
+        z.string(),
+        z.number()
+    ]).transform((val)=>String(val)).describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
+    locate: getMidsceneLocationSchema().describe(inputLocateDescription).optional(),
+    mode: z["enum"]([
+        'replace',
+        'clear',
+        'typeOnly'
+    ]).default('replace').describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - clear the field without inputting new text.')
+});
+const defineActionInput = (call)=>defineAction({
+        name: 'Input',
+        description: 'Input the value into the element',
+        interfaceAlias: 'aiInput',
+        paramSchema: actionInputParamSchema,
+        sample: {
+            value: 'test@example.com',
+            locate: {
+                prompt: 'the email input field'
+            }
+        },
+        call: (param)=>{
+            if ('append' === param.mode) param.mode = 'typeOnly';
+            return call(param);
+        }
+    });
+const actionKeyboardPressParamSchema = z.object({
+    locate: getMidsceneLocationSchema().describe('The element to be clicked before pressing the key').optional(),
+    keyName: z.string().describe("The key to be pressed. Use '+' for key combinations, e.g., 'Control+A', 'Shift+Enter'")
+});
+const defineActionKeyboardPress = (call)=>defineAction({
+        name: 'KeyboardPress',
+        description: 'Press a key or key combination, like "Enter", "Tab", "Escape", or "Control+A", "Shift+Enter". Do not use this to type text.',
+        interfaceAlias: 'aiKeyboardPress',
+        paramSchema: actionKeyboardPressParamSchema,
+        sample: {
+            keyName: 'Enter'
+        },
+        call
+    });
+const actionScrollParamSchema = z.object({
+    scrollType: z["enum"]([
+        'singleAction',
+        'scrollToBottom',
+        'scrollToTop',
+        'scrollToRight',
+        'scrollToLeft'
+    ]).default('singleAction').describe('The scroll behavior: "singleAction" for a single scroll action, "scrollToBottom" for scrolling all the way to the bottom by rapidly scrolling 5-10 times (skipping intermediate content until reaching the bottom), "scrollToTop" for scrolling all the way to the top by rapidly scrolling 5-10 times (skipping intermediate content until reaching the top), "scrollToRight" for scrolling all the way to the right by rapidly scrolling multiple times, "scrollToLeft" for scrolling all the way to the left by rapidly scrolling multiple times'),
+    direction: z["enum"]([
+        'down',
+        'up',
+        'right',
+        'left'
+    ]).default('down').describe('The direction to scroll. Only effective when scrollType is "singleAction".'),
+    distance: z.number().nullable().optional().describe('The distance in pixels to scroll'),
+    locate: getMidsceneLocationSchema().optional().describe('Describe the target element to be scrolled on, like "the table" or "the list" or "the content area" or "the scrollable area". Do NOT provide a general intent like "scroll to find some element"')
+});
+const defineActionScroll = (call)=>defineAction({
+        name: 'Scroll',
+        description: 'Scroll the page or a scrollable element to browse content. This is the preferred way to scroll on all platforms, including mobile. Supports scrollToBottom/scrollToTop for boundary navigation. Default: direction `down`, scrollType `singleAction`, distance `null`.',
+        interfaceAlias: 'aiScroll',
+        paramSchema: actionScrollParamSchema,
+        sample: {
+            direction: 'down',
+            scrollType: 'singleAction',
+            locate: {
+                prompt: 'the center of the product list area'
+            }
+        },
+        call
+    });
+const actionDragAndDropParamSchema = z.object({
+    from: getMidsceneLocationSchema().describe('The position to be dragged'),
+    to: getMidsceneLocationSchema().describe('The position to be dropped')
+});
+const defineActionDragAndDrop = (call)=>defineAction({
+        name: 'DragAndDrop',
+        description: 'Pick up a specific UI element and move it to a new position (e.g., reorder a card, move a file into a folder, sort list items). The element itself moves with your finger/mouse.',
+        interfaceAlias: 'aiDragAndDrop',
+        paramSchema: actionDragAndDropParamSchema,
+        sample: {
+            from: {
+                prompt: 'the "report.pdf" file icon'
+            },
+            to: {
+                prompt: 'the upload drop zone'
+            }
+        },
+        call
+    });
+const ActionLongPressParamSchema = z.object({
+    locate: getMidsceneLocationSchema().describe('The element to be long pressed'),
+    duration: z.number().optional().describe('Long press duration in milliseconds')
+});
+const defineActionLongPress = (call)=>defineAction({
+        name: 'LongPress',
+        description: 'Long press the element',
+        interfaceAlias: 'aiLongPress',
+        paramSchema: ActionLongPressParamSchema,
+        sample: {
+            locate: {
+                prompt: 'the message bubble'
+            }
+        },
+        call
+    });
+const ActionSwipeParamSchema = z.object({
+    start: getMidsceneLocationSchema().optional().describe('Starting point of the swipe gesture, if not specified, the center of the page will be used'),
+    direction: z["enum"]([
+        'up',
+        'down',
+        'left',
+        'right'
+    ]).optional().describe('The direction to swipe (required when using distance). The direction means the direction of the finger swipe.'),
+    distance: z.number().optional().describe('The distance in pixels to swipe (mutually exclusive with end)'),
+    end: getMidsceneLocationSchema().optional().describe('Ending point of the swipe gesture (mutually exclusive with distance)'),
+    duration: z.number().default(300).describe('Duration of the swipe gesture in milliseconds'),
+    repeat: z.number().optional().describe('The number of times to repeat the swipe gesture. 1 for default, 0 for infinite (e.g. endless swipe until the end of the page)')
+});
+function normalizeMobileSwipeParam(param, screenSize) {
+    const { width, height } = screenSize;
+    const { start, end } = param;
+    const startPoint = start ? {
+        x: start.center[0],
+        y: start.center[1]
+    } : {
+        x: width / 2,
+        y: height / 2
+    };
+    let endPoint;
+    if (end) endPoint = {
+        x: end.center[0],
+        y: end.center[1]
+    };
+    else if (param.distance) {
+        const direction = param.direction;
+        if (!direction) throw new Error('direction is required for swipe gesture');
+        endPoint = {
+            x: startPoint.x + ('right' === direction ? param.distance : 'left' === direction ? -param.distance : 0),
+            y: startPoint.y + ('down' === direction ? param.distance : 'up' === direction ? -param.distance : 0)
+        };
+    } else throw new Error('Either end or distance must be specified for swipe gesture');
+    endPoint.x = Math.max(0, Math.min(endPoint.x, width));
+    endPoint.y = Math.max(0, Math.min(endPoint.y, height));
+    const duration = param.duration ?? 300;
+    let repeatCount = 'number' == typeof param.repeat ? param.repeat : 1;
+    if (0 === repeatCount) repeatCount = 10;
+    return {
+        startPoint,
+        endPoint,
+        duration,
+        repeatCount
+    };
+}
+const defineActionSwipe = (call)=>defineAction({
+        name: 'Swipe',
+        description: 'Perform a touch gesture for interactions beyond regular scrolling (e.g., flip pages in a carousel, dismiss a notification, swipe-to-delete a list item). For regular content scrolling, use Scroll instead. Use "distance" + "direction" for relative movement, or "end" for precise endpoint.',
+        paramSchema: ActionSwipeParamSchema,
+        sample: {
+            start: {
+                prompt: 'center of the notification'
+            },
+            end: {
+                prompt: 'upper edge of the screen'
+            }
+        },
+        call
+    });
+const actionClearInputParamSchema = z.object({
+    locate: getMidsceneLocationSchema().describe('The input field to be cleared').optional()
+});
+const defineActionClearInput = (call)=>defineAction({
+        name: 'ClearInput',
+        description: inputLocateDescription,
+        interfaceAlias: 'aiClearInput',
+        paramSchema: actionClearInputParamSchema,
+        sample: {
+            locate: {
+                prompt: 'the search input field'
+            }
+        },
+        call
+    });
+const actionCursorMoveParamSchema = z.object({
+    direction: z["enum"]([
+        'left',
+        'right'
+    ]).describe('The direction to move the cursor'),
+    times: z.number().int().min(1).default(1).describe('The number of times to move the cursor in the specified direction')
+});
+const defineActionCursorMove = (call)=>defineAction({
+        name: 'CursorMove',
+        description: 'Move the text cursor (caret) left or right within an input field or text area. Use this to reposition the cursor without selecting text.',
+        paramSchema: actionCursorMoveParamSchema,
+        sample: {
+            direction: 'left',
+            times: 3
+        },
+        call
+    });
+const ActionPinchParamSchema = z.object({
+    locate: getMidsceneLocationSchema().optional().describe('The element to pinch on. If not specified, the center of the screen will be used'),
+    direction: z["enum"]([
+        'in',
+        'out'
+    ]).describe('Pinch direction. "in" = pinch fingers together (zoom out / shrink), "out" = spread fingers apart (zoom in / enlarge).'),
+    distance: z.number().positive().optional().describe('How far each finger moves in pixels. Defaults to a quarter of the shorter screen dimension.'),
+    duration: z.number().default(500).optional().describe('Duration of the pinch gesture in milliseconds')
+});
+const defineActionPinch = (call)=>defineAction({
+        name: 'Pinch',
+        description: 'Perform a two-finger pinch gesture. Use direction "in" to pinch fingers together (zoom out), or "out" to spread fingers apart (zoom in). Optionally specify distance for how far each finger moves.',
+        interfaceAlias: 'aiPinch',
+        paramSchema: ActionPinchParamSchema,
+        sample: {
+            locate: {
+                prompt: 'the map area'
+            },
+            direction: 'out',
+            distance: 200
+        },
+        call
+    });
+function normalizePinchParam(param, screenSize) {
+    const { width, height } = screenSize;
+    const element = param.locate;
+    const centerX = element ? Math.round(element.center[0]) : Math.round(width / 2);
+    const centerY = element ? Math.round(element.center[1]) : Math.round(height / 2);
+    const duration = param.duration ?? 500;
+    const baseDistance = Math.round(Math.min(width, height) / 4);
+    const fingerDistance = param.distance ?? baseDistance;
+    const startDistance = baseDistance;
+    const endDistance = 'out' === param.direction ? baseDistance + fingerDistance : Math.max(10, baseDistance - fingerDistance);
+    return {
+        centerX,
+        centerY,
+        startDistance,
+        endDistance,
+        duration
+    };
+}
+const ActionSleepParamSchema = z.object({
+    timeMs: z.number().default(1000).optional().describe('Sleep duration in milliseconds, defaults to 1000ms (1 second)')
+});
+const defineActionSleep = ()=>defineAction({
+        name: 'Sleep',
+        description: 'Wait for a specified duration before continuing. Defaults to 1 second (1000ms) if not specified.',
+        paramSchema: ActionSleepParamSchema,
+        sample: {
+            timeMs: 2000
+        },
+        call: async (param)=>{
+            const duration = param?.timeMs ?? 1000;
+            getDebug('device:common-action')(`Sleeping for ${duration}ms`);
+            await new Promise((resolve)=>setTimeout(resolve, duration));
+        }
+    });
+export { AbstractInterface, ActionLongPressParamSchema, ActionPinchParamSchema, ActionSleepParamSchema, ActionSwipeParamSchema, actionClearInputParamSchema, actionCursorMoveParamSchema, actionDoubleClickParamSchema, actionDragAndDropParamSchema, actionHoverParamSchema, actionInputParamSchema, actionKeyboardPressParamSchema, actionRightClickParamSchema, actionScrollParamSchema, actionTapParamSchema, defineAction, defineActionClearInput, defineActionCursorMove, defineActionDoubleClick, defineActionDragAndDrop, defineActionHover, defineActionInput, defineActionKeyboardPress, defineActionLongPress, defineActionPinch, defineActionRightClick, defineActionScroll, defineActionSleep, defineActionSwipe, defineActionTap, normalizeMobileSwipeParam, normalizePinchParam };

package/dist/es/dump/html-utils.mjs

@@ -0,0 +1,290 @@
+import * as __rspack_external_node_fs_5ea92f0c from "node:fs";
+import { antiEscapeScriptTag, escapeScriptTag } from "@godscene/shared/utils";
+var __webpack_modules__ = {
+    "node:fs" (module) {
+        module.exports = __rspack_external_node_fs_5ea92f0c;
+    }
+};
+var __webpack_module_cache__ = {};
+function __webpack_require__(moduleId) {
+    var cachedModule = __webpack_module_cache__[moduleId];
+    if (void 0 !== cachedModule) return cachedModule.exports;
+    var module = __webpack_module_cache__[moduleId] = {
+        exports: {}
+    };
+    __webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+    return module.exports;
+}
+var external_node_fs_ = __webpack_require__("node:fs");
+const escapeContent = escapeScriptTag;
+const unescapeContent = antiEscapeScriptTag;
+const STREAMING_CHUNK_SIZE = 65536;
+function streamScanTags(filePath, openTag, closeTag, onMatch) {
+    const fd = (0, external_node_fs_.openSync)(filePath, 'r');
+    const fileSize = (0, external_node_fs_.statSync)(filePath).size;
+    const buffer = Buffer.alloc(STREAMING_CHUNK_SIZE);
+    let position = 0;
+    let leftover = '';
+    let capturing = false;
+    let currentContent = '';
+    try {
+        while(position < fileSize){
+            const bytesRead = (0, external_node_fs_.readSync)(fd, buffer, 0, STREAMING_CHUNK_SIZE, position);
+            const chunk = leftover + buffer.toString('utf-8', 0, bytesRead);
+            position += bytesRead;
+            let searchStart = 0;
+            while(searchStart < chunk.length)if (capturing) {
+                const endIdx = chunk.indexOf(closeTag, searchStart);
+                if (-1 !== endIdx) {
+                    currentContent += chunk.slice(searchStart, endIdx);
+                    const shouldStop = onMatch(currentContent);
+                    if (shouldStop) return;
+                    capturing = false;
+                    currentContent = '';
+                    searchStart = endIdx + closeTag.length;
+                } else {
+                    currentContent += chunk.slice(searchStart, -closeTag.length);
+                    leftover = chunk.slice(-closeTag.length);
+                    break;
+                }
+            } else {
+                const startIdx = chunk.indexOf(openTag, searchStart);
+                if (-1 !== startIdx) {
+                    capturing = true;
+                    currentContent = chunk.slice(startIdx + openTag.length);
+                    const endIdx = currentContent.indexOf(closeTag);
+                    if (-1 !== endIdx) {
+                        const shouldStop = onMatch(currentContent.slice(0, endIdx));
+                        if (shouldStop) return;
+                        capturing = false;
+                        currentContent = '';
+                        searchStart = startIdx + openTag.length + endIdx + closeTag.length;
+                    } else {
+                        leftover = currentContent.slice(-closeTag.length);
+                        currentContent = currentContent.slice(0, -closeTag.length);
+                        break;
+                    }
+                } else {
+                    leftover = chunk.slice(-openTag.length);
+                    break;
+                }
+            }
+        }
+    } finally{
+        (0, external_node_fs_.closeSync)(fd);
+    }
+}
+function extractImageByIdSync(htmlPath, imageId) {
+    const targetTag = `<script type="midscene-image" data-id="${imageId}">`;
+    const closeTag = "<\/script>";
+    let result = null;
+    streamScanTags(htmlPath, targetTag, closeTag, (content)=>{
+        result = unescapeContent(content);
+        return true;
+    });
+    return result;
+}
+function streamImageScriptsToFile(srcFilePath, destFilePath) {
+    const { appendFileSync } = __webpack_require__("node:fs");
+    const openTag = '<script type="midscene-image"';
+    const closeTag = "<\/script>";
+    streamScanTags(srcFilePath, openTag, closeTag, (content)=>{
+        appendFileSync(destFilePath, `${openTag}${content}${closeTag}\n`);
+        return false;
+    });
+}
+function extractLastDumpScriptSync(filePath) {
+    const openTagPrefix = '<script type="midscene_web_dump"';
+    const closeTag = "<\/script>";
+    let lastContent = '';
+    const fd = (0, external_node_fs_.openSync)(filePath, 'r');
+    const fileSize = (0, external_node_fs_.statSync)(filePath).size;
+    const buffer = Buffer.alloc(STREAMING_CHUNK_SIZE);
+    let position = 0;
+    let leftover = '';
+    let capturing = false;
+    let currentContent = '';
+    try {
+        while(position < fileSize){
+            const bytesRead = (0, external_node_fs_.readSync)(fd, buffer, 0, STREAMING_CHUNK_SIZE, position);
+            const chunk = leftover + buffer.toString('utf-8', 0, bytesRead);
+            position += bytesRead;
+            let searchStart = 0;
+            while(searchStart < chunk.length)if (capturing) {
+                const endIdx = chunk.indexOf(closeTag, searchStart);
+                if (-1 !== endIdx) {
+                    currentContent += chunk.slice(searchStart, endIdx);
+                    lastContent = currentContent.trim();
+                    capturing = false;
+                    currentContent = '';
+                    searchStart = endIdx + closeTag.length;
+                } else {
+                    currentContent += chunk.slice(searchStart, -closeTag.length);
+                    leftover = chunk.slice(-closeTag.length);
+                    break;
+                }
+            } else {
+                const startIdx = chunk.indexOf(openTagPrefix, searchStart);
+                if (-1 !== startIdx) {
+                    const tagEndIdx = chunk.indexOf('>', startIdx);
+                    if (-1 !== tagEndIdx) {
+                        capturing = true;
+                        currentContent = chunk.slice(tagEndIdx + 1);
+                        const endIdx = currentContent.indexOf(closeTag);
+                        if (-1 !== endIdx) {
+                            lastContent = currentContent.slice(0, endIdx).trim();
+                            capturing = false;
+                            currentContent = '';
+                            searchStart = tagEndIdx + 1 + endIdx + closeTag.length;
+                        } else {
+                            leftover = currentContent.slice(-closeTag.length);
+                            currentContent = currentContent.slice(0, -closeTag.length);
+                            break;
+                        }
+                    } else {
+                        leftover = chunk.slice(startIdx);
+                        break;
+                    }
+                } else {
+                    leftover = chunk.slice(-openTagPrefix.length);
+                    break;
+                }
+            }
+        }
+    } finally{
+        (0, external_node_fs_.closeSync)(fd);
+    }
+    return lastContent;
+}
+function extractAllDumpScriptsSync(filePath) {
+    const results = [];
+    streamDumpScriptsSync(filePath, (dumpScript)=>{
+        results.push(dumpScript);
+        return false;
+    });
+    return results;
+}
+function streamDumpScriptsSync(filePath, onMatch) {
+    const openTagPrefix = '<script type="midscene_web_dump"';
+    const closeTag = "<\/script>";
+    const fd = (0, external_node_fs_.openSync)(filePath, 'r');
+    const fileSize = (0, external_node_fs_.statSync)(filePath).size;
+    const buffer = Buffer.alloc(STREAMING_CHUNK_SIZE);
+    let position = 0;
+    let leftover = '';
+    let capturing = false;
+    let currentContent = '';
+    let currentOpenTag = '';
+    try {
+        while(position < fileSize){
+            const bytesRead = (0, external_node_fs_.readSync)(fd, buffer, 0, STREAMING_CHUNK_SIZE, position);
+            const chunk = leftover + buffer.toString('utf-8', 0, bytesRead);
+            position += bytesRead;
+            let searchStart = 0;
+            while(searchStart < chunk.length)if (capturing) {
+                const endIdx = chunk.indexOf(closeTag, searchStart);
+                if (-1 !== endIdx) {
+                    currentContent += chunk.slice(searchStart, endIdx);
+                    const shouldStop = onMatch({
+                        openTag: currentOpenTag,
+                        content: currentContent.trim()
+                    });
+                    if (shouldStop) return;
+                    capturing = false;
+                    currentContent = '';
+                    currentOpenTag = '';
+                    searchStart = endIdx + closeTag.length;
+                } else {
+                    currentContent += chunk.slice(searchStart, -closeTag.length);
+                    leftover = chunk.slice(-closeTag.length);
+                    break;
+                }
+            } else {
+                const startIdx = chunk.indexOf(openTagPrefix, searchStart);
+                if (-1 !== startIdx) {
+                    const tagEndIdx = chunk.indexOf('>', startIdx);
+                    if (-1 !== tagEndIdx) {
+                        capturing = true;
+                        currentOpenTag = chunk.slice(startIdx, tagEndIdx + 1);
+                        currentContent = chunk.slice(tagEndIdx + 1);
+                        const endIdx = currentContent.indexOf(closeTag);
+                        if (-1 !== endIdx) {
+                            const shouldStop = onMatch({
+                                openTag: currentOpenTag,
+                                content: currentContent.slice(0, endIdx).trim()
+                            });
+                            if (shouldStop) return;
+                            capturing = false;
+                            currentContent = '';
+                            currentOpenTag = '';
+                            searchStart = tagEndIdx + 1 + endIdx + closeTag.length;
+                        } else {
+                            leftover = currentContent.slice(-closeTag.length);
+                            currentContent = currentContent.slice(0, -closeTag.length);
+                            break;
+                        }
+                    } else {
+                        leftover = chunk.slice(startIdx);
+                        break;
+                    }
+                } else {
+                    leftover = chunk.slice(-openTagPrefix.length);
+                    break;
+                }
+            }
+        }
+    } finally{
+        (0, external_node_fs_.closeSync)(fd);
+    }
+}
+function parseImageScripts(html) {
+    const imageMap = {};
+    const regex = /<script type="midscene-image" data-id="([^"]+)">([\s\S]*?)<\/script>/g;
+    for (const match of html.matchAll(regex)){
+        const [, id, content] = match;
+        imageMap[id] = unescapeContent(content);
+    }
+    return imageMap;
+}
+function parseDumpScript(html) {
+    const scriptOpenTag = '<script type="midscene_web_dump"';
+    const scriptCloseTag = "<\/script>";
+    const lastOpenIndex = html.lastIndexOf(scriptOpenTag);
+    if (-1 === lastOpenIndex) throw new Error("No dump script found in HTML");
+    const tagEndIndex = html.indexOf('>', lastOpenIndex);
+    if (-1 === tagEndIndex) throw new Error("No dump script found in HTML");
+    const closeIndex = html.indexOf(scriptCloseTag, tagEndIndex);
+    if (-1 === closeIndex) throw new Error("No dump script found in HTML");
+    const content = html.substring(tagEndIndex + 1, closeIndex);
+    return unescapeContent(content);
+}
+function parseDumpScriptAttributes(html) {
+    const regex = /<script type="midscene_web_dump"([^>]*)>/;
+    const match = regex.exec(html);
+    if (!match) return {};
+    const attrString = match[1];
+    const attributes = {};
+    const attrRegex = /(\w+)="([^"]*)"/g;
+    for (const attrMatch of attrString.matchAll(attrRegex)){
+        const [, key, value] = attrMatch;
+        if ('type' !== key) attributes[key] = decodeURIComponent(value);
+    }
+    return attributes;
+}
+function generateImageScriptTag(id, data) {
+    return '<script type="midscene-image" data-id="' + id + '">' + escapeContent(data) + "<\/script>";
+}
+let _baseUrlFixScript;
+function getBaseUrlFixScript() {
+    if (!_baseUrlFixScript) {
+        const close = "<\/script>";
+        _baseUrlFixScript = '\n<script>(function(){var p=window.location.pathname;if(p.endsWith("/")||/\\.\\w+$/.test(p))return;var b=document.createElement("base");b.href=p+"/";document.head.insertBefore(b,document.head.firstChild)})()' + close + '\n';
+    }
+    return _baseUrlFixScript;
+}
+function generateDumpScriptTag(json, attributes) {
+    let attrString = '';
+    if (attributes && Object.keys(attributes).length > 0) attrString = ' ' + Object.entries(attributes).map(([k, v])=>k + '="' + encodeURIComponent(v) + '"').join(' ');
+    return '<script type="midscene_web_dump"' + attrString + '>' + escapeContent(json) + "<\/script>";
+}
+export { STREAMING_CHUNK_SIZE, escapeContent, extractAllDumpScriptsSync, extractImageByIdSync, extractLastDumpScriptSync, generateDumpScriptTag, generateImageScriptTag, getBaseUrlFixScript, parseDumpScript, parseDumpScriptAttributes, parseImageScripts, streamDumpScriptsSync, streamImageScriptsToFile, streamScanTags, unescapeContent };

package/dist/es/dump/index.mjs

@@ -0,0 +1,3 @@
+import { restoreImageReferences } from "./screenshot-restoration.mjs";
+import { escapeContent, generateDumpScriptTag, generateImageScriptTag, parseDumpScript, parseDumpScriptAttributes, parseImageScripts, unescapeContent } from "./html-utils.mjs";
+export { escapeContent, generateDumpScriptTag, generateImageScriptTag, parseDumpScript, parseDumpScriptAttributes, parseImageScripts, restoreImageReferences, unescapeContent };

package/dist/es/dump/screenshot-restoration.mjs

@@ -0,0 +1,30 @@
+import { normalizeScreenshotRef } from "./screenshot-store.mjs";
+function restoreImageReferences(data, resolveImage) {
+    if ('string' == typeof data) return data;
+    if (Array.isArray(data)) return data.map((item)=>restoreImageReferences(item, resolveImage));
+    if ('object' == typeof data && null !== data) {
+        const refLike = normalizeScreenshotRef(data);
+        if (refLike) {
+            let resolved = null;
+            const lazy = Object.defineProperties({}, {
+                base64: {
+                    get () {
+                        if (null === resolved) resolved = resolveImage(refLike);
+                        return resolved;
+                    },
+                    enumerable: true
+                },
+                capturedAt: {
+                    value: refLike.capturedAt,
+                    enumerable: true
+                }
+            });
+            return lazy;
+        }
+        const result = {};
+        for (const [key, value] of Object.entries(data))result[key] = restoreImageReferences(value, resolveImage);
+        return result;
+    }
+    return data;
+}
+export { restoreImageReferences };