@adep/web-container 0.2.2 → 0.2.3

package/dist/bundle-export.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 产物导出（PV-006）：把浏览器内 dev server 的 **blob 文档**序列化成一份可经真实 HTTP 源服务的
+ * 自包含产物（`{ html, modules, paths }`），交给平台预览子域。
+ *
+ * 背景（为什么需要它）：Web IDE 的前端预览由 `@adep/web-container` 的 `vite` 命令在浏览器内编译，
+ * 产物是一个 **`blob:` 入口文档**——模块之间的 import 说明符在编译期被改写成彼此的 blob URL。
+ * blob URL 只在「创建它的那个标签页」里有效：复制出去在别的浏览器打开必然失效，且 blob 是不可
+ * 分层 scheme，`history.pushState('/about')` 这类单页路由调用直接抛错。于是「像 CodeSandbox 那样
+ * 复制预览链接」这件事在 blob 形态下不可能做到。
+ *
+ * 本模块的做法：**顺着 blob 引用抓一份完整模块图，改写成内容寻址的 HTTP 路径**——
+ * 1. 读入口文档 → 找出其中所有 `blob:` 引用（`<script src="blob:…">`）；
+ * 2. 逐个读取这些 blob 的源码，再从中找出它们的 `blob:` 引用（编译期已改写为依赖的 URL）→ 递归，
+ *    直到闭包；
+ * 3. 每份源码按内容哈希命名（同内容必然同路径 → 跨版本复用、天然去重、变更必然换名），
+ *    路径形如 `/_adep/m/<hash>.js`（与服务端 `PREVIEW_MODULE_URL_RE` 白名单一致）；
+ * 4. 把所有源码里的 blob URL 替换成对应路径，得到自包含产物。
+ *
+ * 增量发布（`known`）：每次发布都把**完整闭包读一遍**（blob 就在页内存里，读取代价近乎为零），
+ * 但只把「服务端还没有的模块」放进产物体 `modules`——内容寻址下「同路径 ⇔ 同内容」，判据就是
+ * 「路径是否出现在上一次发布的映射值里」。产物另带 `paths`（本次入口所需的**全部**模块路径，
+ * 含未重复上传的那些），服务端据此写清单并清理幽灵模块：**清单必须完整**，漏报会把仍在用的
+ * 模块当幽灵删掉（页面白屏）。
+ *
+ * 为什么不干脆「已知模块连读都跳过」（更省一层）：跳读会丢掉该模块的依赖边，除非调用方保证
+ * `known` 是**完整闭包**——把正确性押在调用方的记性上，一旦传了半张表就静默产出缺模块的产物，
+ * 白屏且极难诊断。读一遍是最便宜的保险；真正贵的是网络上传，而那部分已经省掉了。
+ *
+ * 产物随后由 `POST /api/v1/projects/:id/preview` 落到项目桶，由预览子域服务：真实 HTTP 源 →
+ * 跨浏览器可用、SPA 路由（history 模式）原生可用、`/api/*` 走平台网关执行项目函数。
+ *
+ * 边界：只搬运**文本模块**。图片等二进制资产若出现在 VFS 里，dev server 本就不会把它编译成模块
+ * （解析链只认 JS/TS/CSS/JSON/Vue），故不在此处理；`readText` 拿不到内容时响亮抛错，不静默产出残缺产物。
+ */
+/** 模块 URL 前缀（与 `server/domains/preview/store.ts` 的 `PREVIEW_MODULE_URL_PREFIX` 对齐）。 */
+export declare const BUNDLE_MODULE_PATH_PREFIX = "/_adep/m/";
+export interface BundleExportOptions {
+    /** 入口文档 URL（dev server 产出的 blob 文档）。 */
+    documentUrl: string;
+    /**
+     * 读取 URL 文本（默认 `fetch(url).then(r => r.text())`）。
+     * 注入缝：Node 单测用假实现，不依赖真实 blob 存储。
+     */
+    readText?: (url: string) => Promise<string>;
+    /** 模块 URL 前缀（默认 `/_adep/m/`）。 */
+    modulePathPrefix?: string;
+    /** 内容 → 模块名（不含扩展名）。默认 sha256 前 16 位 hex；注入以便单测确定化。 */
+    moduleName?: (code: string) => string | Promise<string>;
+    /** 注入到入口文档 `</body>` 前的脚本（IDE 侧用于错误中继等；默认不注入）。 */
+    appendScript?: string;
+    /**
+     * 上一次发布的 blob URL → 模块路径映射（即上次 `ExportedBundle.urls`）。
+     * 用途只有一个：**跳过重复上传**（值集 = 服务端已有的路径集）。传空/不传 = 全量发布。
+     */
+    known?: ReadonlyMap<string, string>;
+}
+export interface ExportedBundle {
+    /** 自包含入口文档（blob 引用已改写为模块路径）。 */
+    html: string;
+    /** **需要上传**的模块（路径 → 源码）：已在上一次发布里存在的模块不再出现在这里。 */
+    modules: Record<string, string>;
+    /** 本次入口文档所需的**全部**模块路径（含本次未重复上传的；服务端据此写清单与清理幽灵）。 */
+    paths: string[];
+    /** 本次闭包的 blob URL → 路径映射；调用方保存，下次作为 `known` 传入。 */
+    urls: Map<string, string>;
+}
+/** 默认模块名：sha256 前 16 位 hex（浏览器均有 `crypto.subtle`）。 */
+export declare function defaultModuleName(code: string): Promise<string>;
+/** 找出文本里的全部 blob 引用（去重、保序）。 */
+export declare function findBlobRefs(text: string): string[];
+/**
+ * 导出产物：入口文档 + 递归闭包内全部模块（内容寻址命名 + 引用改写）。
+ * 读不到某个 blob（已被撤销 / 网络异常）→ 抛错（残缺产物比失败更糟：页面白屏且难以诊断）。
+ */
+export declare function exportBundle(options: BundleExportOptions): Promise<ExportedBundle>;

package/dist/function-fetch-proxy.d.ts

@@ -6,6 +6,8 @@
  * fetch 拦截器，把 `/api/*` 请求经 `window.parent.postMessage` 转发到 IDE 主线程；主线程
  * 用 `OfflineRunner` 执行**当前项目的云函数草稿**（改函数即生效，因为每次都实时取草稿），
  * 再把执行结果 postMessage 回 iframe。与 origin 无关：blob URL 与异源 Nodebox 隧道都能用。
+ * 新窗口打开预览（window.open）时 window.parent === window，回退到 window.opener.postMessage，
+ * 主线程经 event.source 单播回响应——新窗口与 iframe 共用同一套协议。
  *
  * 消息协议（两侧逐字对齐；改任一侧必须同步另一侧——见 web-project-template.ts 的
  * web/vite.config.ts 模板里那份逐字复制的 FN_PROXY_SCRIPT）：
