@adep/vite-plugin 0.1.5 → 0.1.6

package/dist/ide-proxy.d.ts

@@ -56,3 +56,16 @@ export declare function createAdepFnProxyScriptMiddleware(): (req: IncomingMessa
  * Web IDE 预览路径用（CLI 模式下脚本自检 window.parent === window 不激活，无害）。
  */
 export declare function injectFnProxyScriptTag(html: string): string;
+/**
+ * 构造中间件：serve `/@adep/automation.js`（返回自动化中继脚本）。
+ * 与 `createAdepFnProxyScriptMiddleware` 同构——Nodebox 路径凭 3 个静态 URL 注入，
+ * 不往沙箱里塞业务代码（注入插件只写 `<script src>`，见 `ide-nodebox-preview.ts`）。
+ */
+export declare function createAdepAutomationScriptMiddleware(): (req: IncomingMessage, res: ServerResponse, next: () => void) => void;
+/**
+ * 把自动化中继 script 标签注入 index.html 的 </head> 前（幂等）。
+ *
+ * 注入位置排在三段脚本的最后：中继脚本会再包一层 `console.*`（记环形缓冲），
+ * 排在控制台中继之后才能既进它的缓冲、又经它转发到 IDE「控制台」页签。
+ */
+export declare function injectAutomationScriptTag(html: string): string;

package/dist/index.d.ts

@@ -17,4 +17,5 @@ export { adepPlugin, default } from './dev-server';
 export type { AdepConfigLoader, AdepDevServerFactory, AdepDevServerHandle, AdepVitePlugin, AdepVitePluginOptions, AdepViteServer, } from './dev-server';
 export { normalizeFunctionPrefix } from './prefix';
 export { createAdepProxyMiddleware, isAddrInUse } from './proxy';
-export { createAdepFnProxyScriptMiddleware, FN_FETCH_INTERCEPTOR_SCRIPT, injectFnProxyScriptTag, } from './ide-proxy';
+export { createAdepAutomationScriptMiddleware, createAdepFnProxyScriptMiddleware, FN_FETCH_INTERCEPTOR_SCRIPT, injectAutomationScriptTag, injectFnProxyScriptTag, } from './ide-proxy';
+export { PREVIEW_AUTOMATION_SCRIPT } from './preview-automation';

package/dist/index.js

@@ -48,6 +48,477 @@ function createAdepProxyMiddleware(prefix, targetBase) {
   };
 }
 
