@dimina-kit/devtools 0.3.1-dev.20260518114324 → 0.3.2-dev.20260522085907

package/dist/preload/instrumentation/app-data.js

@@ -1,59 +1,4 @@
-import { SimulatorChannel, BridgeChannel } from '../../shared/ipc-channels.js';
-import { onHostMessage, sendToHost } from '../runtime/host.js';
 import { clearAppDataSnapshot, setAppDataSnapshot, } from '../runtime/bridge.js';
-import { createDisposableSet } from './disposable.js';
-const appDataCache = new Map();
-// Bridges in insertion order — drives the `bridges` array in snapshots so
-// renderer tabs render in a stable, chronological sequence.
-const bridgeOrder = [];
-// Page path per bridge: set from `page_*` init's body.path. Component init
-// also carries a path but it's the component's own path, not the page route.
-const bridgePagePath = new Map();
-function recordBridge(bridgeId) {
-    if (!bridgeOrder.includes(bridgeId))
-        bridgeOrder.push(bridgeId);
-}
-function buildSnapshot() {
-    const bridges = [];
-    for (const id of bridgeOrder) {
-        bridges.push({ id, pagePath: bridgePagePath.get(id) ?? null });
-    }
-    const entries = {};
-    for (const [key, entry] of appDataCache) {
-        const slash = key.indexOf('/');
-        if (slash < 0)
-            continue;
-        const bridgeId = key.slice(0, slash);
-        const moduleId = key.slice(slash + 1);
-        if (!entries[bridgeId])
-            entries[bridgeId] = {};
-        const displayKey = entry.componentPath ?? moduleId;
-        entries[bridgeId][displayKey] = entry.data;
-    }
-    return { bridges, entries };
-}
-function publishSnapshot() {
-    const data = {};
-    for (const [key, entry] of appDataCache) {
-        data[key] = entry.data;
-    }
-    setAppDataSnapshot(data);
-}
-function clearBridge(bridgeId) {
-    const prefix = `${bridgeId}/`;
-    for (const key of [...appDataCache.keys()]) {
-        if (key.startsWith(prefix))
-            appDataCache.delete(key);
-    }
-    const idx = bridgeOrder.indexOf(bridgeId);
-    if (idx >= 0)
-        bridgeOrder.splice(idx, 1);
-    bridgePagePath.delete(bridgeId);
-    publishSnapshot();
-    // Push a refreshed snapshot so the renderer can drop the evicted bridge
-    // immediately, without waiting for the user to hit the refresh button.
-    sendToHost(SimulatorChannel.AppDataAll, buildSnapshot());
-}
 // dimina runtime emits two kinds of service→main messages relevant to the
 // AppData panel:
 //  • update batches `{type:'ub', body:{bridgeId, updates:[{moduleId,data}]}}`
@@ -132,131 +77,201 @@ function decodeOutgoingMessage(message) {
         bridgeId: typeof r.body?.bridgeId === 'string' ? r.body.bridgeId : undefined,
     };
 }