@@ -37,6 +39,12 @@ export interface OfflineRunner {
  * `new URL('/api/x', 'blob:…')` 抛 TypeError → 拦截器退化成原生 fetch 报
  * "Failed to parse URL"。首次解析失败时用 `window.location.origin`（blob 继承创建者
  * origin）兜底再解析一次。
+ *
+ * 新窗口预览（2026-09-12）：`window.open` 打开的新标签页 `window.parent === window`，
+ * 回退到 `window.opener.postMessage` 转发 /api/* 请求（不能用 noopener，否则 opener 为 null）。
+ * blob URL SPA 路由：patch `history.pushState/replaceState`，对相对路径直接吞掉（blob 不可
+ * 分层，原生 pushState 解析相对路径抛 TypeError），`location.pathname` 覆盖为当前路由路径，
+ * sessionStorage 持久化，刷新后恢复。
  */
 export declare const FN_FETCH_INTERCEPTOR_SCRIPT: string;
 /** IDE 主线程侧的消息处理器类型：直接挂到 `window.addEventListener('message', handler)`。 */

package/dist/index.d.ts

@@ -31,6 +31,8 @@ export type { ModuleCache, RequireOptions } from './module-loader';
 export { createViteServer, scanEsmSpecifiers, ViteDevError } from './vite-dev';
 export type { SfcCompiler, ViteServer, ViteServerOptions, ViteCommandPort, ViteCommandOutcome, EsmSpecifierHit, } from './vite-dev';
 export * as posix from './path';
+export { exportBundle, findBlobRefs, defaultModuleName, BUNDLE_MODULE_PATH_PREFIX, } from './bundle-export';
+export type { BundleExportOptions, ExportedBundle } from './bundle-export';
 export { snapshotVfs, restoreVfs, entriesToTree, createMemoryFsBackend, createIndexedDbFsBackend, pickDefaultFsBackend, createFsPersistence, createMemoryKvStorage, createCommandHistory, } from './persistence';
 export type { FsPersistEntry, FsPersistenceBackend, FsPersistence, FsPersistenceOptions, CommandHistory, KvStorage, } from './persistence';
 export { SHELL_COMMANDS, EXTRA_COMMANDS, COMPLETABLE_COMMANDS, parseCompletionContext, completeWithListing, completeShellInput, completeContainerInput, applyCompletion, candidateLabel, } from './completion';

package/dist/index.js

@@ -679,8 +679,8 @@ var init_strip_types = __esm({
         return back1 === "," && this.tokenAt(3) === "import";
       }
       /**
-       * `(` 是否为参数列表（声明位）：`function f(`、类体里的方法 `m(`、箭头 `=> (`，
-       * 以及出现在 `(` `,` `=` `>` `:` `[` `{` `}` `;` 之后（如 `map((v: T) => v)` 的内层括号）。
+       * `(` 是否为参数列表（声明位）：`function f(`、`async` 箭头 `async (`、类体里的方法 `m(`、
+       * 箭头 `=> (`，以及出现在 `(` `,` `=` `>` `:` `[` `{` `}` `;` 之后（如 `map((v: T) => v)` 的内层括号）。
        * 调用位 `foo(` 与控制流 `if (` `for (` 都不算。
        * 误判成声明位也不足以擦掉什么：`:` 还要过 `isAnnotationColon` 的「名字前驱必须是
        * `(` `,` `{` `;` 修饰符」这一关，而三元表达式的中间段前面必然是 `?`。
@@ -689,6 +689,7 @@ var init_strip_types = __esm({
         if (this.afterFunctionKeyword) return true;
         if (this.tokenAt(2) === "function" && IDENT_START.test(this.tokenAt(1))) return true;
         if (this.afterArrow) return true;
+        if (this.tokenAt(1) === "async") return true;
         if (this.tokenAt(1) === "return") return true;
         if (this.inClassBody() && IDENT_PART.test(this.prevSignificantChar(at - 1))) return true;
         const prev = this.prevSignificantChar(at - 1);
@@ -1205,7 +1206,8 @@ var init_function_fetch_proxy = __esm({
         '    if (u.pathname.indexOf("/api/") !== 0 && u.pathname !== "/api") {',
         "      return ORIGINAL_FETCH(input, init);",
         "    }",
-        "    if (window.parent === window) return ORIGINAL_FETCH(input, init);",
+        "    var bridgeWindow = window.parent !== window ? window.parent : window.opener;",
+        "    if (!bridgeWindow) return ORIGINAL_FETCH(input, init);",
         '    method = (method || "GET").toUpperCase();',
         "    var target = u.pathname + u.search;",
         "    return readBody(input, init).then(function (textBody) {",
@@ -1216,10 +1218,75 @@ var init_function_fetch_proxy = __esm({
         `          resolve(new Response('{"error":{"code":"FN_PROXY_TIMEOUT","message":"\\u4e91\\u51fd\\u6570\\u6267\\u884c\\u8d85\\u65f6"}}', { status: 504, headers: { "content-type": "application/json" } }));`,
         "        }, TIMEOUT_MS);",
         "        pending[id] = { resolve: resolve, timer: timer };",
-        '        window.parent.postMessage({ __adepFnRequest: true, id: id, method: method, url: target, headers: headers, body: textBody }, "*");',
+        '        bridgeWindow.postMessage({ __adepFnRequest: true, id: id, method: method, url: target, headers: headers, body: textBody }, "*");',
         "      });",
         "    });",
         "  };",
+        "",
+        "  /* \u2014\u2014 blob URL SPA \u8DEF\u7531\u652F\u6301 \u2014\u2014",
+        "     blob: \u662F\u4E0D\u53EF\u5206\u5C42 scheme\uFF0Chistory.pushState('/about') \u5185\u90E8\u89E3\u6790\u76F8\u5BF9\u8DEF\u5F84\u4F1A\u629B",
+        "     TypeError \u2192 SPA history \u6A21\u5F0F\u8DEF\u7531\u5D29\u6E83\u3002patch pushState/replaceState\uFF0C\u5BF9\u76F8\u5BF9",
+        "     \u8DEF\u5F84\u76F4\u63A5\u541E\u6389\uFF08\u4E0D\u5BFC\u822A\u3001\u4E0D\u629B\u9519\uFF09\uFF0C\u8DEF\u7531\u5E93\u5185\u90E8\u72B6\u6001\u81EA\u884C\u66F4\u65B0\uFF1Blocation.pathname",
+        "     \u8986\u76D6\u4E3A\u5F53\u524D\u8DEF\u7531\u8DEF\u5F84\uFF0C\u4F9B\u8DEF\u7531\u5E93\u521D\u59CB\u5316\u65F6\u8BFB\u53D6\u3002sessionStorage \u6301\u4E45\u5316\uFF0C\u5237\u65B0\u540E\u6062\u590D\u3002 */",
+        '  if (window.location.protocol === "blob:") {',
+        '    var SPA_KEY = "__adep_spa_path";',
+        '    var spaPath = "/";',
+        "    try {",
+        "      var _saved = window.sessionStorage.getItem(SPA_KEY);",
+        "      if (_saved) spaPath = _saved;",
+        "    } catch (e) {}",
+        "    try {",
+        '      Object.defineProperty(window.location, "pathname", {',
+        "        get: function () { return spaPath; },",
+        "        configurable: true",
+        "      });",
+        "    } catch (e) {}",
+        "    var _origPush = window.history.pushState.bind(window.history);",
+        "    var _origReplace = window.history.replaceState.bind(window.history);",
+        "    function _isRelative(url) {",
+        '      if (!url || typeof url !== "string") return false;',
+        '      if (url.charAt(0) === "#") return false;',
+        "      if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(url)) return false;",
+        "      return true;",
+        "    }",
+        "    function _resolvePath(url) {",
+        '      var qi = url.indexOf("?");',
+        '      var hi = url.indexOf("#");',
+        "      var end = url.length;",
+        "      if (qi !== -1) end = qi;",
+        "      if (hi !== -1 && hi < end) end = hi;",
+        "      var p = url.slice(0, end);",
+        '      if (p.charAt(0) !== "/") {',
+        '        var base = spaPath.slice(0, spaPath.lastIndexOf("/") + 1);',
+        "        p = base + p;",
+        "      }",
+        '      var parts = p.split("/");',
+        "      var out = [];",
+        "      for (var i = 0; i < parts.length; i++) {",
+        "        var seg = parts[i];",
+        '        if (seg === "" || seg === ".") continue;',
+        '        if (seg === "..") { out.pop(); continue; }',
+        "        out.push(seg);",
+        "      }",
+        '      return "/" + out.join("/");',
+        "    }",
+        "    window.history.pushState = function (state, title, url) {",
+        "      if (_isRelative(url)) {",
+        "        spaPath = _resolvePath(url);",
+        "        try { window.sessionStorage.setItem(SPA_KEY, spaPath); } catch (e) {}",
+        "        return;",
+        "      }",
+        "      return _origPush(state, title, url);",
+        "    };",
+        "    window.history.replaceState = function (state, title, url) {",
+        "      if (_isRelative(url)) {",
+        "        spaPath = _resolvePath(url);",
+        "        try { window.sessionStorage.setItem(SPA_KEY, spaPath); } catch (e) {}",
+        "        return;",
+        "      }",
+        "      return _origReplace(state, title, url);",
+        "    };",
+        "  }",
         "})();"
       ].join("\n");
       return src;
@@ -1574,7 +1641,10 @@ function createViteServer(vfs, options = {}) {
     lastDoc = doc;
     if (currentUrl !== "") revokeObjectURL(currentUrl);
     currentUrl = createObjectURL(new Blob([doc], { type: "text/html" }));
-    if (changed) broadcast(currentUrl);
+    if (changed) {
+      broadcast(currentUrl);
+      options.onDocumentChange?.(currentUrl);
+    }
   }
   const server = {
     get url() {
@@ -3611,7 +3681,11 @@ function bootstrap(options) {
       const { createViteServer: createViteServer2 } = await Promise.resolve().then(() => (init_vite_dev(), vite_dev_exports));
       const server = createViteServer2(vfs, {
         root,
-        ...options.viteCompiler === void 0 ? {} : { sfcCompiler: options.viteCompiler }
+        ...options.viteCompiler === void 0 ? {} : { sfcCompiler: options.viteCompiler },
+        // PV-006：内容重建 → 以 `serverready`（update: true）事件上报新文档 URL，宿主导出预览产物。
+        onDocumentChange: (url) => {
+          emit("serverready", { port: server.port, url, kind: "vite", root: server.root, update: true });
+        }
       });
       await server.ready;
       viteServer = server;
@@ -3776,6 +3850,92 @@ init_node_resolve();
 init_vite_dev();
 init_path();
 
+// packages/web-container/src/bundle-export.ts
+var BUNDLE_MODULE_PATH_PREFIX = "/_adep/m/";
+var BLOB_REF_RE = /blob:[^\s"'`<>()\\]+/g;
+function fnv1a(code) {
+  let hash = 2166136261;
+  for (let i = 0; i < code.length; i++) {
+    hash ^= code.charCodeAt(i);
+    hash = Math.imul(hash, 16777619) >>> 0;
+  }
+  return `${hash.toString(16).padStart(8, "0")}${code.length.toString(16)}`;
+}
+async function defaultModuleName(code) {
+  const subtle = globalThis.crypto?.subtle;
+  if (subtle === void 0) return fnv1a(code);
+  const digest = await subtle.digest("SHA-256", new TextEncoder().encode(code));
+  let hex = "";
+  for (const byte of new Uint8Array(digest).slice(0, 8)) {
+    hex += byte.toString(16).padStart(2, "0");
+  }
+  return hex;
+}
+function findBlobRefs(text) {
+  const found = text.match(BLOB_REF_RE);
+  return found === null ? [] : [...new Set(found)];
+}
+function rewriteRefs(text, urls) {
+  let out = text;
+  for (const [blobUrl, path] of urls) {
+    if (out.includes(blobUrl)) out = out.split(blobUrl).join(path);
+  }
+  return out;
+}
+function injectScript(html, script) {
+  return /<\/body>/i.test(html) ? html.replace(/<\/body>/i, `${script}</body>`) : html + script;
+}
+async function exportBundle(options) {
+  const readText = options.readText ?? ((url) => fetch(url).then((response) => response.text()));
+  const nameOf = options.moduleName ?? defaultModuleName;
+  const prefix = options.modulePathPrefix ?? BUNDLE_MODULE_PATH_PREFIX;
+  const uploaded = new Set(options.known === void 0 ? [] : [...options.known.values()]);
+  const urls = /* @__PURE__ */ new Map();
+  const sources = [];
+  const readOrThrow = async (url) => {
+    try {
+      return await readText(url);
+    } catch (error) {
+      throw new Error(
+        `\u9884\u89C8\u4EA7\u7269\u5BFC\u51FA\u5931\u8D25\uFF1A\u8BFB\u4E0D\u5230\u6A21\u5757 ${url}\uFF08${error instanceof Error ? error.message : String(error)}\uFF09`,
+        { cause: error }
+      );
+    }
+  };
+  const html = await readOrThrow(options.documentUrl);
+  const loadLayer = async (layer) => {
+    const batch = [...new Set(layer)].filter((url) => !urls.has(url));
+    if (batch.length === 0) return;
+    const loaded = await Promise.all(
+      batch.map(async (url) => {
+        const code = await readOrThrow(url);
+        return { url, code, path: `${prefix}${await nameOf(code)}.js` };
+      })
+    );
+    const next = [];
+    for (const item of loaded) {
+      urls.set(item.url, item.path);
+      sources.push({ url: item.url, code: item.code });
+      next.push(...findBlobRefs(item.code));
+    }
+    await loadLayer(next);
+  };
+  await loadLayer(findBlobRefs(html));
+  const modules = {};
+  for (const { url, code } of sources) {
+    const path = urls.get(url);
+    if (uploaded.has(path)) continue;
+    modules[path] = rewriteRefs(code, urls);
+  }
+  const rewrittenHtml = rewriteRefs(html, urls);
+  return {
+    html: options.appendScript === void 0 ? rewrittenHtml : injectScript(rewrittenHtml, options.appendScript),
+    modules,
+    paths: [...new Set(urls.values())].toSorted(),
+    urls
+  };
+}
+
 // packages/web-container/src/persistence.ts
 function cloneEntries(entries) {
   return entries.map(
@@ -5537,6 +5697,17 @@ var SimSqlEngine = class {
       }
       return { changes: 0 };
     }
+    if (/^CREATE\s+(?:UNIQUE\s+)?INDEX\s+(?:IF\s+NOT\s+EXISTS\s+)?/i.test(stmt)) {
+      const idx = /^CREATE\s+(?:UNIQUE\s+)?INDEX\s+(?:IF\s+NOT\s+EXISTS\s+)?((?:"[^"]+")|([A-Za-z_][A-Za-z0-9_]*))\s+ON\s+((?:"[^"]+")|([A-Za-z_][A-Za-z0-9_]*))/i.exec(
+        stmt
+      );
+      if (idx === null) throw new SimDbError("DB_UNSAFE_OP", `\u65E0\u6CD5\u89E3\u6790 CREATE INDEX \u8BED\u53E5`);
+      const tableName = ident(idx[3]);
+      if (this.tables[tableName] === void 0) {
+        throw new SimDbError("DB_UNSAFE_OP", `CREATE INDEX \u76EE\u6807\u8868\u4E0D\u5B58\u5728\uFF1A${tableName}`);
+      }
+      return { changes: 0 };
+    }
     if (/^INSERT\s+INTO/i.test(stmt)) return this.execInsert(stmt, params);
     if (/^UPDATE\s+/i.test(stmt)) return this.execUpdate(stmt, params);
     if (/^DELETE\s+FROM/i.test(stmt)) return this.execDelete(stmt, params);
@@ -5781,6 +5952,19 @@ function assertSafeStoragePath(path) {
   }
   return path;
 }
+function assertStoragePrefix(prefix) {
+  if (prefix !== void 0 && prefix !== "") {
+    const segments = prefix.split("/");
+    if (prefix.startsWith("/") || /[\\]/.test(prefix) || segments.some((segment) => segment === "..")) {
+      throw new StorageError(
+        400,
+        STORAGE_CODES.invalidPath,
+        `\u975E\u6CD5\u524D\u7F00 "${prefix}"\uFF08\u7981\u6B62 / \u5F00\u5934\u3001\u53CD\u659C\u6760\u6216 .. \u7A7F\u8D8A\uFF09`
+      );
+    }
+  }
+  return prefix ?? "";
+}
 
 // packages/runtime/src/storage/hmac-sha256.ts
 var K = new Uint32Array([
@@ -6100,16 +6284,7 @@ function createBrowserStorageDriver(options) {
       await saveBucket(bucket);
     },
     async list(_projectId, prefix) {
-      if (prefix !== void 0 && prefix !== "") {
-        const segments = prefix.split("/");
-        if (prefix.startsWith("/") || /[\\]/.test(prefix) || segments.some((segment) => segment === "..")) {
-          throw new StorageError(
-            400,
-            STORAGE_CODES.invalidPath,
-            `\u975E\u6CD5\u524D\u7F00 "${prefix}"\uFF08\u7981\u6B62 / \u5F00\u5934\u3001\u53CD\u659C\u6760\u6216 .. \u7A7F\u8D8A\uFF09`
-          );
-        }
-      }
+      assertStoragePrefix(prefix);
       const bucket = await loadBucket();
       return Object.values(bucket).filter((object) => prefix === void 0 || object.path.startsWith(prefix)).map(toMeta).toSorted((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
     },
@@ -6496,6 +6671,19 @@ function createCloudContainer() {
   };
 }
 
+// packages/runtime/src/functions/runtime/rpc-wire.ts
+function wireRpcResponses(port, pending) {
+  port.on?.((message) => {
+    const reply = message;
+    if (reply?.type !== "rpc-response" || typeof reply.id !== "number") return;
+    const entry = pending.get(reply.id);
+    if (entry === void 0) return;
+    pending.delete(reply.id);
+    if (reply.ok === true) entry.resolve(reply.result);
+    else entry.reject(new Error(reply.error ?? "RPC \u80FD\u529B\u8C03\u7528\u5931\u8D25"));
+  });
+}
+
 // packages/web-container/src/sim/ctx.ts
 function createLocalPort(handler) {
   const listeners = [];
@@ -6525,17 +6713,6 @@ function createLocalPort(handler) {
     }
   };
 }
-function wireRpcResponses(port, pending) {
-  port.on((message) => {
-    const reply = message;
-    if (reply?.type !== "rpc-response" || typeof reply.id !== "number") return;
-    const entry = pending.get(reply.id);
-    if (entry === void 0) return;
-    pending.delete(reply.id);
-    if (reply.ok === true) entry.resolve(reply.result);
-    else entry.reject(new Error(reply.error ?? "RPC \u80FD\u529B\u8C03\u7528\u5931\u8D25"));
-  });
-}
 function createFlatRpcClient(handler) {
   return new Proxy(
     {},
@@ -6749,6 +6926,27 @@ function createOfflineFunctionRunner(options = {}) {
   return { run };
 }
 
+// packages/runtime/src/sim/merge.ts
+function mergeBundles(bundles) {
+  const capabilities = [];
+  const byName = /* @__PURE__ */ new Map();
+  for (const bundle of bundles) {
+    for (const cap of bundle.capabilities) {
+      const existing = byName.get(cap.name);
+      if (existing !== void 0) capabilities.splice(capabilities.indexOf(existing), 1);
+      byName.set(cap.name, cap);
+      capabilities.push(cap);
+    }
+  }
+  const rpcHandlers = {};
+  for (const bundle of bundles) {
+    for (const [name, handler] of Object.entries(bundle.rpcHandlers)) {
+      rpcHandlers[name] = handler;
+    }
+  }
+  return { capabilities, rpcHandlers };
+}
+
 // packages/runtime/src/database/sdk/kv.ts
 var KV_TABLE = "_adep_kv";
 var KV_RPC = {
@@ -6850,25 +7048,6 @@ function createKvCapability(driver) {
 }
 
 // packages/web-container/src/sim/runtime.ts
-function mergeBundles(bundles) {
-  const capabilities = [];
-  const byName = /* @__PURE__ */ new Map();
-  for (const bundle of bundles) {
-    for (const cap of bundle.capabilities) {
-      const existing = byName.get(cap.name);
-      if (existing !== void 0) capabilities.splice(capabilities.indexOf(existing), 1);
-      byName.set(cap.name, cap);
-      capabilities.push(cap);
-    }
-  }
-  const rpcHandlers = {};
-  for (const bundle of bundles) {
-    for (const [name, handler] of Object.entries(bundle.rpcHandlers)) {
-      rpcHandlers[name] = handler;
-    }
-  }
-  return { capabilities, rpcHandlers };
-}
 async function createBrowserSimRuntime(options) {
   const kv = options.kv ?? pickDefaultSimKv();
   const db = createBrowserSimDb({ projectId: options.projectId, kv });
@@ -6900,6 +7079,7 @@ async function createBrowserSimRuntime(options) {
 // packages/web-container/src/index.ts
 init_function_fetch_proxy();
 export {
+  BUNDLE_MODULE_PATH_PREFIX,
   COMPLETABLE_COMMANDS,
   DEFAULT_MAX_INSTALL_DEPTH,
   EXTRA_COMMANDS,
@@ -6945,12 +7125,15 @@ export {
   createViteServer,
   createWorkerRuntime,
   deepEqual,
+  defaultModuleName,
   displayPath,
   entriesToTree,
   evaluateModuleSource,
   evaluateSource,
   exampleTestSource,
   expect as expectAssertion,
+  exportBundle,
+  findBlobRefs,
   formatTestReport,
   formatValue,
   fullName,

package/dist/sim/runtime.d.ts

@@ -44,5 +44,6 @@ export interface BrowserSimRuntime {
     /** 释放资源（当前无长持句柄；与 CLI createSimRuntime.dispose 对称保留）。 */
     dispose(): Promise<void>;
 }
+/** 顺序合并多份 bundle：capabilities 去重（同名后者覆盖），rpcHandlers 浅合并。 */
 /** 装配浏览器模拟运行时（async：db 引擎要先把 IndexedDB 里的快照灌回来）。 */
 export declare function createBrowserSimRuntime(options: BrowserSimRuntimeOptions): Promise<BrowserSimRuntime>;

package/dist/vite-dev.d.ts

@@ -48,6 +48,12 @@ export interface ViteServerOptions {
     /** blob URL 工厂（Node 单测注入假实现）。 */
     createObjectURL?: (blob: Blob) => string;
     revokeObjectURL?: (url: string) => void;
+    /**
+     * 文档重建且**内容有变化**时回调（PV-006）：blob HMR 之外的第二条出口——
+     * IDE 侧据此把新产物导出并发布到预览子域（真实 HTTP 源）。
+     * 首建不回调（宿主由 `serverready` 事件拿首屏 URL，两处都回调会长重复发布）。
+     */
+    onDocumentChange?: (url: string) => void;
 }
 /** dev server 句柄：url / root 对外只读，`touch` 驱动 HMR，`stop` 释放资源。 */
 export interface ViteServer {

package/dist/web-container.esm.js

@@ -679,8 +679,8 @@ var init_strip_types = __esm({
         return back1 === "," && this.tokenAt(3) === "import";
       }
       /**
-       * `(` 是否为参数列表（声明位）：`function f(`、类体里的方法 `m(`、箭头 `=> (`，
-       * 以及出现在 `(` `,` `=` `>` `:` `[` `{` `}` `;` 之后（如 `map((v: T) => v)` 的内层括号）。
+       * `(` 是否为参数列表（声明位）：`function f(`、`async` 箭头 `async (`、类体里的方法 `m(`、
+       * 箭头 `=> (`，以及出现在 `(` `,` `=` `>` `:` `[` `{` `}` `;` 之后（如 `map((v: T) => v)` 的内层括号）。
        * 调用位 `foo(` 与控制流 `if (` `for (` 都不算。
        * 误判成声明位也不足以擦掉什么：`:` 还要过 `isAnnotationColon` 的「名字前驱必须是
        * `(` `,` `{` `;` 修饰符」这一关，而三元表达式的中间段前面必然是 `?`。
@@ -689,6 +689,7 @@ var init_strip_types = __esm({
         if (this.afterFunctionKeyword) return true;
         if (this.tokenAt(2) === "function" && IDENT_START.test(this.tokenAt(1))) return true;
         if (this.afterArrow) return true;
+        if (this.tokenAt(1) === "async") return true;
         if (this.tokenAt(1) === "return") return true;
         if (this.inClassBody() && IDENT_PART.test(this.prevSignificantChar(at - 1))) return true;
         const prev = this.prevSignificantChar(at - 1);
@@ -1205,7 +1206,8 @@ var init_function_fetch_proxy = __esm({
         '    if (u.pathname.indexOf("/api/") !== 0 && u.pathname !== "/api") {',
         "      return ORIGINAL_FETCH(input, init);",
         "    }",
-        "    if (window.parent === window) return ORIGINAL_FETCH(input, init);",
+        "    var bridgeWindow = window.parent !== window ? window.parent : window.opener;",
+        "    if (!bridgeWindow) return ORIGINAL_FETCH(input, init);",
         '    method = (method || "GET").toUpperCase();',
         "    var target = u.pathname + u.search;",
         "    return readBody(input, init).then(function (textBody) {",
@@ -1216,10 +1218,75 @@ var init_function_fetch_proxy = __esm({
         `          resolve(new Response('{"error":{"code":"FN_PROXY_TIMEOUT","message":"\\u4e91\\u51fd\\u6570\\u6267\\u884c\\u8d85\\u65f6"}}', { status: 504, headers: { "content-type": "application/json" } }));`,
         "        }, TIMEOUT_MS);",
         "        pending[id] = { resolve: resolve, timer: timer };",
-        '        window.parent.postMessage({ __adepFnRequest: true, id: id, method: method, url: target, headers: headers, body: textBody }, "*");',
+        '        bridgeWindow.postMessage({ __adepFnRequest: true, id: id, method: method, url: target, headers: headers, body: textBody }, "*");',
         "      });",
         "    });",
         "  };",
+        "",
+        "  /* \u2014\u2014 blob URL SPA \u8DEF\u7531\u652F\u6301 \u2014\u2014",
+        "     blob: \u662F\u4E0D\u53EF\u5206\u5C42 scheme\uFF0Chistory.pushState('/about') \u5185\u90E8\u89E3\u6790\u76F8\u5BF9\u8DEF\u5F84\u4F1A\u629B",
+        "     TypeError \u2192 SPA history \u6A21\u5F0F\u8DEF\u7531\u5D29\u6E83\u3002patch pushState/replaceState\uFF0C\u5BF9\u76F8\u5BF9",
+        "     \u8DEF\u5F84\u76F4\u63A5\u541E\u6389\uFF08\u4E0D\u5BFC\u822A\u3001\u4E0D\u629B\u9519\uFF09\uFF0C\u8DEF\u7531\u5E93\u5185\u90E8\u72B6\u6001\u81EA\u884C\u66F4\u65B0\uFF1Blocation.pathname",
+        "     \u8986\u76D6\u4E3A\u5F53\u524D\u8DEF\u7531\u8DEF\u5F84\uFF0C\u4F9B\u8DEF\u7531\u5E93\u521D\u59CB\u5316\u65F6\u8BFB\u53D6\u3002sessionStorage \u6301\u4E45\u5316\uFF0C\u5237\u65B0\u540E\u6062\u590D\u3002 */",
+        '  if (window.location.protocol === "blob:") {',
+        '    var SPA_KEY = "__adep_spa_path";',
+        '    var spaPath = "/";',
+        "    try {",
+        "      var _saved = window.sessionStorage.getItem(SPA_KEY);",
+        "      if (_saved) spaPath = _saved;",
+        "    } catch (e) {}",
+        "    try {",
+        '      Object.defineProperty(window.location, "pathname", {',
+        "        get: function () { return spaPath; },",
+        "        configurable: true",
+        "      });",
+        "    } catch (e) {}",
+        "    var _origPush = window.history.pushState.bind(window.history);",
+        "    var _origReplace = window.history.replaceState.bind(window.history);",
+        "    function _isRelative(url) {",
+        '      if (!url || typeof url !== "string") return false;',
+        '      if (url.charAt(0) === "#") return false;',
+        "      if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(url)) return false;",
+        "      return true;",
+        "    }",
+        "    function _resolvePath(url) {",
+        '      var qi = url.indexOf("?");',
+        '      var hi = url.indexOf("#");',
+        "      var end = url.length;",
+        "      if (qi !== -1) end = qi;",
+        "      if (hi !== -1 && hi < end) end = hi;",
+        "      var p = url.slice(0, end);",
+        '      if (p.charAt(0) !== "/") {',
+        '        var base = spaPath.slice(0, spaPath.lastIndexOf("/") + 1);',
+        "        p = base + p;",
+        "      }",
+        '      var parts = p.split("/");',
+        "      var out = [];",
+        "      for (var i = 0; i < parts.length; i++) {",
+        "        var seg = parts[i];",
+        '        if (seg === "" || seg === ".") continue;',
+        '        if (seg === "..") { out.pop(); continue; }',
+        "        out.push(seg);",
+        "      }",
+        '      return "/" + out.join("/");',
+        "    }",
+        "    window.history.pushState = function (state, title, url) {",
+        "      if (_isRelative(url)) {",
+        "        spaPath = _resolvePath(url);",
+        "        try { window.sessionStorage.setItem(SPA_KEY, spaPath); } catch (e) {}",
+        "        return;",
+        "      }",
+        "      return _origPush(state, title, url);",
+        "    };",
+        "    window.history.replaceState = function (state, title, url) {",
+        "      if (_isRelative(url)) {",
+        "        spaPath = _resolvePath(url);",
+        "        try { window.sessionStorage.setItem(SPA_KEY, spaPath); } catch (e) {}",
+        "        return;",
+        "      }",
+        "      return _origReplace(state, title, url);",
+        "    };",
+        "  }",
         "})();"
       ].join("\n");
       return src;
@@ -1574,7 +1641,10 @@ function createViteServer(vfs, options = {}) {
     lastDoc = doc;
     if (currentUrl !== "") revokeObjectURL(currentUrl);
     currentUrl = createObjectURL(new Blob([doc], { type: "text/html" }));
-    if (changed) broadcast(currentUrl);
+    if (changed) {
+      broadcast(currentUrl);
+      options.onDocumentChange?.(currentUrl);
+    }
   }
   const server = {
     get url() {
@@ -3611,7 +3681,11 @@ function bootstrap(options) {
       const { createViteServer: createViteServer2 } = await Promise.resolve().then(() => (init_vite_dev(), vite_dev_exports));
       const server = createViteServer2(vfs, {
         root,
-        ...options.viteCompiler === void 0 ? {} : { sfcCompiler: options.viteCompiler }
+        ...options.viteCompiler === void 0 ? {} : { sfcCompiler: options.viteCompiler },
+        // PV-006：内容重建 → 以 `serverready`（update: true）事件上报新文档 URL，宿主导出预览产物。
+        onDocumentChange: (url) => {
+          emit("serverready", { port: server.port, url, kind: "vite", root: server.root, update: true });
+        }
       });
       await server.ready;
       viteServer = server;
@@ -3776,6 +3850,92 @@ init_node_resolve();
 init_vite_dev();
 init_path();
 
+// src/bundle-export.ts
+var BUNDLE_MODULE_PATH_PREFIX = "/_adep/m/";
+var BLOB_REF_RE = /blob:[^\s"'`<>()\\]+/g;
+function fnv1a(code) {
+  let hash = 2166136261;
+  for (let i = 0; i < code.length; i++) {
+    hash ^= code.charCodeAt(i);
+    hash = Math.imul(hash, 16777619) >>> 0;
+  }
+  return `${hash.toString(16).padStart(8, "0")}${code.length.toString(16)}`;
+}
+async function defaultModuleName(code) {
+  const subtle = globalThis.crypto?.subtle;
+  if (subtle === void 0) return fnv1a(code);
+  const digest = await subtle.digest("SHA-256", new TextEncoder().encode(code));
+  let hex = "";
+  for (const byte of new Uint8Array(digest).slice(0, 8)) {
+    hex += byte.toString(16).padStart(2, "0");
+  }
+  return hex;
+}
+function findBlobRefs(text) {
+  const found = text.match(BLOB_REF_RE);
+  return found === null ? [] : [...new Set(found)];
+}
+function rewriteRefs(text, urls) {
+  let out = text;
+  for (const [blobUrl, path] of urls) {
+    if (out.includes(blobUrl)) out = out.split(blobUrl).join(path);
+  }
+  return out;
+}
+function injectScript(html, script) {
+  return /<\/body>/i.test(html) ? html.replace(/<\/body>/i, `${script}</body>`) : html + script;
+}
+async function exportBundle(options) {
+  const readText = options.readText ?? ((url) => fetch(url).then((response) => response.text()));
+  const nameOf = options.moduleName ?? defaultModuleName;
+  const prefix = options.modulePathPrefix ?? BUNDLE_MODULE_PATH_PREFIX;
+  const uploaded = new Set(options.known === void 0 ? [] : [...options.known.values()]);
+  const urls = /* @__PURE__ */ new Map();
+  const sources = [];
+  const readOrThrow = async (url) => {
+    try {
+      return await readText(url);
+    } catch (error) {
+      throw new Error(
+        `\u9884\u89C8\u4EA7\u7269\u5BFC\u51FA\u5931\u8D25\uFF1A\u8BFB\u4E0D\u5230\u6A21\u5757 ${url}\uFF08${error instanceof Error ? error.message : String(error)}\uFF09`,
+        { cause: error }
+      );
+    }
+  };
+  const html = await readOrThrow(options.documentUrl);
+  const loadLayer = async (layer) => {
+    const batch = [...new Set(layer)].filter((url) => !urls.has(url));
+    if (batch.length === 0) return;
+    const loaded = await Promise.all(
+      batch.map(async (url) => {
+        const code = await readOrThrow(url);
+        return { url, code, path: `${prefix}${await nameOf(code)}.js` };
+      })
+    );
+    const next = [];
+    for (const item of loaded) {
+      urls.set(item.url, item.path);
+      sources.push({ url: item.url, code: item.code });
+      next.push(...findBlobRefs(item.code));
+    }
+    await loadLayer(next);
+  };
+  await loadLayer(findBlobRefs(html));
+  const modules = {};
+  for (const { url, code } of sources) {
+    const path = urls.get(url);
+    if (uploaded.has(path)) continue;
+    modules[path] = rewriteRefs(code, urls);
+  }
+  const rewrittenHtml = rewriteRefs(html, urls);
+  return {
+    html: options.appendScript === void 0 ? rewrittenHtml : injectScript(rewrittenHtml, options.appendScript),
+    modules,
+    paths: [...new Set(urls.values())].toSorted(),
+    urls
+  };
+}
+
 // src/persistence.ts
 function cloneEntries(entries) {
   return entries.map(
@@ -5537,6 +5697,17 @@ var SimSqlEngine = class {
       }
       return { changes: 0 };
     }
+    if (/^CREATE\s+(?:UNIQUE\s+)?INDEX\s+(?:IF\s+NOT\s+EXISTS\s+)?/i.test(stmt)) {
+      const idx = /^CREATE\s+(?:UNIQUE\s+)?INDEX\s+(?:IF\s+NOT\s+EXISTS\s+)?((?:"[^"]+")|([A-Za-z_][A-Za-z0-9_]*))\s+ON\s+((?:"[^"]+")|([A-Za-z_][A-Za-z0-9_]*))/i.exec(
+        stmt
+      );
+      if (idx === null) throw new SimDbError("DB_UNSAFE_OP", `\u65E0\u6CD5\u89E3\u6790 CREATE INDEX \u8BED\u53E5`);
+      const tableName = ident(idx[3]);
+      if (this.tables[tableName] === void 0) {
+        throw new SimDbError("DB_UNSAFE_OP", `CREATE INDEX \u76EE\u6807\u8868\u4E0D\u5B58\u5728\uFF1A${tableName}`);
+      }
+      return { changes: 0 };
+    }
     if (/^INSERT\s+INTO/i.test(stmt)) return this.execInsert(stmt, params);
     if (/^UPDATE\s+/i.test(stmt)) return this.execUpdate(stmt, params);
     if (/^DELETE\s+FROM/i.test(stmt)) return this.execDelete(stmt, params);
@@ -5781,6 +5952,19 @@ function assertSafeStoragePath(path) {
   }
   return path;
 }
+function assertStoragePrefix(prefix) {
+  if (prefix !== void 0 && prefix !== "") {
+    const segments = prefix.split("/");
+    if (prefix.startsWith("/") || /[\\]/.test(prefix) || segments.some((segment) => segment === "..")) {
+      throw new StorageError(
+        400,
+        STORAGE_CODES.invalidPath,
+        `\u975E\u6CD5\u524D\u7F00 "${prefix}"\uFF08\u7981\u6B62 / \u5F00\u5934\u3001\u53CD\u659C\u6760\u6216 .. \u7A7F\u8D8A\uFF09`
+      );
+    }
+  }
+  return prefix ?? "";
+}
 
 // ../runtime/src/storage/hmac-sha256.ts
 var K = new Uint32Array([
@@ -6100,16 +6284,7 @@ function createBrowserStorageDriver(options) {
       await saveBucket(bucket);
     },
     async list(_projectId, prefix) {
-      if (prefix !== void 0 && prefix !== "") {
-        const segments = prefix.split("/");
-        if (prefix.startsWith("/") || /[\\]/.test(prefix) || segments.some((segment) => segment === "..")) {
-          throw new StorageError(
-            400,
-            STORAGE_CODES.invalidPath,
-            `\u975E\u6CD5\u524D\u7F00 "${prefix}"\uFF08\u7981\u6B62 / \u5F00\u5934\u3001\u53CD\u659C\u6760\u6216 .. \u7A7F\u8D8A\uFF09`
-          );
-        }
-      }
+      assertStoragePrefix(prefix);
       const bucket = await loadBucket();
       return Object.values(bucket).filter((object) => prefix === void 0 || object.path.startsWith(prefix)).map(toMeta).toSorted((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
     },
@@ -6496,6 +6671,19 @@ function createCloudContainer() {
   };
 }
 
+// ../runtime/src/functions/runtime/rpc-wire.ts
+function wireRpcResponses(port, pending) {
+  port.on?.((message) => {
+    const reply = message;
+    if (reply?.type !== "rpc-response" || typeof reply.id !== "number") return;
+    const entry = pending.get(reply.id);
+    if (entry === void 0) return;
+    pending.delete(reply.id);
+    if (reply.ok === true) entry.resolve(reply.result);
+    else entry.reject(new Error(reply.error ?? "RPC \u80FD\u529B\u8C03\u7528\u5931\u8D25"));
+  });
+}
+
 // src/sim/ctx.ts
 function createLocalPort(handler) {
   const listeners = [];
@@ -6525,17 +6713,6 @@ function createLocalPort(handler) {
     }
   };
 }
-function wireRpcResponses(port, pending) {
-  port.on((message) => {
-    const reply = message;
-    if (reply?.type !== "rpc-response" || typeof reply.id !== "number") return;
-    const entry = pending.get(reply.id);
-    if (entry === void 0) return;
-    pending.delete(reply.id);
-    if (reply.ok === true) entry.resolve(reply.result);
-    else entry.reject(new Error(reply.error ?? "RPC \u80FD\u529B\u8C03\u7528\u5931\u8D25"));
-  });
-}
 function createFlatRpcClient(handler) {
   return new Proxy(
     {},
@@ -6749,6 +6926,27 @@ function createOfflineFunctionRunner(options = {}) {
   return { run };
 }
 
+// ../runtime/src/sim/merge.ts
+function mergeBundles(bundles) {
+  const capabilities = [];
+  const byName = /* @__PURE__ */ new Map();
+  for (const bundle of bundles) {
+    for (const cap of bundle.capabilities) {
+      const existing = byName.get(cap.name);
+      if (existing !== void 0) capabilities.splice(capabilities.indexOf(existing), 1);
+      byName.set(cap.name, cap);
+      capabilities.push(cap);
+    }
+  }
+  const rpcHandlers = {};
+  for (const bundle of bundles) {
+    for (const [name, handler] of Object.entries(bundle.rpcHandlers)) {
+      rpcHandlers[name] = handler;
+    }
+  }
+  return { capabilities, rpcHandlers };
+}
+
 // ../runtime/src/database/sdk/kv.ts
 var KV_TABLE = "_adep_kv";
 var KV_RPC = {
@@ -6850,25 +7048,6 @@ function createKvCapability(driver) {
 }
 
 // src/sim/runtime.ts
-function mergeBundles(bundles) {
-  const capabilities = [];
-  const byName = /* @__PURE__ */ new Map();
-  for (const bundle of bundles) {
-    for (const cap of bundle.capabilities) {
-      const existing = byName.get(cap.name);
-      if (existing !== void 0) capabilities.splice(capabilities.indexOf(existing), 1);
-      byName.set(cap.name, cap);
-      capabilities.push(cap);
-    }
-  }
-  const rpcHandlers = {};
-  for (const bundle of bundles) {
-    for (const [name, handler] of Object.entries(bundle.rpcHandlers)) {
-      rpcHandlers[name] = handler;
-    }
-  }
-  return { capabilities, rpcHandlers };
-}
 async function createBrowserSimRuntime(options) {
   const kv = options.kv ?? pickDefaultSimKv();
   const db = createBrowserSimDb({ projectId: options.projectId, kv });
@@ -6900,6 +7079,7 @@ async function createBrowserSimRuntime(options) {
 // src/index.ts
 init_function_fetch_proxy();
 export {
+  BUNDLE_MODULE_PATH_PREFIX,
   COMPLETABLE_COMMANDS,
   DEFAULT_MAX_INSTALL_DEPTH,
   EXTRA_COMMANDS,
@@ -6945,12 +7125,15 @@ export {
   createViteServer,
   createWorkerRuntime,
   deepEqual,
+  defaultModuleName,
   displayPath,
   entriesToTree,
   evaluateModuleSource,
   evaluateSource,
   exampleTestSource,
   expect as expectAssertion,
+  exportBundle,
+  findBlobRefs,
   formatTestReport,
   formatValue,
   fullName,

package/dist/web-container.iife.js

@@ -692,8 +692,8 @@ var AdepWebContainer = (() => {
           return back1 === "," && this.tokenAt(3) === "import";
         }
         /**
-         * `(` 是否为参数列表（声明位）：`function f(`、类体里的方法 `m(`、箭头 `=> (`，
-         * 以及出现在 `(` `,` `=` `>` `:` `[` `{` `}` `;` 之后（如 `map((v: T) => v)` 的内层括号）。
+         * `(` 是否为参数列表（声明位）：`function f(`、`async` 箭头 `async (`、类体里的方法 `m(`、
+         * 箭头 `=> (`，以及出现在 `(` `,` `=` `>` `:` `[` `{` `}` `;` 之后（如 `map((v: T) => v)` 的内层括号）。
          * 调用位 `foo(` 与控制流 `if (` `for (` 都不算。
          * 误判成声明位也不足以擦掉什么：`:` 还要过 `isAnnotationColon` 的「名字前驱必须是
          * `(` `,` `{` `;` 修饰符」这一关，而三元表达式的中间段前面必然是 `?`。
@@ -702,6 +702,7 @@ var AdepWebContainer = (() => {
           if (this.afterFunctionKeyword) return true;
           if (this.tokenAt(2) === "function" && IDENT_START.test(this.tokenAt(1))) return true;
           if (this.afterArrow) return true;
+          if (this.tokenAt(1) === "async") return true;
           if (this.tokenAt(1) === "return") return true;
           if (this.inClassBody() && IDENT_PART.test(this.prevSignificantChar(at - 1))) return true;
           const prev = this.prevSignificantChar(at - 1);
@@ -1218,7 +1219,8 @@ var AdepWebContainer = (() => {
           '    if (u.pathname.indexOf("/api/") !== 0 && u.pathname !== "/api") {',
           "      return ORIGINAL_FETCH(input, init);",
           "    }",
-          "    if (window.parent === window) return ORIGINAL_FETCH(input, init);",
+          "    var bridgeWindow = window.parent !== window ? window.parent : window.opener;",
+          "    if (!bridgeWindow) return ORIGINAL_FETCH(input, init);",
           '    method = (method || "GET").toUpperCase();',
           "    var target = u.pathname + u.search;",
           "    return readBody(input, init).then(function (textBody) {",
@@ -1229,10 +1231,75 @@ var AdepWebContainer = (() => {
           `          resolve(new Response('{"error":{"code":"FN_PROXY_TIMEOUT","message":"\\u4e91\\u51fd\\u6570\\u6267\\u884c\\u8d85\\u65f6"}}', { status: 504, headers: { "content-type": "application/json" } }));`,
           "        }, TIMEOUT_MS);",
           "        pending[id] = { resolve: resolve, timer: timer };",
-          '        window.parent.postMessage({ __adepFnRequest: true, id: id, method: method, url: target, headers: headers, body: textBody }, "*");',
+          '        bridgeWindow.postMessage({ __adepFnRequest: true, id: id, method: method, url: target, headers: headers, body: textBody }, "*");',
           "      });",
           "    });",
           "  };",
+          "",
+          "  /* \u2014\u2014 blob URL SPA \u8DEF\u7531\u652F\u6301 \u2014\u2014",
+          "     blob: \u662F\u4E0D\u53EF\u5206\u5C42 scheme\uFF0Chistory.pushState('/about') \u5185\u90E8\u89E3\u6790\u76F8\u5BF9\u8DEF\u5F84\u4F1A\u629B",
+          "     TypeError \u2192 SPA history \u6A21\u5F0F\u8DEF\u7531\u5D29\u6E83\u3002patch pushState/replaceState\uFF0C\u5BF9\u76F8\u5BF9",
+          "     \u8DEF\u5F84\u76F4\u63A5\u541E\u6389\uFF08\u4E0D\u5BFC\u822A\u3001\u4E0D\u629B\u9519\uFF09\uFF0C\u8DEF\u7531\u5E93\u5185\u90E8\u72B6\u6001\u81EA\u884C\u66F4\u65B0\uFF1Blocation.pathname",
+          "     \u8986\u76D6\u4E3A\u5F53\u524D\u8DEF\u7531\u8DEF\u5F84\uFF0C\u4F9B\u8DEF\u7531\u5E93\u521D\u59CB\u5316\u65F6\u8BFB\u53D6\u3002sessionStorage \u6301\u4E45\u5316\uFF0C\u5237\u65B0\u540E\u6062\u590D\u3002 */",
+          '  if (window.location.protocol === "blob:") {',
+          '    var SPA_KEY = "__adep_spa_path";',
+          '    var spaPath = "/";',
+          "    try {",
+          "      var _saved = window.sessionStorage.getItem(SPA_KEY);",
+          "      if (_saved) spaPath = _saved;",
+          "    } catch (e) {}",
+          "    try {",
+          '      Object.defineProperty(window.location, "pathname", {',
+          "        get: function () { return spaPath; },",
+          "        configurable: true",
+          "      });",
+          "    } catch (e) {}",
+          "    var _origPush = window.history.pushState.bind(window.history);",
+          "    var _origReplace = window.history.replaceState.bind(window.history);",
+          "    function _isRelative(url) {",
+          '      if (!url || typeof url !== "string") return false;',
+          '      if (url.charAt(0) === "#") return false;',
+          "      if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(url)) return false;",
+          "      return true;",
+          "    }",
+          "    function _resolvePath(url) {",
+          '      var qi = url.indexOf("?");',
+          '      var hi = url.indexOf("#");',
+          "      var end = url.length;",
+          "      if (qi !== -1) end = qi;",
+          "      if (hi !== -1 && hi < end) end = hi;",
+          "      var p = url.slice(0, end);",
+          '      if (p.charAt(0) !== "/") {',
+          '        var base = spaPath.slice(0, spaPath.lastIndexOf("/") + 1);',
+          "        p = base + p;",
+          "      }",
+          '      var parts = p.split("/");',
+          "      var out = [];",
+          "      for (var i = 0; i < parts.length; i++) {",
+          "        var seg = parts[i];",
+          '        if (seg === "" || seg === ".") continue;',
+          '        if (seg === "..") { out.pop(); continue; }',
+          "        out.push(seg);",
+          "      }",
+          '      return "/" + out.join("/");',
+          "    }",
+          "    window.history.pushState = function (state, title, url) {",
+          "      if (_isRelative(url)) {",
+          "        spaPath = _resolvePath(url);",
+          "        try { window.sessionStorage.setItem(SPA_KEY, spaPath); } catch (e) {}",
+          "        return;",
+          "      }",
+          "      return _origPush(state, title, url);",
+          "    };",
+          "    window.history.replaceState = function (state, title, url) {",
+          "      if (_isRelative(url)) {",
+          "        spaPath = _resolvePath(url);",
+          "        try { window.sessionStorage.setItem(SPA_KEY, spaPath); } catch (e) {}",
+          "        return;",
+          "      }",
+          "      return _origReplace(state, title, url);",
+          "    };",
+          "  }",
           "})();"
         ].join("\n");
         return src;
@@ -1587,7 +1654,10 @@ var AdepWebContainer = (() => {
       lastDoc = doc;
       if (currentUrl !== "") revokeObjectURL(currentUrl);
       currentUrl = createObjectURL(new Blob([doc], { type: "text/html" }));
-      if (changed) broadcast(currentUrl);
+      if (changed) {
+        broadcast(currentUrl);
+        options.onDocumentChange?.(currentUrl);
+      }
     }
     const server = {
       get url() {
@@ -1689,6 +1759,7 @@ var AdepWebContainer = (() => {
   // src/index.ts
   var index_exports = {};
   __export(index_exports, {
+    BUNDLE_MODULE_PATH_PREFIX: () => BUNDLE_MODULE_PATH_PREFIX,
     COMPLETABLE_COMMANDS: () => COMPLETABLE_COMMANDS,
     DEFAULT_MAX_INSTALL_DEPTH: () => DEFAULT_MAX_INSTALL_DEPTH,
     EXTRA_COMMANDS: () => EXTRA_COMMANDS,
@@ -1734,12 +1805,15 @@ var AdepWebContainer = (() => {
     createViteServer: () => createViteServer,
     createWorkerRuntime: () => createWorkerRuntime,
     deepEqual: () => deepEqual,
+    defaultModuleName: () => defaultModuleName,
     displayPath: () => displayPath,
     entriesToTree: () => entriesToTree,
     evaluateModuleSource: () => evaluateModuleSource,
     evaluateSource: () => evaluateSource,
     exampleTestSource: () => exampleTestSource,
     expectAssertion: () => expect,
+    exportBundle: () => exportBundle,
+    findBlobRefs: () => findBlobRefs,
     formatTestReport: () => formatTestReport,
     formatValue: () => formatValue,
     fullName: () => fullName,
@@ -3711,7 +3785,11 @@ self.onmessage = async (event) => {
         const { createViteServer: createViteServer2 } = await Promise.resolve().then(() => (init_vite_dev(), vite_dev_exports));
         const server = createViteServer2(vfs, {
           root,
-          ...options.viteCompiler === void 0 ? {} : { sfcCompiler: options.viteCompiler }
+          ...options.viteCompiler === void 0 ? {} : { sfcCompiler: options.viteCompiler },
+          // PV-006：内容重建 → 以 `serverready`（update: true）事件上报新文档 URL，宿主导出预览产物。
+          onDocumentChange: (url) => {
+            emit("serverready", { port: server.port, url, kind: "vite", root: server.root, update: true });
+          }
         });
         await server.ready;
         viteServer = server;
@@ -3876,6 +3954,92 @@ self.onmessage = async (event) => {
   init_vite_dev();
   init_path();
 
+  // src/bundle-export.ts
+  var BUNDLE_MODULE_PATH_PREFIX = "/_adep/m/";
+  var BLOB_REF_RE = /blob:[^\s"'`<>()\\]+/g;
+  function fnv1a(code) {
+    let hash = 2166136261;
+    for (let i = 0; i < code.length; i++) {
+      hash ^= code.charCodeAt(i);
+      hash = Math.imul(hash, 16777619) >>> 0;
+    }
+    return `${hash.toString(16).padStart(8, "0")}${code.length.toString(16)}`;
+  }
+  async function defaultModuleName(code) {
+    const subtle = globalThis.crypto?.subtle;
+    if (subtle === void 0) return fnv1a(code);
+    const digest = await subtle.digest("SHA-256", new TextEncoder().encode(code));
+    let hex = "";
+    for (const byte of new Uint8Array(digest).slice(0, 8)) {
+      hex += byte.toString(16).padStart(2, "0");
+    }
+    return hex;
+  }
+  function findBlobRefs(text) {
+    const found = text.match(BLOB_REF_RE);
+    return found === null ? [] : [...new Set(found)];
+  }
+  function rewriteRefs(text, urls) {
+    let out = text;
+    for (const [blobUrl, path] of urls) {
+      if (out.includes(blobUrl)) out = out.split(blobUrl).join(path);
+    }
+    return out;
+  }
+  function injectScript(html, script) {
+    return /<\/body>/i.test(html) ? html.replace(/<\/body>/i, `${script}</body>`) : html + script;
+  }
+  async function exportBundle(options) {
+    const readText = options.readText ?? ((url) => fetch(url).then((response) => response.text()));
+    const nameOf = options.moduleName ?? defaultModuleName;
+    const prefix = options.modulePathPrefix ?? BUNDLE_MODULE_PATH_PREFIX;
+    const uploaded = new Set(options.known === void 0 ? [] : [...options.known.values()]);
+    const urls = /* @__PURE__ */ new Map();
+    const sources = [];
+    const readOrThrow = async (url) => {
+      try {
+        return await readText(url);
+      } catch (error) {
+        throw new Error(
+          `\u9884\u89C8\u4EA7\u7269\u5BFC\u51FA\u5931\u8D25\uFF1A\u8BFB\u4E0D\u5230\u6A21\u5757 ${url}\uFF08${error instanceof Error ? error.message : String(error)}\uFF09`,
+          { cause: error }
+        );
+      }
+    };
+    const html = await readOrThrow(options.documentUrl);
+    const loadLayer = async (layer) => {
+      const batch = [...new Set(layer)].filter((url) => !urls.has(url));
+      if (batch.length === 0) return;
+      const loaded = await Promise.all(
+        batch.map(async (url) => {
+          const code = await readOrThrow(url);
+          return { url, code, path: `${prefix}${await nameOf(code)}.js` };
+        })
+      );
+      const next = [];
+      for (const item of loaded) {
+        urls.set(item.url, item.path);
+        sources.push({ url: item.url, code: item.code });
+        next.push(...findBlobRefs(item.code));
+      }
+      await loadLayer(next);
+    };
+    await loadLayer(findBlobRefs(html));
+    const modules = {};
+    for (const { url, code } of sources) {
+      const path = urls.get(url);
+      if (uploaded.has(path)) continue;
+      modules[path] = rewriteRefs(code, urls);
+    }
+    const rewrittenHtml = rewriteRefs(html, urls);
+    return {
+      html: options.appendScript === void 0 ? rewrittenHtml : injectScript(rewrittenHtml, options.appendScript),
+      modules,
+      paths: [...new Set(urls.values())].toSorted(),
+      urls
+    };
+  }
+
   // src/persistence.ts
   function cloneEntries(entries) {
     return entries.map(
@@ -5637,6 +5801,17 @@ self.onmessage = async (event) => {
         }
         return { changes: 0 };
       }
+      if (/^CREATE\s+(?:UNIQUE\s+)?INDEX\s+(?:IF\s+NOT\s+EXISTS\s+)?/i.test(stmt)) {
+        const idx = /^CREATE\s+(?:UNIQUE\s+)?INDEX\s+(?:IF\s+NOT\s+EXISTS\s+)?((?:"[^"]+")|([A-Za-z_][A-Za-z0-9_]*))\s+ON\s+((?:"[^"]+")|([A-Za-z_][A-Za-z0-9_]*))/i.exec(
+          stmt
+        );
+        if (idx === null) throw new SimDbError("DB_UNSAFE_OP", `\u65E0\u6CD5\u89E3\u6790 CREATE INDEX \u8BED\u53E5`);
+        const tableName = ident(idx[3]);
+        if (this.tables[tableName] === void 0) {
+          throw new SimDbError("DB_UNSAFE_OP", `CREATE INDEX \u76EE\u6807\u8868\u4E0D\u5B58\u5728\uFF1A${tableName}`);
+        }
+        return { changes: 0 };
+      }
       if (/^INSERT\s+INTO/i.test(stmt)) return this.execInsert(stmt, params);
       if (/^UPDATE\s+/i.test(stmt)) return this.execUpdate(stmt, params);
       if (/^DELETE\s+FROM/i.test(stmt)) return this.execDelete(stmt, params);
@@ -5881,6 +6056,19 @@ self.onmessage = async (event) => {
     }
     return path;
   }
+  function assertStoragePrefix(prefix) {
+    if (prefix !== void 0 && prefix !== "") {
+      const segments = prefix.split("/");
+      if (prefix.startsWith("/") || /[\\]/.test(prefix) || segments.some((segment) => segment === "..")) {
+        throw new StorageError(
+          400,
+          STORAGE_CODES.invalidPath,
+          `\u975E\u6CD5\u524D\u7F00 "${prefix}"\uFF08\u7981\u6B62 / \u5F00\u5934\u3001\u53CD\u659C\u6760\u6216 .. \u7A7F\u8D8A\uFF09`
+        );
+      }
+    }
+    return prefix ?? "";
+  }
 
   // ../runtime/src/storage/hmac-sha256.ts
   var K = new Uint32Array([
@@ -6200,16 +6388,7 @@ self.onmessage = async (event) => {
         await saveBucket(bucket);
       },
       async list(_projectId, prefix) {
-        if (prefix !== void 0 && prefix !== "") {
-          const segments = prefix.split("/");
-          if (prefix.startsWith("/") || /[\\]/.test(prefix) || segments.some((segment) => segment === "..")) {
-            throw new StorageError(
-              400,
-              STORAGE_CODES.invalidPath,
-              `\u975E\u6CD5\u524D\u7F00 "${prefix}"\uFF08\u7981\u6B62 / \u5F00\u5934\u3001\u53CD\u659C\u6760\u6216 .. \u7A7F\u8D8A\uFF09`
-            );
-          }
-        }
+        assertStoragePrefix(prefix);
         const bucket = await loadBucket();
         return Object.values(bucket).filter((object) => prefix === void 0 || object.path.startsWith(prefix)).map(toMeta).toSorted((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
       },
@@ -6596,6 +6775,19 @@ self.onmessage = async (event) => {
     };
   }
 
+  // ../runtime/src/functions/runtime/rpc-wire.ts
+  function wireRpcResponses(port, pending) {
+    port.on?.((message) => {
+      const reply = message;
+      if (reply?.type !== "rpc-response" || typeof reply.id !== "number") return;
+      const entry = pending.get(reply.id);
+      if (entry === void 0) return;
+      pending.delete(reply.id);
+      if (reply.ok === true) entry.resolve(reply.result);
+      else entry.reject(new Error(reply.error ?? "RPC \u80FD\u529B\u8C03\u7528\u5931\u8D25"));
+    });
+  }
+
   // src/sim/ctx.ts
   function createLocalPort(handler) {
     const listeners = [];
@@ -6625,17 +6817,6 @@ self.onmessage = async (event) => {
       }
     };
   }
-  function wireRpcResponses(port, pending) {
-    port.on((message) => {
-      const reply = message;
-      if (reply?.type !== "rpc-response" || typeof reply.id !== "number") return;
-      const entry = pending.get(reply.id);
-      if (entry === void 0) return;
-      pending.delete(reply.id);
-      if (reply.ok === true) entry.resolve(reply.result);
-      else entry.reject(new Error(reply.error ?? "RPC \u80FD\u529B\u8C03\u7528\u5931\u8D25"));
-    });
-  }
   function createFlatRpcClient(handler) {
     return new Proxy(
       {},
@@ -6849,6 +7030,27 @@ self.onmessage = async (event) => {
     return { run };
   }
 
+  // ../runtime/src/sim/merge.ts
+  function mergeBundles(bundles) {
+    const capabilities = [];
+    const byName = /* @__PURE__ */ new Map();
+    for (const bundle of bundles) {
+      for (const cap of bundle.capabilities) {
+        const existing = byName.get(cap.name);
+        if (existing !== void 0) capabilities.splice(capabilities.indexOf(existing), 1);
+        byName.set(cap.name, cap);
+        capabilities.push(cap);
+      }
+    }
+    const rpcHandlers = {};
+    for (const bundle of bundles) {
+      for (const [name, handler] of Object.entries(bundle.rpcHandlers)) {
+        rpcHandlers[name] = handler;
+      }
+    }
+    return { capabilities, rpcHandlers };
+  }
+
   // ../runtime/src/database/sdk/kv.ts
   var KV_TABLE = "_adep_kv";
   var KV_RPC = {
@@ -6950,25 +7152,6 @@ self.onmessage = async (event) => {
   }
 
   // src/sim/runtime.ts
-  function mergeBundles(bundles) {
-    const capabilities = [];
-    const byName = /* @__PURE__ */ new Map();
-    for (const bundle of bundles) {
-      for (const cap of bundle.capabilities) {
-        const existing = byName.get(cap.name);
-        if (existing !== void 0) capabilities.splice(capabilities.indexOf(existing), 1);
-        byName.set(cap.name, cap);
-        capabilities.push(cap);
-      }
-    }
-    const rpcHandlers = {};
-    for (const bundle of bundles) {
-      for (const [name, handler] of Object.entries(bundle.rpcHandlers)) {
-        rpcHandlers[name] = handler;
-      }
-    }
-    return { capabilities, rpcHandlers };
-  }
   async function createBrowserSimRuntime(options) {
     const kv = options.kv ?? pickDefaultSimKv();
     const db = createBrowserSimDb({ projectId: options.projectId, kv });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adep/web-container",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "private": false,
   "type": "module",
   "sideEffects": false,
@@ -11,8 +11,8 @@
     "dist"
   ],
   "dependencies": {
-    "@adep/runtime": "0.2.2",
-    "@adep/types": "0.2.2"
+    "@adep/runtime": "0.2.3",
+    "@adep/types": "0.2.3"
   },
   "scripts": {
     "test": "vitest run",