+// packages/vite-plugin/src/preview-automation.ts
+var PREVIEW_AUTOMATION_SCRIPT = `(function () {
+  if (window.__adepAutomationInstalled) return;
+  window.__adepAutomationInstalled = true;
+
+  var CONSOLE_LIMIT = 200;
+  var DEFAULT_TIMEOUT_MS = 8000;
+  var MAX_TEXT_CHARS = 12000;
+  var MAX_HTML_CHARS = 20000;
+  var DEFAULT_INSPECT_SELECTOR = "a,button,input,select,textarea,img,h1,h2,h3,h4,label,[role],[data-testid]";
+  var consoleLog = [];
+  var consoleSeq = 0;
+
+  function fail(code, message) {
+    var error = new Error(message);
+    error.code = code;
+    return error;
+  }
+
+  function asNumber(value, fallback) {
+    return typeof value === "number" && isFinite(value) ? value : fallback;
+  }
+
+  function asString(value, fallback) {
+    return typeof value === "string" ? value : fallback;
+  }
+
+  function truncate(value, max) {
+    var text = value == null ? "" : String(value);
+    var limit = typeof max === "number" && isFinite(max) && max > 0 ? Math.floor(max) : 0;
+    if (limit === 0 || text.length <= limit) return text;
+    return text.slice(0, limit) + "...[truncated, total " + text.length + " chars]";
+  }
+
+  /* ---- console / error ring buffer ---- */
+  function record(level, text) {
+    consoleSeq += 1;
+    consoleLog.push({ seq: consoleSeq, level: level, text: truncate(text, 2000), at: Date.now() });
+    if (consoleLog.length > CONSOLE_LIMIT) consoleLog.splice(0, consoleLog.length - CONSOLE_LIMIT);
+  }
+
+  function fmt(value) {
+    try {
+      if (typeof value === "string") return value;
+      if (value === undefined) return "undefined";
+      if (value instanceof Error) return value.stack || (value.name + ": " + value.message);
+      var seen = [];
+      var json = JSON.stringify(value, function (key, val) {
+        if (val instanceof Error) return val.stack || (val.name + ": " + val.message);
+        if (typeof val === "function") return "[Function " + (val.name || "anonymous") + "]";
+        if (typeof val === "bigint") return String(val) + "n";
+        if (val && typeof val === "object") {
+          if (seen.indexOf(val) !== -1) return "[Circular]";
+          seen.push(val);
+        }
+        return val;
+      });
+      return json === undefined ? String(value) : json;
+    } catch (e) {
+      return String(value);
+    }
+  }
+
+  var LEVELS = { log: "log", info: "info", warn: "warn", error: "error", debug: "log" };
+  Object.keys(LEVELS).forEach(function (name) {
+    var native = console[name];
+    console[name] = function () {
+      try { record(LEVELS[name], Array.prototype.map.call(arguments, fmt).join(" ")); } catch (e) {}
+      native.apply(console, arguments);
+    };
+  });
+  window.addEventListener('error', function (event) {
+    var text = event.message || "Script error";
+    if (event.filename) text += " (" + event.filename + ":" + event.lineno + ":" + event.colno + ")";
+    record("error", text);
+  });
+  window.addEventListener('unhandledrejection', function (event) {
+    var reason = event.reason;
+    record("error", reason && reason.stack ? String(reason.stack) : "Unhandled rejection: " + fmt(reason));
+  });
+
+  /* ---- DOM read ---- */
+  function query(selector, nth) {
+    var list = document.querySelectorAll(selector);
+    if (list.length === 0) throw fail("ELEMENT_NOT_FOUND", "selector matched nothing: " + selector);
+    var index = asNumber(nth, 0);
+    var el = list[index];
+    if (!el) throw fail("ELEMENT_NOT_FOUND", "selector matched " + list.length + " elements; index " + index + " is out of range");
+    return el;
+  }
+
+  function isVisible(el) {
+    if (!el || !el.getBoundingClientRect) return false;
+    var rect = el.getBoundingClientRect();
+    if (rect.width <= 0 && rect.height <= 0) return false;
+    var style = window.getComputedStyle(el);
+    if (style.visibility === "hidden" || style.display === "none") return false;
+    if (Number(style.opacity) === 0) return false;
+    return true;
+  }
+
+  function rectOf(el) {
+    var rect = el.getBoundingClientRect();
+    return {
+      x: Math.round(rect.left + window.scrollX),
+      y: Math.round(rect.top + window.scrollY),
+      w: Math.round(rect.width),
+      h: Math.round(rect.height),
+    };
+  }
+
+  function describe(el, maxText) {
+    var tag = String(el.tagName || "").toLowerCase();
+    var text = "";
+    if (tag === "input" || tag === "textarea" || tag === "select") text = String(el.value || "");
+    else text = el.textContent || "";
+    var out = {
+      tag: tag,
+      testid: el.getAttribute ? el.getAttribute("data-testid") : null,
+      id: el.id || null,
+      cls: el.className && typeof el.className === "string" ? el.className : null,
+      role: el.getAttribute ? el.getAttribute("role") : null,
+      text: truncate(String(text).replace(/[\\s\\u00a0]+/g, " ").trim(), asNumber(maxText, 120)),
+      rect: rectOf(el),
+      visible: isVisible(el),
+    };
+    if (tag === "input" || tag === "textarea" || tag === "select") {
+      out.field = el.getAttribute("name") || el.getAttribute("placeholder") || null;
+      if (tag === "input") out.type = el.getAttribute("type") || "text";
+    }
+    if (tag === "a") out.href = el.getAttribute("href") || null;
+    if (el.disabled === true) out.disabled = true;
+    if (el.checked !== undefined && (tag === "input")) out.checked = el.checked === true;
+    return out;
+  }
+
+  /* ---- DOM write ---- */
+  function fireMouse(el, x, y, kind) {
+    var rect = el.getBoundingClientRect();
+    var clientX = typeof x === "number" ? x : rect.left + rect.width / 2;
+    var clientY = typeof y === "number" ? y : rect.top + rect.height / 2;
+    el.dispatchEvent(new MouseEvent(kind, {
+      bubbles: true, cancelable: true, composed: true, view: window,
+      clientX: clientX, clientY: clientY, button: 0,
+    }));
+  }
+
+  function clickElement(el, x, y) {
+    try { el.scrollIntoView({ block: "center", inline: "center" }); } catch (e) {}
+    fireMouse(el, x, y, "mousedown");
+    fireMouse(el, x, y, "mouseup");
+    fireMouse(el, x, y, "click");
+    return describe(el, 120);
+  }
+
+  function fireKey(el, key) {
+    var target = el || document.activeElement || document.body;
+    var init = { key: key, bubbles: true, cancelable: true, composed: true };
+    if (key === "Enter") { init.keyCode = 13; init.which = 13; }
+    if (key === "Escape") { init.keyCode = 27; init.which = 27; }
+    if (key === "Tab") { init.keyCode = 9; init.which = 9; }
+    var allowed = target.dispatchEvent(new KeyboardEvent("keydown", init));
+    if (allowed) target.dispatchEvent(new KeyboardEvent("keypress", init));
+    target.dispatchEvent(new KeyboardEvent("keyup", init));
+    return { key: key, target: describe(target, 80) };
+  }
+
+  function setNativeValue(el, value) {
+    var proto = null;
+    if (window.HTMLTextAreaElement && el instanceof window.HTMLTextAreaElement) proto = window.HTMLTextAreaElement.prototype;
+    else if (window.HTMLSelectElement && el instanceof window.HTMLSelectElement) proto = window.HTMLSelectElement.prototype;
+    else if (window.HTMLInputElement && el instanceof window.HTMLInputElement) proto = window.HTMLInputElement.prototype;
+    var descriptor = proto ? Object.getOwnPropertyDescriptor(proto, "value") : null;
+    if (descriptor && descriptor.set) descriptor.set.call(el, value);
+    else el.value = value;
+  }
+
+  function fireInput(el) {
+    el.dispatchEvent(new Event("input", { bubbles: true, composed: true }));
+    el.dispatchEvent(new Event("change", { bubbles: true, composed: true }));
+  }
+
+  function typeInto(el, value, clear, submit) {
+    try { el.focus(); } catch (e) {}
+    if (clear) {
+      setNativeValue(el, "");
+      fireInput(el);
+    }
+    setNativeValue(el, clear ? String(value) : String(el.value || "") + String(value));
+    fireInput(el);
+    if (submit) fireKey(el, "Enter");
+    return describe(el, 200);
+  }
+
+  function waitFor(selector, state, timeoutMs) {
+    var want = state === "hidden" || state === "detached" ? state : "visible";
+    var deadline = Date.now() + timeoutMs;
+    return new Promise(function (resolve, reject) {
+      function check() {
+        var el = document.querySelector(selector);
+        if (want === "detached" && el === null) return resolve({ state: want, selector: selector });
+        if (want === "hidden" && (el === null || !isVisible(el))) return resolve({ state: want, selector: selector });
+        if (want === "visible" && el !== null && isVisible(el)) return resolve(describe(el, 200));
+        if (Date.now() >= deadline) {
+          return reject(fail("WAIT_TIMEOUT", "waitFor " + want + " timed out after " + timeoutMs + "ms: " + selector));
+        }
+        setTimeout(check, 60);
+      }
+      check();
+    });
+  }
+
+  /* ---- screenshot (SVG foreignObject serialization, best effort) ---- */
+  function collectCss() {
+    var out = [];
+    var sheets = document.styleSheets;
+    for (var i = 0; i < sheets.length; i++) {
+      var rules = null;
+      try { rules = sheets[i].cssRules; } catch (e) { rules = null; }
+      if (!rules) continue;
+      for (var j = 0; j < rules.length; j++) out.push(rules[j].cssText);
+    }
+    return out.join("\\n");
+  }
+
+  function inlineImages(clone) {
+    var images = clone.querySelectorAll("img");
+    var jobs = [];
+    for (var i = 0; i < images.length; i++) {
+      (function (img) {
+        var src = img.getAttribute("src") || "";
+        if (src === "" || src.indexOf("data:") === 0) return;
+        jobs.push(window.fetch(src, { credentials: "omit" }).then(function (res) {
+          if (!res.ok) return null;
+          return res.blob().then(function (blob) {
+            return new Promise(function (resolve) {
+              var reader = new FileReader();
+              reader.onload = function () { img.setAttribute("src", String(reader.result)); resolve(null); };
+              reader.onerror = function () { resolve(null); };
+              reader.readAsDataURL(blob);
+            });
+          });
+        }).catch(function () { return null; }));
+      })(images[i]);
+    }
+    return Promise.all(jobs);
+  }
+
+  var QUOTE = String.fromCharCode(34);
+  function tag(name, pairs) {
+    var out = "<" + name;
+    for (var i = 0; i < pairs.length; i += 2) out += " " + pairs[i] + "=" + QUOTE + pairs[i + 1] + QUOTE;
+    return out + ">";
+  }
+
+  function screenshot(args) {
+    var scale = Math.min(asNumber(args.scale, 1), 2);
+    var maxHeight = asNumber(args.maxHeight, 2400);
+    var width = Math.max(1, document.documentElement.clientWidth || window.innerWidth || 1024);
+    var full = document.documentElement.scrollHeight || window.innerHeight || 768;
+    var height = Math.max(1, Math.min(full, maxHeight));
+    var clone = document.documentElement.cloneNode(true);
+    var scripts = clone.querySelectorAll("script");
+    for (var i = 0; i < scripts.length; i++) {
+      if (scripts[i].parentNode) scripts[i].parentNode.removeChild(scripts[i]);
+    }
+    clone.setAttribute("xmlns", "http://www.w3.org/1999/xhtml");
+    return inlineImages(clone).then(function () {
+      var style = document.createElement("style");
+      style.textContent = collectCss();
+      var head = clone.querySelector("head");
+      if (head) head.insertBefore(style, head.firstChild);
+      else clone.insertBefore(style, clone.firstChild);
+      var markup = new XMLSerializer().serializeToString(clone);
+      var svg = tag("svg", ["xmlns", "http://www.w3.org/2000/svg", "width", width, "height", height])
+        + tag("foreignObject", ["x", 0, "y", 0, "width", width, "height", height])
+        + markup + "</foreignObject></svg>";
+      var image = new Image();
+      return new Promise(function (resolve, reject) {
+        image.onload = function () {
+          var canvas = document.createElement("canvas");
+          canvas.width = Math.round(width * scale);
+          canvas.height = Math.round(height * scale);
+          var ctx = canvas.getContext("2d");
+          ctx.scale(scale, scale);
+          try { ctx.drawImage(image, 0, 0); } catch (e) {}
+          var dataUrl = null;
+          try { dataUrl = canvas.toDataURL("image/png"); }
+          catch (e2) {
+            reject(fail("SCREENSHOT_TAINTED", "canvas is tainted by a cross-origin resource that could not be inlined; fall back to snapshot / inspect"));
+            return;
+          }
+          resolve({ dataUrl: dataUrl, width: canvas.width, height: canvas.height, bytes: dataUrl.length, clipped: full > height });
+        };
+        image.onerror = function () {
+          reject(fail("SCREENSHOT_FAILED", "the browser refused to rasterize the serialized DOM"));
+        };
+        image.src = "data:image/svg+xml;charset=utf-8," + encodeURIComponent(svg);
+      });
+    });
+  }
+
+  /* ---- console read ---- */
+  function readConsole(args) {
+    var since = asNumber(args.since, 0);
+    var limit = asNumber(args.limit, 60);
+    var level = asString(args.level, "");
+    var out = [];
+    for (var i = 0; i < consoleLog.length; i++) {
+      var entry = consoleLog[i];
+      if (entry.seq <= since) continue;
+      if (level !== "" && entry.level !== level) continue;
+      out.push(entry);
+    }
+    var dropped = 0;
+    if (out.length > limit) {
+      dropped = out.length - limit;
+      out = out.slice(out.length - limit);
+    }
+    return { entries: out, cursor: consoleSeq, total: consoleLog.length, dropped: dropped };
+  }
+
+  function snapshot(args) {
+    var body = document.body;
+    var raw = body === null ? "" : body.innerText || body.textContent || "";
+    return {
+      ping: {
+        href: String(window.location.href),
+        title: String(document.title || ""),
+        readyState: String(document.readyState),
+        width: window.innerWidth,
+        height: window.innerHeight,
+        scrollHeight: document.documentElement.scrollHeight,
+        scrollY: Math.round(window.scrollY),
+      },
+      text: truncate(raw, asNumber(args.maxChars, MAX_TEXT_CHARS)),
+      textLength: raw.length,
+      console: readConsole({ since: asNumber(args.consoleSince, 0), limit: asNumber(args.consoleLimit, 40) }),
+    };
+  }
+
+  function scrollPage(args) {
+    if (typeof args.selector === "string" && args.selector !== "") {
+      var el = query(args.selector, args.nth);
+      try { el.scrollIntoView({ block: asString(args.block, "center"), inline: "nearest" }); } catch (e) { el.scrollIntoView(); }
+    } else {
+      window.scrollTo(asNumber(args.x, window.scrollX), asNumber(args.y, window.scrollY));
+    }
+    return { scrollX: Math.round(window.scrollX), scrollY: Math.round(window.scrollY), scrollHeight: document.documentElement.scrollHeight };
+  }
+
+  function run(op, args) {
+    if (op === "ping") {
+      return {
+        href: String(window.location.href),
+        title: String(document.title || ""),
+        readyState: String(document.readyState),
+        width: window.innerWidth,
+        height: window.innerHeight,
+        consoleCursor: consoleSeq,
+      };
+    }
+    if (op === "snapshot") return snapshot(args);
+    if (op === "console") return readConsole(args);
+    if (op === "text") {
+      var body = document.body;
+      var raw = body === null ? "" : body.innerText || body.textContent || "";
+      return { title: String(document.title || ""), text: truncate(raw, asNumber(args.maxChars, MAX_TEXT_CHARS)), length: raw.length };
+    }
+    if (op === "inspect") {
+      var selector = asString(args.selector, DEFAULT_INSPECT_SELECTOR);
+      var limit = asNumber(args.limit, 60);
+      var nodes = document.querySelectorAll(selector);
+      var items = [];
+      var hidden = 0;
+      for (var i = 0; i < nodes.length && items.length < limit; i++) {
+        if (args.includeHidden !== true && !isVisible(nodes[i])) { hidden += 1; continue; }
+        items.push(describe(nodes[i], args.maxText));
+      }
+      return { selector: selector, matched: nodes.length, returned: items.length, hiddenSkipped: hidden, items: items };
+    }
+    if (op === "html") {
+      var hasSelector = typeof args.selector === "string" && args.selector !== "";
+      var target = hasSelector ? query(args.selector, args.nth) : document.body;
+      if (!target) throw fail("ELEMENT_NOT_FOUND", "cannot read html: document.body is unavailable");
+      var markup = target.outerHTML || "";
+      return { selector: hasSelector ? args.selector : "body", html: truncate(markup, asNumber(args.maxChars, MAX_HTML_CHARS)), length: markup.length };
+    }
+    if (op === "click") {
+      var hasTarget = typeof args.selector === "string" && args.selector !== "";
+      if (hasTarget) {
+        var el = query(args.selector, args.nth);
+        if (!isVisible(el)) throw fail("ELEMENT_NOT_INTERACTABLE", "element is not visible, scroll it into view first: " + args.selector);
+        return clickElement(el);
+      }
+      var x = asNumber(args.x, -1);
+      var y = asNumber(args.y, -1);
+      if (x < 0 || y < 0) throw fail("INVALID_ARGS", "click requires either selector or x/y");
+      var hit = document.elementFromPoint(x, y);
+      if (hit === null) throw fail("ELEMENT_NOT_FOUND", "no element at point (" + x + ", " + y + ")");
+      return clickElement(hit, x, y);
+    }
+    if (op === "type") {
+      if (typeof args.selector !== "string" || args.selector === "") {
+        throw fail("INVALID_ARGS", "type requires a selector");
+      }
+      var field = query(args.selector, args.nth);
+      var tagName = String(field.tagName || "").toLowerCase();
+      var editable = tagName === "input" || tagName === "textarea" || tagName === "select" || field.isContentEditable === true;
+      if (!editable) throw fail("ELEMENT_NOT_INTERACTABLE", "element is not a text field: " + tagName);
+      return typeInto(field, args.value, args.clear !== false, args.submit === true);
+    }
+    if (op === "press") {
+      var keyTarget = null;
+      if (typeof args.selector === "string" && args.selector !== "") keyTarget = query(args.selector, args.nth);
+      return fireKey(keyTarget, asString(args.key, "Enter"));
+    }
+    if (op === "waitFor") {
+      if (typeof args.selector !== "string" || args.selector === "") {
+        throw fail("INVALID_ARGS", "waitFor requires a selector");
+      }
+      return waitFor(args.selector, asString(args.state, "visible"), asNumber(args.timeoutMs, DEFAULT_TIMEOUT_MS));
+    }
+    if (op === "scroll") return scrollPage(args);
+    if (op === "screenshot") return screenshot(args);
+    throw fail("UNKNOWN_OP", "unknown automation op: " + op);
+  }
+
+  function bridgeWindow() {
+    if (window.parent !== window) return window.parent;
+    return window.opener || null;
+  }
+
+  window.addEventListener("message", function (event) {
+    var data = event.data;
+    if (!data || data.__adepAutomationRequest !== true) return;
+    var replyTo = bridgeWindow();
+    if (!replyTo) return;
+    var id = data.id;
+    function send(ok, payload) {
+      try {
+        replyTo.postMessage({
+          __adepAutomationResponse: true,
+          id: id,
+          ok: ok,
+          result: ok ? payload.result : null,
+          error: ok ? null : payload.error,
+        }, "*");
+      } catch (e) {}
+    }
+    Promise.resolve().then(function () {
+      return run(String(data.op || ""), data.args || {});
+    }).then(function (result) {
+      send(true, { result: result === undefined ? null : result });
+    }).catch(function (error) {
+      send(false, {
+        error: {
+          code: (error && error.code) || "AUTOMATION_FAILED",
+          message: error && error.message ? String(error.message) : String(error),
+        },
+      });
+    });
+  });
+
+  window.__adepAutomation = {
+    version: 1,
+    ops: ["ping", "snapshot", "text", "inspect", "html", "click", "type", "press", "waitFor", "scroll", "screenshot", "console"],
+  };
+})();
+`;
+
 // packages/vite-plugin/src/ide-proxy.ts
 var FN_FETCH_INTERCEPTOR_SCRIPT = `(function () {
   if (window.__adepFnProxyInstalled) return;
@@ -220,6 +691,18 @@ function injectFnProxyScriptTag(html) {
   if (html.includes("/@adep/fn-proxy.js")) return html;
   return html.replace("</head>", '<script src="/@adep/fn-proxy.js"></script></head>');
 }
+function createAdepAutomationScriptMiddleware() {
+  return (req, res, next) => {
+    const pathname = (req.url ?? "").split("?")[0];
+    if (pathname !== "/@adep/automation.js") return next();
+    res.setHeader("content-type", "application/javascript; charset=utf-8");
+    res.end(PREVIEW_AUTOMATION_SCRIPT);
+  };
+}
+function injectAutomationScriptTag(html) {
+  if (html.includes("/@adep/automation.js")) return html;
+  return html.replace("</head>", '<script src="/@adep/automation.js"></script></head>');
+}
 
 // packages/vite-plugin/src/dev-server.ts
 function adepPlugin(options = {}) {
@@ -278,6 +761,7 @@ function adepPlugin(options = {}) {
       server.middlewares.use(createAdepProxyMiddleware(prefixPath, dev.baseUrl));
     }
     server.middlewares.use(createAdepFnProxyScriptMiddleware());
+    server.middlewares.use(createAdepAutomationScriptMiddleware());
   };
   return {
     name: "adep-cloud-functions",
@@ -295,7 +779,7 @@ function adepPlugin(options = {}) {
       attachMiddlewares(server);
     },
     transformIndexHtml(html) {
-      return injectFnProxyScriptTag(html);
+      return injectAutomationScriptTag(injectFnProxyScriptTag(html));
     },
     async closeBundle() {
       await disposeAdepDev();
@@ -305,10 +789,13 @@ function adepPlugin(options = {}) {
 var dev_server_default = adepPlugin;
 export {
   FN_FETCH_INTERCEPTOR_SCRIPT,
+  PREVIEW_AUTOMATION_SCRIPT,
   adepPlugin,
+  createAdepAutomationScriptMiddleware,
   createAdepFnProxyScriptMiddleware,
   createAdepProxyMiddleware,
   dev_server_default as default,
+  injectAutomationScriptTag,
   injectFnProxyScriptTag,
   isAddrInUse,
   normalizeFunctionPrefix

package/dist/preview-automation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * IDE 预览「自动化中继」脚本（`@adep/vite-plugin` 侧副本，**单一真相源**）。
+ *
+ * **同步纪律**：本字符串与 `packages/web-container/src/preview-automation.ts` 的
+ * `PREVIEW_AUTOMATION_SCRIPT`（浏览器内置 vite-dev 注入用）**逐字一致**——理由同
+ * `FN_FETCH_INTERCEPTOR_SCRIPT`：预览 iframe / 浏览器内 vite-dev 是两个独立加载上下文，
+ * 不共享 import，只共享文本契约。机检见
+ * `app/composables/__tests__/preview-inject-scripts.test.ts`（三份副本逐字比对 + 经典脚本语法 + 纯 ASCII）。
+ *
+ * 两条注入路径：
+ * - Nodebox：`app/composables/ide-nodebox-preview.ts` 经沙箱内注入插件（transformIndexHtml）
+ *   以 `<script src="/@adep/automation.js">` 注入；
+ * - 浏览器内置 dev server：`vite-dev.ts` 在 buildDocument 里内联进产物文档 `<head>` 第三位
+ *   （控制台中继 → 云函数拦截器 → 本脚本）；`dev-server.ts` / `@adep/cli/vite` 路径同款。
+ *
+ * ⚠️ 本文件是用生成器从 web-container 侧数组字面量转出来的（模板字面量里反斜杠必须双写，
+ * 手抄必然漂移）。改脚本请改 web-container 侧那份，再按同样的规则同步这里，最后跑逐字比对用例。
+ * 脚本正文只允许 ASCII（内联进 HTML 与 JSON.stringify 两条路都不做编码转换），故文案一律英文。
+ */
+export declare const PREVIEW_AUTOMATION_SCRIPT = "(function () {\n  if (window.__adepAutomationInstalled) return;\n  window.__adepAutomationInstalled = true;\n\n  var CONSOLE_LIMIT = 200;\n  var DEFAULT_TIMEOUT_MS = 8000;\n  var MAX_TEXT_CHARS = 12000;\n  var MAX_HTML_CHARS = 20000;\n  var DEFAULT_INSPECT_SELECTOR = \"a,button,input,select,textarea,img,h1,h2,h3,h4,label,[role],[data-testid]\";\n  var consoleLog = [];\n  var consoleSeq = 0;\n\n  function fail(code, message) {\n    var error = new Error(message);\n    error.code = code;\n    return error;\n  }\n\n  function asNumber(value, fallback) {\n    return typeof value === \"number\" && isFinite(value) ? value : fallback;\n  }\n\n  function asString(value, fallback) {\n    return typeof value === \"string\" ? value : fallback;\n  }\n\n  function truncate(value, max) {\n    var text = value == null ? \"\" : String(value);\n    var limit = typeof max === \"number\" && isFinite(max) && max > 0 ? Math.floor(max) : 0;\n    if (limit === 0 || text.length <= limit) return text;\n    return text.slice(0, limit) + \"...[truncated, total \" + text.length + \" chars]\";\n  }\n\n  /* ---- console / error ring buffer ---- */\n  function record(level, text) {\n    consoleSeq += 1;\n    consoleLog.push({ seq: consoleSeq, level: level, text: truncate(text, 2000), at: Date.now() });\n    if (consoleLog.length > CONSOLE_LIMIT) consoleLog.splice(0, consoleLog.length - CONSOLE_LIMIT);\n  }\n\n  function fmt(value) {\n    try {\n      if (typeof value === \"string\") return value;\n      if (value === undefined) return \"undefined\";\n      if (value instanceof Error) return value.stack || (value.name + \": \" + value.message);\n      var seen = [];\n      var json = JSON.stringify(value, function (key, val) {\n        if (val instanceof Error) return val.stack || (val.name + \": \" + val.message);\n        if (typeof val === \"function\") return \"[Function \" + (val.name || \"anonymous\") + \"]\";\n        if (typeof val === \"bigint\") return String(val) + \"n\";\n        if (val && typeof val === \"object\") {\n          if (seen.indexOf(val) !== -1) return \"[Circular]\";\n          seen.push(val);\n        }\n        return val;\n      });\n      return json === undefined ? String(value) : json;\n    } catch (e) {\n      return String(value);\n    }\n  }\n\n  var LEVELS = { log: \"log\", info: \"info\", warn: \"warn\", error: \"error\", debug: \"log\" };\n  Object.keys(LEVELS).forEach(function (name) {\n    var native = console[name];\n    console[name] = function () {\n      try { record(LEVELS[name], Array.prototype.map.call(arguments, fmt).join(\" \")); } catch (e) {}\n      native.apply(console, arguments);\n    };\n  });\n  window.addEventListener('error', function (event) {\n    var text = event.message || \"Script error\";\n    if (event.filename) text += \" (\" + event.filename + \":\" + event.lineno + \":\" + event.colno + \")\";\n    record(\"error\", text);\n  });\n  window.addEventListener('unhandledrejection', function (event) {\n    var reason = event.reason;\n    record(\"error\", reason && reason.stack ? String(reason.stack) : \"Unhandled rejection: \" + fmt(reason));\n  });\n\n  /* ---- DOM read ---- */\n  function query(selector, nth) {\n    var list = document.querySelectorAll(selector);\n    if (list.length === 0) throw fail(\"ELEMENT_NOT_FOUND\", \"selector matched nothing: \" + selector);\n    var index = asNumber(nth, 0);\n    var el = list[index];\n    if (!el) throw fail(\"ELEMENT_NOT_FOUND\", \"selector matched \" + list.length + \" elements; index \" + index + \" is out of range\");\n    return el;\n  }\n\n  function isVisible(el) {\n    if (!el || !el.getBoundingClientRect) return false;\n    var rect = el.getBoundingClientRect();\n    if (rect.width <= 0 && rect.height <= 0) return false;\n    var style = window.getComputedStyle(el);\n    if (style.visibility === \"hidden\" || style.display === \"none\") return false;\n    if (Number(style.opacity) === 0) return false;\n    return true;\n  }\n\n  function rectOf(el) {\n    var rect = el.getBoundingClientRect();\n    return {\n      x: Math.round(rect.left + window.scrollX),\n      y: Math.round(rect.top + window.scrollY),\n      w: Math.round(rect.width),\n      h: Math.round(rect.height),\n    };\n  }\n\n  function describe(el, maxText) {\n    var tag = String(el.tagName || \"\").toLowerCase();\n    var text = \"\";\n    if (tag === \"input\" || tag === \"textarea\" || tag === \"select\") text = String(el.value || \"\");\n    else text = el.textContent || \"\";\n    var out = {\n      tag: tag,\n      testid: el.getAttribute ? el.getAttribute(\"data-testid\") : null,\n      id: el.id || null,\n      cls: el.className && typeof el.className === \"string\" ? el.className : null,\n      role: el.getAttribute ? el.getAttribute(\"role\") : null,\n      text: truncate(String(text).replace(/[\\s\\u00a0]+/g, \" \").trim(), asNumber(maxText, 120)),\n      rect: rectOf(el),\n      visible: isVisible(el),\n    };\n    if (tag === \"input\" || tag === \"textarea\" || tag === \"select\") {\n      out.field = el.getAttribute(\"name\") || el.getAttribute(\"placeholder\") || null;\n      if (tag === \"input\") out.type = el.getAttribute(\"type\") || \"text\";\n    }\n    if (tag === \"a\") out.href = el.getAttribute(\"href\") || null;\n    if (el.disabled === true) out.disabled = true;\n    if (el.checked !== undefined && (tag === \"input\")) out.checked = el.checked === true;\n    return out;\n  }\n\n  /* ---- DOM write ---- */\n  function fireMouse(el, x, y, kind) {\n    var rect = el.getBoundingClientRect();\n    var clientX = typeof x === \"number\" ? x : rect.left + rect.width / 2;\n    var clientY = typeof y === \"number\" ? y : rect.top + rect.height / 2;\n    el.dispatchEvent(new MouseEvent(kind, {\n      bubbles: true, cancelable: true, composed: true, view: window,\n      clientX: clientX, clientY: clientY, button: 0,\n    }));\n  }\n\n  function clickElement(el, x, y) {\n    try { el.scrollIntoView({ block: \"center\", inline: \"center\" }); } catch (e) {}\n    fireMouse(el, x, y, \"mousedown\");\n    fireMouse(el, x, y, \"mouseup\");\n    fireMouse(el, x, y, \"click\");\n    return describe(el, 120);\n  }\n\n  function fireKey(el, key) {\n    var target = el || document.activeElement || document.body;\n    var init = { key: key, bubbles: true, cancelable: true, composed: true };\n    if (key === \"Enter\") { init.keyCode = 13; init.which = 13; }\n    if (key === \"Escape\") { init.keyCode = 27; init.which = 27; }\n    if (key === \"Tab\") { init.keyCode = 9; init.which = 9; }\n    var allowed = target.dispatchEvent(new KeyboardEvent(\"keydown\", init));\n    if (allowed) target.dispatchEvent(new KeyboardEvent(\"keypress\", init));\n    target.dispatchEvent(new KeyboardEvent(\"keyup\", init));\n    return { key: key, target: describe(target, 80) };\n  }\n\n  function setNativeValue(el, value) {\n    var proto = null;\n    if (window.HTMLTextAreaElement && el instanceof window.HTMLTextAreaElement) proto = window.HTMLTextAreaElement.prototype;\n    else if (window.HTMLSelectElement && el instanceof window.HTMLSelectElement) proto = window.HTMLSelectElement.prototype;\n    else if (window.HTMLInputElement && el instanceof window.HTMLInputElement) proto = window.HTMLInputElement.prototype;\n    var descriptor = proto ? Object.getOwnPropertyDescriptor(proto, \"value\") : null;\n    if (descriptor && descriptor.set) descriptor.set.call(el, value);\n    else el.value = value;\n  }\n\n  function fireInput(el) {\n    el.dispatchEvent(new Event(\"input\", { bubbles: true, composed: true }));\n    el.dispatchEvent(new Event(\"change\", { bubbles: true, composed: true }));\n  }\n\n  function typeInto(el, value, clear, submit) {\n    try { el.focus(); } catch (e) {}\n    if (clear) {\n      setNativeValue(el, \"\");\n      fireInput(el);\n    }\n    setNativeValue(el, clear ? String(value) : String(el.value || \"\") + String(value));\n    fireInput(el);\n    if (submit) fireKey(el, \"Enter\");\n    return describe(el, 200);\n  }\n\n  function waitFor(selector, state, timeoutMs) {\n    var want = state === \"hidden\" || state === \"detached\" ? state : \"visible\";\n    var deadline = Date.now() + timeoutMs;\n    return new Promise(function (resolve, reject) {\n      function check() {\n        var el = document.querySelector(selector);\n        if (want === \"detached\" && el === null) return resolve({ state: want, selector: selector });\n        if (want === \"hidden\" && (el === null || !isVisible(el))) return resolve({ state: want, selector: selector });\n        if (want === \"visible\" && el !== null && isVisible(el)) return resolve(describe(el, 200));\n        if (Date.now() >= deadline) {\n          return reject(fail(\"WAIT_TIMEOUT\", \"waitFor \" + want + \" timed out after \" + timeoutMs + \"ms: \" + selector));\n        }\n        setTimeout(check, 60);\n      }\n      check();\n    });\n  }\n\n  /* ---- screenshot (SVG foreignObject serialization, best effort) ---- */\n  function collectCss() {\n    var out = [];\n    var sheets = document.styleSheets;\n    for (var i = 0; i < sheets.length; i++) {\n      var rules = null;\n      try { rules = sheets[i].cssRules; } catch (e) { rules = null; }\n      if (!rules) continue;\n      for (var j = 0; j < rules.length; j++) out.push(rules[j].cssText);\n    }\n    return out.join(\"\\n\");\n  }\n\n  function inlineImages(clone) {\n    var images = clone.querySelectorAll(\"img\");\n    var jobs = [];\n    for (var i = 0; i < images.length; i++) {\n      (function (img) {\n        var src = img.getAttribute(\"src\") || \"\";\n        if (src === \"\" || src.indexOf(\"data:\") === 0) return;\n        jobs.push(window.fetch(src, { credentials: \"omit\" }).then(function (res) {\n          if (!res.ok) return null;\n          return res.blob().then(function (blob) {\n            return new Promise(function (resolve) {\n              var reader = new FileReader();\n              reader.onload = function () { img.setAttribute(\"src\", String(reader.result)); resolve(null); };\n              reader.onerror = function () { resolve(null); };\n              reader.readAsDataURL(blob);\n            });\n          });\n        }).catch(function () { return null; }));\n      })(images[i]);\n    }\n    return Promise.all(jobs);\n  }\n\n  var QUOTE = String.fromCharCode(34);\n  function tag(name, pairs) {\n    var out = \"<\" + name;\n    for (var i = 0; i < pairs.length; i += 2) out += \" \" + pairs[i] + \"=\" + QUOTE + pairs[i + 1] + QUOTE;\n    return out + \">\";\n  }\n\n  function screenshot(args) {\n    var scale = Math.min(asNumber(args.scale, 1), 2);\n    var maxHeight = asNumber(args.maxHeight, 2400);\n    var width = Math.max(1, document.documentElement.clientWidth || window.innerWidth || 1024);\n    var full = document.documentElement.scrollHeight || window.innerHeight || 768;\n    var height = Math.max(1, Math.min(full, maxHeight));\n    var clone = document.documentElement.cloneNode(true);\n    var scripts = clone.querySelectorAll(\"script\");\n    for (var i = 0; i < scripts.length; i++) {\n      if (scripts[i].parentNode) scripts[i].parentNode.removeChild(scripts[i]);\n    }\n    clone.setAttribute(\"xmlns\", \"http://www.w3.org/1999/xhtml\");\n    return inlineImages(clone).then(function () {\n      var style = document.createElement(\"style\");\n      style.textContent = collectCss();\n      var head = clone.querySelector(\"head\");\n      if (head) head.insertBefore(style, head.firstChild);\n      else clone.insertBefore(style, clone.firstChild);\n      var markup = new XMLSerializer().serializeToString(clone);\n      var svg = tag(\"svg\", [\"xmlns\", \"http://www.w3.org/2000/svg\", \"width\", width, \"height\", height])\n        + tag(\"foreignObject\", [\"x\", 0, \"y\", 0, \"width\", width, \"height\", height])\n        + markup + \"</foreignObject></svg>\";\n      var image = new Image();\n      return new Promise(function (resolve, reject) {\n        image.onload = function () {\n          var canvas = document.createElement(\"canvas\");\n          canvas.width = Math.round(width * scale);\n          canvas.height = Math.round(height * scale);\n          var ctx = canvas.getContext(\"2d\");\n          ctx.scale(scale, scale);\n          try { ctx.drawImage(image, 0, 0); } catch (e) {}\n          var dataUrl = null;\n          try { dataUrl = canvas.toDataURL(\"image/png\"); }\n          catch (e2) {\n            reject(fail(\"SCREENSHOT_TAINTED\", \"canvas is tainted by a cross-origin resource that could not be inlined; fall back to snapshot / inspect\"));\n            return;\n          }\n          resolve({ dataUrl: dataUrl, width: canvas.width, height: canvas.height, bytes: dataUrl.length, clipped: full > height });\n        };\n        image.onerror = function () {\n          reject(fail(\"SCREENSHOT_FAILED\", \"the browser refused to rasterize the serialized DOM\"));\n        };\n        image.src = \"data:image/svg+xml;charset=utf-8,\" + encodeURIComponent(svg);\n      });\n    });\n  }\n\n  /* ---- console read ---- */\n  function readConsole(args) {\n    var since = asNumber(args.since, 0);\n    var limit = asNumber(args.limit, 60);\n    var level = asString(args.level, \"\");\n    var out = [];\n    for (var i = 0; i < consoleLog.length; i++) {\n      var entry = consoleLog[i];\n      if (entry.seq <= since) continue;\n      if (level !== \"\" && entry.level !== level) continue;\n      out.push(entry);\n    }\n    var dropped = 0;\n    if (out.length > limit) {\n      dropped = out.length - limit;\n      out = out.slice(out.length - limit);\n    }\n    return { entries: out, cursor: consoleSeq, total: consoleLog.length, dropped: dropped };\n  }\n\n  function snapshot(args) {\n    var body = document.body;\n    var raw = body === null ? \"\" : body.innerText || body.textContent || \"\";\n    return {\n      ping: {\n        href: String(window.location.href),\n        title: String(document.title || \"\"),\n        readyState: String(document.readyState),\n        width: window.innerWidth,\n        height: window.innerHeight,\n        scrollHeight: document.documentElement.scrollHeight,\n        scrollY: Math.round(window.scrollY),\n      },\n      text: truncate(raw, asNumber(args.maxChars, MAX_TEXT_CHARS)),\n      textLength: raw.length,\n      console: readConsole({ since: asNumber(args.consoleSince, 0), limit: asNumber(args.consoleLimit, 40) }),\n    };\n  }\n\n  function scrollPage(args) {\n    if (typeof args.selector === \"string\" && args.selector !== \"\") {\n      var el = query(args.selector, args.nth);\n      try { el.scrollIntoView({ block: asString(args.block, \"center\"), inline: \"nearest\" }); } catch (e) { el.scrollIntoView(); }\n    } else {\n      window.scrollTo(asNumber(args.x, window.scrollX), asNumber(args.y, window.scrollY));\n    }\n    return { scrollX: Math.round(window.scrollX), scrollY: Math.round(window.scrollY), scrollHeight: document.documentElement.scrollHeight };\n  }\n\n  function run(op, args) {\n    if (op === \"ping\") {\n      return {\n        href: String(window.location.href),\n        title: String(document.title || \"\"),\n        readyState: String(document.readyState),\n        width: window.innerWidth,\n        height: window.innerHeight,\n        consoleCursor: consoleSeq,\n      };\n    }\n    if (op === \"snapshot\") return snapshot(args);\n    if (op === \"console\") return readConsole(args);\n    if (op === \"text\") {\n      var body = document.body;\n      var raw = body === null ? \"\" : body.innerText || body.textContent || \"\";\n      return { title: String(document.title || \"\"), text: truncate(raw, asNumber(args.maxChars, MAX_TEXT_CHARS)), length: raw.length };\n    }\n    if (op === \"inspect\") {\n      var selector = asString(args.selector, DEFAULT_INSPECT_SELECTOR);\n      var limit = asNumber(args.limit, 60);\n      var nodes = document.querySelectorAll(selector);\n      var items = [];\n      var hidden = 0;\n      for (var i = 0; i < nodes.length && items.length < limit; i++) {\n        if (args.includeHidden !== true && !isVisible(nodes[i])) { hidden += 1; continue; }\n        items.push(describe(nodes[i], args.maxText));\n      }\n      return { selector: selector, matched: nodes.length, returned: items.length, hiddenSkipped: hidden, items: items };\n    }\n    if (op === \"html\") {\n      var hasSelector = typeof args.selector === \"string\" && args.selector !== \"\";\n      var target = hasSelector ? query(args.selector, args.nth) : document.body;\n      if (!target) throw fail(\"ELEMENT_NOT_FOUND\", \"cannot read html: document.body is unavailable\");\n      var markup = target.outerHTML || \"\";\n      return { selector: hasSelector ? args.selector : \"body\", html: truncate(markup, asNumber(args.maxChars, MAX_HTML_CHARS)), length: markup.length };\n    }\n    if (op === \"click\") {\n      var hasTarget = typeof args.selector === \"string\" && args.selector !== \"\";\n      if (hasTarget) {\n        var el = query(args.selector, args.nth);\n        if (!isVisible(el)) throw fail(\"ELEMENT_NOT_INTERACTABLE\", \"element is not visible, scroll it into view first: \" + args.selector);\n        return clickElement(el);\n      }\n      var x = asNumber(args.x, -1);\n      var y = asNumber(args.y, -1);\n      if (x < 0 || y < 0) throw fail(\"INVALID_ARGS\", \"click requires either selector or x/y\");\n      var hit = document.elementFromPoint(x, y);\n      if (hit === null) throw fail(\"ELEMENT_NOT_FOUND\", \"no element at point (\" + x + \", \" + y + \")\");\n      return clickElement(hit, x, y);\n    }\n    if (op === \"type\") {\n      if (typeof args.selector !== \"string\" || args.selector === \"\") {\n        throw fail(\"INVALID_ARGS\", \"type requires a selector\");\n      }\n      var field = query(args.selector, args.nth);\n      var tagName = String(field.tagName || \"\").toLowerCase();\n      var editable = tagName === \"input\" || tagName === \"textarea\" || tagName === \"select\" || field.isContentEditable === true;\n      if (!editable) throw fail(\"ELEMENT_NOT_INTERACTABLE\", \"element is not a text field: \" + tagName);\n      return typeInto(field, args.value, args.clear !== false, args.submit === true);\n    }\n    if (op === \"press\") {\n      var keyTarget = null;\n      if (typeof args.selector === \"string\" && args.selector !== \"\") keyTarget = query(args.selector, args.nth);\n      return fireKey(keyTarget, asString(args.key, \"Enter\"));\n    }\n    if (op === \"waitFor\") {\n      if (typeof args.selector !== \"string\" || args.selector === \"\") {\n        throw fail(\"INVALID_ARGS\", \"waitFor requires a selector\");\n      }\n      return waitFor(args.selector, asString(args.state, \"visible\"), asNumber(args.timeoutMs, DEFAULT_TIMEOUT_MS));\n    }\n    if (op === \"scroll\") return scrollPage(args);\n    if (op === \"screenshot\") return screenshot(args);\n    throw fail(\"UNKNOWN_OP\", \"unknown automation op: \" + op);\n  }\n\n  function bridgeWindow() {\n    if (window.parent !== window) return window.parent;\n    return window.opener || null;\n  }\n\n  window.addEventListener(\"message\", function (event) {\n    var data = event.data;\n    if (!data || data.__adepAutomationRequest !== true) return;\n    var replyTo = bridgeWindow();\n    if (!replyTo) return;\n    var id = data.id;\n    function send(ok, payload) {\n      try {\n        replyTo.postMessage({\n          __adepAutomationResponse: true,\n          id: id,\n          ok: ok,\n          result: ok ? payload.result : null,\n          error: ok ? null : payload.error,\n        }, \"*\");\n      } catch (e) {}\n    }\n    Promise.resolve().then(function () {\n      return run(String(data.op || \"\"), data.args || {});\n    }).then(function (result) {\n      send(true, { result: result === undefined ? null : result });\n    }).catch(function (error) {\n      send(false, {\n        error: {\n          code: (error && error.code) || \"AUTOMATION_FAILED\",\n          message: error && error.message ? String(error.message) : String(error),\n        },\n      });\n    });\n  });\n\n  window.__adepAutomation = {\n    version: 1,\n    ops: [\"ping\", \"snapshot\", \"text\", \"inspect\", \"html\", \"click\", \"type\", \"press\", \"waitFor\", \"scroll\", \"screenshot\", \"console\"],\n  };\n})();\n";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adep/vite-plugin",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "private": false,
   "type": "module",
   "description": "云函数 Vite 插件（IDE-030，自 CLI-014 @adep/cli/vite 抽出）：vite dev 进程内启动本地 adep dev server 并代理 /{prefix}/* 到云函数；同时 serve /@adep/fn-proxy.js（Web IDE 预览 fetch 拦截器）。本地运行时与配置加载经 createDevServer / loadConfig 注入端口接入，供 CLI / Web IDE / 非 CLI 用户独立使用。",