@weapp-vite/devtools-runtime 0.2.3 → 0.3.1

package/dist/index.d.ts

@@ -1,26 +1,10 @@
-import { Element, MiniProgram, Page } from "@weapp-vite/miniprogram-automator";
+import { AutomatorElement, AutomatorMiniProgram, AutomatorPage, DevtoolsConnectionInput, DevtoolsContext, DevtoolsElementSnapshot, DevtoolsPageSnapshot, DevtoolsRuntimeHooks, DevtoolsRuntimeSessionOptions, DevtoolsToolResult, MiniProgramElementLike, readDevtoolsElementSnapshot, resolveDevtoolsProjectPath, resolveDevtoolsWorkspacePath, toDevtoolsSerializableValue } from "./mcp.js";
 
 //#region src/index.d.ts
 interface MiniProgramEventMap {
   console: (payload: unknown) => void;
   exception: (payload: unknown) => void;
 }
-type AutomatorMiniProgram = InstanceType<typeof MiniProgram>;
-type AutomatorPage = InstanceType<typeof Page>;
-type AutomatorElement = InstanceType<typeof Element> & {
-  input?: (value: string) => Promise<void>;
-};
-interface DevtoolsRuntimeSessionOptions {
-  miniProgram?: AutomatorMiniProgram;
-  preferOpenedSession?: boolean;
-  projectPath: string;
-  sharedSession?: boolean;
-  timeout?: number;
-}
-interface DevtoolsRuntimeHooks {
-  connectMiniProgram: (options: DevtoolsRuntimeSessionOptions) => Promise<AutomatorMiniProgram>;
-  normalizeConnectionError?: (error: unknown) => unknown;
-}
 /**
  * @description 获取指定项目的共享 automator 会话；若不存在则自动创建。
  */
@@ -42,4 +26,4 @@ declare function getSharedMiniProgramSessionCount(): number;
  */
 declare function withMiniProgram<T>(hooks: DevtoolsRuntimeHooks, options: DevtoolsRuntimeSessionOptions, runner: (miniProgram: AutomatorMiniProgram) => Promise<T>): Promise<T>;
 //#endregion
-export { AutomatorElement, AutomatorMiniProgram, AutomatorPage, DevtoolsRuntimeHooks, DevtoolsRuntimeSessionOptions, MiniProgramEventMap, acquireSharedMiniProgram, closeSharedMiniProgram, getSharedMiniProgramSessionCount, releaseSharedMiniProgram, withMiniProgram };
+export { type AutomatorElement, type AutomatorMiniProgram, type AutomatorPage, type DevtoolsConnectionInput, type DevtoolsContext, type DevtoolsElementSnapshot, type DevtoolsPageSnapshot, type DevtoolsRuntimeHooks, type DevtoolsRuntimeSessionOptions, type DevtoolsToolResult, type MiniProgramElementLike, MiniProgramEventMap, acquireSharedMiniProgram, closeSharedMiniProgram, getSharedMiniProgramSessionCount, readDevtoolsElementSnapshot, releaseSharedMiniProgram, resolveDevtoolsProjectPath, resolveDevtoolsWorkspacePath, toDevtoolsSerializableValue, withMiniProgram };

package/dist/index.js

@@ -1,3 +1,4 @@
+import { readDevtoolsElementSnapshot, resolveDevtoolsProjectPath, resolveDevtoolsWorkspacePath, toDevtoolsSerializableValue } from "./mcp.js";
 //#region src/index.ts
 const sharedMiniProgramSessions = /* @__PURE__ */ new Map();
 function normalizeError(hooks, error) {
@@ -76,4 +77,4 @@ async function withMiniProgram(hooks, options, runner) {
 	}
 }
 //#endregion
-export { acquireSharedMiniProgram, closeSharedMiniProgram, getSharedMiniProgramSessionCount, releaseSharedMiniProgram, withMiniProgram };
+export { acquireSharedMiniProgram, closeSharedMiniProgram, getSharedMiniProgramSessionCount, readDevtoolsElementSnapshot, releaseSharedMiniProgram, resolveDevtoolsProjectPath, resolveDevtoolsWorkspacePath, toDevtoolsSerializableValue, withMiniProgram };

package/dist/mcp.d.ts