-function instrumentPostMessage(worker) {
-    const orig = worker.postMessage.bind(worker);
-    worker.postMessage = function (msg, ...rest) {
-        const decoded = decodeOutgoingMessage(msg);
-        if (decoded?.type === 'pageUnload' && decoded.bridgeId) {
-            clearBridge(decoded.bridgeId);
+/**
+ * The AppData snapshot data source.
+ *
+ * Instruments `window.Worker` (incoming `message` decoding + outgoing
+ * `postMessage` interception) and installs `window.__simulatorHook.appData`,
+ * accumulating per-(bridgeId, moduleId) setData state in an internal cache.
+ * Every cache mutation — an accepted `ub`/`page_*` worker message, or a
+ * `pageUnload` evicting a bridge — calls `emit()` so the `miniappSnapshot`
+ * host republishes the full snapshot. The source itself never touches IPC:
+ * the host owns push, pull and the install-time publish.
+ *
+ * It keeps the `__simulatorData.getAppdata()` automation surface working by
+ * mirroring the flat cache into the simulator bridge via `setAppDataSnapshot`
+ * / `clearAppDataSnapshot`.
+ */
+export function createAppDataSource() {
+    const appDataCache = new Map();
+    // Bridges in insertion order — drives the `bridges` array in snapshots so
+    // renderer tabs render in a stable, chronological sequence.
+    const bridgeOrder = [];
+    // Page path per bridge: set from `page_*` init's body.path. Component init
+    // also carries a path but it's the component's own path, not the page route.
+    const bridgePagePath = new Map();
+    let emit = null;
+    let installed = false;
+    let originalHook;
+    let originalDescriptor;
+    let OriginalWorker;
+    function recordBridge(bridgeId) {
+        if (!bridgeOrder.includes(bridgeId))
+            bridgeOrder.push(bridgeId);
+    }
+    function buildSnapshot() {
+        const bridges = [];
+        for (const id of bridgeOrder) {
+            bridges.push({ id, pagePath: bridgePagePath.get(id) ?? null });
         }
-        return orig(msg, ...rest);
-    };
-}
-function createInstrumentedWorker(OriginalWorker) {
-    function InstrumentedWorker(scriptURL, options) {
-        const resolvedScriptURL = scriptURL instanceof URL
-            ? scriptURL
-            : new URL(scriptURL, window.location.href);
-        const worker = Reflect.construct(OriginalWorker, [resolvedScriptURL, options], new.target ?? InstrumentedWorker);
-        instrumentPostMessage(worker);
-        worker.addEventListener('message', (event) => {
-            const entries = decodeWorkerMessage(event.data);
-            if (!entries)
-                return;
-            for (const entry of entries) {
-                const hookBody = {
-                    bridgeId: entry.bridgeId,
-                    moduleId: entry.moduleId,
-                    data: entry.data,
-                    mode: entry.mode,
-                };
-                if (entry.mode === 'init')
-                    hookBody.componentPath = entry.componentPath;
-                window.__simulatorHook?.appData(hookBody);
+        const entries = {};
+        for (const [key, entry] of appDataCache) {
+            const slash = key.indexOf('/');
+            if (slash < 0)
+                continue;
+            const bridgeId = key.slice(0, slash);
+            const moduleId = key.slice(slash + 1);
+            if (!entries[bridgeId])
+                entries[bridgeId] = {};
+            const displayKey = entry.componentPath ?? moduleId;
+            entries[bridgeId][displayKey] = entry.data;
+        }
+        return { bridges, entries };
+    }
+    // Mirror the flat cache into the `__simulatorData.getAppdata()` automation
+    // surface so MCP / e2e reads keep working after the snapshot migration.
+    function publishSnapshot() {
+        const data = {};
+        for (const [key, entry] of appDataCache) {
+            data[key] = entry.data;
+        }
+        setAppDataSnapshot(data);
+    }
+    function clearBridge(bridgeId) {
+        const prefix = `${bridgeId}/`;
+        for (const key of [...appDataCache.keys()]) {
+            if (key.startsWith(prefix))
+                appDataCache.delete(key);
+        }
+        const idx = bridgeOrder.indexOf(bridgeId);
+        if (idx >= 0)
+            bridgeOrder.splice(idx, 1);
+        bridgePagePath.delete(bridgeId);
+        publishSnapshot();
+        // The eviction is a cache mutation — notify the host so the renderer can
+        // drop the evicted bridge's tab immediately.
+        emit?.();
+    }
+    function applyAppData(body) {
+        const record = body;
+        if (!record?.bridgeId || !record?.moduleId)
+            return;
+        // R6: drop ub patches whose bridge has never been initialised. dimina
+        // dispatches pageUnload to the service worker, which fires onUnload —
+        // and onUnload's setData (e.g. console-test's stopTimer) produces a
+        // late `ub` that arrives AFTER our clearBridge. Without this gate the
+        // late patch would resurrect the unloaded bridge as a ghost tab.
+        if (record.mode !== 'init' && !bridgePagePath.has(record.bridgeId))
+            return;
+        const key = `${record.bridgeId}/${record.moduleId}`;
+        const prev = appDataCache.get(key);
+        const incoming = (record.data && typeof record.data === 'object'
+            ? record.data
+            : {});
+        // init = full-state replace; patch = merge into previous (setData semantics)
+        const merged = record.mode === 'init'
+            ? { ...incoming }
+            : { ...(prev?.data ?? {}), ...incoming };
+        const componentPath = record.componentPath ?? prev?.componentPath;
+        const next = componentPath !== undefined
+            ? { componentPath, data: merged }
+            : { data: merged };
+        appDataCache.set(key, next);
+        recordBridge(record.bridgeId);
+        if (record.mode === 'init'
+            && record.moduleId.startsWith('page_')
+            && record.componentPath) {
+            bridgePagePath.set(record.bridgeId, record.componentPath);
+        }
+        publishSnapshot();
+        emit?.();
+    }
+    function instrumentPostMessage(worker) {
+        const orig = worker.postMessage.bind(worker);
+        worker.postMessage = function (msg, ...rest) {
+            const decoded = decodeOutgoingMessage(msg);
+            if (decoded?.type === 'pageUnload' && decoded.bridgeId) {
+                clearBridge(decoded.bridgeId);
             }
+            return orig(msg, ...rest);
+        };
+    }
+    function createInstrumentedWorker(Original) {
+        function InstrumentedWorker(scriptURL, options) {
+            const resolvedScriptURL = scriptURL instanceof URL
+                ? scriptURL
+                : new URL(scriptURL, window.location.href);
+            const worker = Reflect.construct(Original, [resolvedScriptURL, options], new.target ?? InstrumentedWorker);
+            instrumentPostMessage(worker);
+            worker.addEventListener('message', (event) => {
+                const entries = decodeWorkerMessage(event.data);
+                if (!entries)
+                    return;
+                for (const entry of entries) {
+                    const hookBody = {
+                        bridgeId: entry.bridgeId,
+                        moduleId: entry.moduleId,
+                        data: entry.data,
+                        mode: entry.mode,
+                    };
+                    if (entry.mode === 'init')
+                        hookBody.componentPath = entry.componentPath;
+                    window.__simulatorHook?.appData(hookBody);
+                }
+            });
+            return worker;
+        }
+        Object.setPrototypeOf(InstrumentedWorker, Original);
+        Object.defineProperty(InstrumentedWorker, 'prototype', {
+            value: Original.prototype,
         });
-        return worker;
+        return InstrumentedWorker;
     }
-    Object.setPrototypeOf(InstrumentedWorker, OriginalWorker);
-    Object.defineProperty(InstrumentedWorker, 'prototype', {
-        value: OriginalWorker.prototype,
-    });
-    return InstrumentedWorker;
-}
-export function installAppDataInstrumentation() {
-    const disposables = createDisposableSet();
-    const originalHook = window.__simulatorHook;
-    const originalDescriptor = Object.getOwnPropertyDescriptor(window, 'Worker');
-    const OriginalWorker = window.Worker;
-    window.__simulatorHook = {
-        appData: (body) => {
-            const record = body;
-            if (!record?.bridgeId || !record?.moduleId)
+    return {
+        id: 'appdata',
+        snapshot: () => buildSnapshot(),
+        start(onChange) {
+            if (installed)
                 return;
-            // R6: drop ub patches whose bridge has never been initialised. dimina
-            // dispatches pageUnload to the service worker, which fires onUnload —
-            // and onUnload's setData (e.g. console-test's stopTimer) produces a
-            // late `ub` that arrives AFTER our clearBridge. Without this gate the
-            // late patch would resurrect the unloaded bridge as a ghost tab.
-            if (record.mode !== 'init' && !bridgePagePath.has(record.bridgeId))
+            installed = true;
+            emit = onChange;
+            originalHook = window.__simulatorHook;
+            originalDescriptor = Object.getOwnPropertyDescriptor(window, 'Worker');
+            OriginalWorker = window.Worker;
+            window.__simulatorHook = {
+                appData: (body) => applyAppData(body),
+            };
+            Object.defineProperty(window, 'Worker', {
+                configurable: true,
+                writable: true,
+                value: createInstrumentedWorker(OriginalWorker),
+            });
+        },
+        dispose() {
+            if (!installed)
                 return;
-            const key = `${record.bridgeId}/${record.moduleId}`;
-            const prev = appDataCache.get(key);
-            const incoming = (record.data && typeof record.data === 'object'
-                ? record.data
-                : {});
-            // init = full-state replace; patch = merge into previous (setData semantics)
-            const merged = record.mode === 'init'
-                ? { ...incoming }
-                : { ...(prev?.data ?? {}), ...incoming };
-            const componentPath = record.componentPath ?? prev?.componentPath;
-            const next = componentPath !== undefined
-                ? { componentPath, data: merged }
-                : { data: merged };
-            appDataCache.set(key, next);
-            recordBridge(record.bridgeId);
-            if (record.mode === 'init'
-                && record.moduleId.startsWith('page_')
-                && record.componentPath) {
-                bridgePagePath.set(record.bridgeId, record.componentPath);
+            installed = false;
+            if (originalDescriptor) {
+                Object.defineProperty(window, 'Worker', originalDescriptor);
             }
-            publishSnapshot();
-            const payload = {
-                bridgeId: record.bridgeId,
-                moduleId: record.moduleId,
-                data: merged,
-            };
-            if (componentPath !== undefined)
-                payload.componentPath = componentPath;
-            sendToHost(SimulatorChannel.AppData, payload);
+            else if (OriginalWorker) {
+                window.Worker = OriginalWorker;
+            }
+            if (originalHook) {
+                window.__simulatorHook = originalHook;
+            }
+            else {
+                delete window.__simulatorHook;
+            }
+            originalDescriptor = undefined;
+            OriginalWorker = undefined;
+            originalHook = undefined;
+            appDataCache.clear();
+            bridgeOrder.length = 0;
+            bridgePagePath.clear();
+            clearAppDataSnapshot();
+            emit = null;
         },
     };
-    Object.defineProperty(window, 'Worker', {
-        configurable: true,
-        writable: true,
-        value: createInstrumentedWorker(OriginalWorker),
-    });
-    disposables.add(onHostMessage(BridgeChannel.AppDataGetAllRequest, () => sendAllAppData()));
-    publishSnapshot();
-    disposables.add(() => {
-        if (originalDescriptor) {
-            Object.defineProperty(window, 'Worker', originalDescriptor);
-        }
-        else {
-            window.Worker = OriginalWorker;
-        }
-    });
-    disposables.add(() => {
-        if (originalHook) {
-            window.__simulatorHook = originalHook;
-        }
-        else {
-            delete window.__simulatorHook;
-        }
-    });
-    disposables.add(() => {
-        appDataCache.clear();
-        bridgeOrder.length = 0;
-        bridgePagePath.clear();
-        clearAppDataSnapshot();
-        publishSnapshot();
-    });
-    return () => {
-        disposables.disposeAll();
-    };
-}
-export function sendAllAppData() {
-    publishSnapshot();
-    sendToHost(SimulatorChannel.AppDataAll, buildSnapshot());
 }
 //# sourceMappingURL=app-data.js.map

package/dist/preload/instrumentation/index.d.ts

@@ -1,4 +1,4 @@
 export { installConsoleInstrumentation } from './console.js';
-export { installAppDataInstrumentation, sendAllAppData } from './app-data.js';
-export { installWxmlInstrumentation, sendWxmlTree, setupWxmlObserver } from './wxml.js';
+export { createAppDataSource, type AppDataSnapshot } from './app-data.js';
+export { createWxmlSource } from './wxml.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/preload/instrumentation/index.js

@@ -1,4 +1,4 @@
 export { installConsoleInstrumentation } from './console.js';
-export { installAppDataInstrumentation, sendAllAppData } from './app-data.js';
-export { installWxmlInstrumentation, sendWxmlTree, setupWxmlObserver } from './wxml.js';
+export { createAppDataSource } from './app-data.js';
+export { createWxmlSource } from './wxml.js';
 //# sourceMappingURL=index.js.map

package/dist/preload/instrumentation/wxml.d.ts

@@ -1,5 +1,17 @@
-declare function sendWxmlTree(): void;
-export declare function installWxmlInstrumentation(): () => void;
-export declare const setupWxmlObserver: typeof installWxmlInstrumentation;
-export { sendWxmlTree };
+import { type WxmlNode } from '../runtime/bridge.js';
+import type { MiniappSnapshotSource } from '../miniapp-snapshot/types.js';
+/**
+ * The WXML snapshot data source.
+ *
+ * Observes the simulator page's Vue tree (retry-attach + MutationObserver +
+ * top-level navigation observer), recomputes a normalized {@link WxmlNode}
+ * tree on every (debounced) change, stores it internally, and calls `emit()`
+ * so the `miniappSnapshot` host publishes it. The source itself never touches
+ * IPC — the host owns the push/pull transport and the install-time publish.
+ *
+ * It keeps the `__simulatorData.getWxml()` automation surface working by
+ * mirroring each computed tree into the simulator bridge via
+ * `setWxmlSnapshot` / `clearWxmlSnapshot`.
+ */
+export declare function createWxmlSource(): MiniappSnapshotSource<WxmlNode | null>;
 //# sourceMappingURL=wxml.d.ts.map