@@ -0,0 +1,70 @@
+import { Element, MiniProgram, Page } from "@weapp-vite/miniprogram-automator";
+
+//#region src/mcp.d.ts
+type AutomatorMiniProgram = InstanceType<typeof MiniProgram>;
+type AutomatorPage = InstanceType<typeof Page>;
+type AutomatorElement = InstanceType<typeof Element> & {
+  input?: (value: string) => Promise<void>;
+};
+interface DevtoolsRuntimeSessionOptions {
+  miniProgram?: AutomatorMiniProgram;
+  preferOpenedSession?: boolean;
+  projectPath: string;
+  sharedSession?: boolean;
+  timeout?: number;
+}
+interface DevtoolsRuntimeHooks {
+  connectMiniProgram: (options: DevtoolsRuntimeSessionOptions) => Promise<AutomatorMiniProgram>;
+  normalizeConnectionError?: (error: unknown) => unknown;
+}
+interface DevtoolsConnectionInput {
+  projectPath: string;
+  timeout?: number;
+  preferOpenedSession?: boolean;
+}
+interface DevtoolsElementSnapshot {
+  selector: string;
+  tagName: string;
+  text: string | null;
+  value: unknown;
+  attributes: Record<string, unknown>;
+  styles: Record<string, unknown>;
+  offset: unknown;
+  size: unknown;
+  wxml: string | null;
+  outerWxml: string | null;
+}
+interface DevtoolsPageSnapshot {
+  path: string;
+  query: unknown;
+  size: unknown;
+  scrollTop: unknown;
+  data: unknown;
+}
+interface DevtoolsContext {
+  miniProgram: AutomatorMiniProgram;
+  page: AutomatorPage;
+}
+interface DevtoolsToolResult<T> {
+  result: T;
+}
+interface MiniProgramElementLike {
+  tagName?: string;
+  $?: (selector: string) => Promise<MiniProgramElementLike | null>;
+  $$?: (selector: string) => Promise<MiniProgramElementLike[]>;
+  attribute?: (name: string) => Promise<unknown>;
+  offset?: () => Promise<unknown>;
+  outerWxml?: () => Promise<unknown>;
+  size?: () => Promise<unknown>;
+  style?: (name: string) => Promise<unknown>;
+  tap: () => Promise<void>;
+  text?: () => Promise<unknown>;
+  value?: () => Promise<unknown>;
+  wxml?: () => Promise<unknown>;
+}
+declare function resolveDevtoolsProjectPath(workspaceRoot: string, projectPath: string): string;
+declare function resolveDevtoolsWorkspacePath(workspaceRoot: string, filePath: string): string;
+declare function toDevtoolsSerializableValue(value: unknown): unknown;
+declare function readDevtoolsElementSnapshot(element: MiniProgramElementLike, selector: string, attributeNames?: readonly string[], styleNames?: readonly string[]): Promise<DevtoolsElementSnapshot>;
+//#endregion
+export { AutomatorElement, AutomatorMiniProgram, AutomatorPage, DevtoolsConnectionInput, DevtoolsContext, DevtoolsElementSnapshot, DevtoolsPageSnapshot, DevtoolsRuntimeHooks, DevtoolsRuntimeSessionOptions, DevtoolsToolResult, MiniProgramElementLike, readDevtoolsElementSnapshot, resolveDevtoolsProjectPath, resolveDevtoolsWorkspacePath, toDevtoolsSerializableValue };

package/dist/mcp.js

@@ -0,0 +1,62 @@
+import { Buffer } from "node:buffer";
+import path from "node:path";
+//#region src/mcp.ts
+function resolveDevtoolsProjectPath(workspaceRoot, projectPath) {
+	return path.isAbsolute(projectPath) ? path.normalize(projectPath) : path.resolve(workspaceRoot, projectPath);
+}
+function resolveDevtoolsWorkspacePath(workspaceRoot, filePath) {
+	return path.isAbsolute(filePath) ? path.normalize(filePath) : path.resolve(workspaceRoot, filePath);
+}
+function toDevtoolsSerializableValue(value) {
+	if (value == null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
+	if (value instanceof Error) return {
+		message: value.message,
+		name: value.name,
+		stack: value.stack
+	};
+	if (typeof value === "bigint") return value.toString();
+	if (value instanceof Date) return value.toISOString();
+	if (Buffer.isBuffer(value)) return value.toString("base64");
+	if (Array.isArray(value)) return value.map((item) => toDevtoolsSerializableValue(item));
+	if (typeof value === "object") return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, toDevtoolsSerializableValue(item)]));
+	return String(value);
+}
+async function callOptionalElementMethod(element, methodName, fallback, ...args) {
+	const method = Reflect.get(element, methodName);
+	if (typeof method !== "function") return fallback;
+	try {
+		return await method.apply(element, args);
+	} catch {
+		return fallback;
+	}
+}
+async function readDevtoolsElementSnapshot(element, selector, attributeNames = [], styleNames = []) {
+	const [text, value, offset, size, wxml, outerWxml] = await Promise.all([
+		callOptionalElementMethod(element, "text", null),
+		callOptionalElementMethod(element, "value", void 0),
+		callOptionalElementMethod(element, "offset", null),
+		callOptionalElementMethod(element, "size", null),
+		callOptionalElementMethod(element, "wxml", null),
+		callOptionalElementMethod(element, "outerWxml", null)
+	]);
+	const attributes = Object.fromEntries(await Promise.all(attributeNames.map(async (name) => {
+		return [name, await callOptionalElementMethod(element, "attribute", null, name)];
+	})));
+	const styles = Object.fromEntries(await Promise.all(styleNames.map(async (name) => {
+		return [name, await callOptionalElementMethod(element, "style", null, name)];
+	})));
+	return {
+		selector,
+		tagName: element.tagName ?? "",
+		text: typeof text === "string" ? text : null,
+		value: toDevtoolsSerializableValue(value),
+		attributes,
+		styles,
+		offset: toDevtoolsSerializableValue(offset),
+		size: toDevtoolsSerializableValue(size),
+		wxml: typeof wxml === "string" ? wxml : null,
+		outerWxml: typeof outerWxml === "string" ? outerWxml : null
+	};
+}
+//#endregion
+export { readDevtoolsElementSnapshot, resolveDevtoolsProjectPath, resolveDevtoolsWorkspacePath, toDevtoolsSerializableValue };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@weapp-vite/devtools-runtime",
   "type": "module",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "Shared WeChat DevTools runtime automation helpers for weapp-vite packages",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -18,6 +18,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp.d.ts",
+      "import": "./dist/mcp.js"
     }
   },
   "main": "./dist/index.js",
@@ -34,7 +38,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@weapp-vite/miniprogram-automator": "1.1.1"
+    "@weapp-vite/miniprogram-automator": "1.1.2"
   },
   "scripts": {
     "dev": "tsdown -w --sourcemap",