@opentiny/next-sdk 0.4.0 → 0.4.2

package/dist/utils/builtinProxy.d.ts

@@ -2,6 +2,6 @@ import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 
 /**
  * 建立原生的 JSON-RPC 拦截层：
- * 将发向 remote 的 MCP 请求拦截，代理给所在浏览器的 navigator.modelContextTesting 上执行。
+ * 将发向 remote 的 MCP 请求拦截，代理给所在浏览器的 document.modelContext 上执行。
  */
 export declare const setupBuiltinProxy: (transport: Transport) => void;

package/dist/vitest.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vite').UserConfig;
+export default _default;

package/index.ts

@@ -21,11 +21,6 @@ export type * from '@modelcontextprotocol/sdk/server/mcp.js'
 export * from './WebMcpServer'
 export * from './WebMcpClient'
 
-// 浏览器扩展自定义传输层
-export * from './transport/ExtensionClientTransport'
-export * from './transport/ExtensionPageServerTransport'
-export * from './transport/ExtensionContentServerTransport'
-
 // 快速创建一个悬浮图标和菜单，是扫码和聊天框的入口
 export * from './remoter/createRemoter'
 
@@ -59,3 +54,38 @@ export * from '@mcp-b/webmcp-polyfill'
 
 export { initializeBuiltinWebMCP } from './page-tools/initialize-builtin-WebMCP'
 export { registerPageAgentTool } from './page-tools/page-agent-tool'
+export { PAGE_AGENT_TOOL_CALL_EVENT, PAGE_AGENT_TOOL_RESULT_EVENT } from './page-tools/page-agent-tool-event'
+export type { PageAgentToolCallEventDetail, PageAgentToolResultEventDetail } from './page-tools/page-agent-tool-event'
+export type { PageAgentToolOptions } from './page-tools/tool-config'
+
+// registerPageAgentTool 完整运行期配置（顶层选项 enableHighlight + 统一无障碍配置 a11yConfig）
+// 的唯一一套读写 API：注册时初始化一次，之后可随时读取/修改
+export { DEFAULT_PAGE_AGENT_TOOL_CONFIG, getPageAgentToolConfig, setPageAgentToolConfig } from './page-tools/tool-config'
+export type { PageAgentToolConfig, PageAgentToolConfigPatch } from './page-tools/tool-config'
+
+// 站点预设：云控制台（consoleCloud）等 PageAgentToolOptions，可直接传给 registerPageAgentTool
+export {
+  consoleCloudPageAgentToolOptions,
+  isConsoleCloudHost,
+} from './page-tools/configs/console-cloud'
+
+// 统一无障碍配置（A11yConfig）：角色/状态规则、白/黑名单、自定义属性、弹窗选择器，
+// 以及供用户直接调用的底层解析函数（运行期读写请使用上面的 getPageAgentToolConfig/setPageAgentToolConfig）
+export {
+  DEFAULT_A11Y_CONFIG,
+  defineA11yConfig,
+  resolveA11yInfo,
+  resolveA11yRole,
+  resolveA11yStates,
+  mergeA11yConfig,
+  mergeA11yConfigs,
+  ensureResolvedA11yConfig,
+  isResolvedA11yConfig,
+  extractSelectors,
+} from './page-tools/a11y/config'
+export type { A11yConfig, ResolvedA11yConfig, A11yRoleRule, A11yMatcher, A11yStateName, A11yInfo } from './page-tools/a11y/config'
+
+// 无障碍树构建与搜索：供高级用户直接生成/搜索自定义根节点下的无障碍树
+export { buildA11yTree } from './page-tools/a11y/build'
+export { searchA11yTree } from './page-tools/a11y/search'
+export type { A11yTreeOptions, A11yTreeResult, SearchA11yTreeOptions, SearchA11yTreeResult, VNode, RefMap } from './page-tools/a11y/types'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentiny/next-sdk",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "type": "module",
   "homepage": "https://docs.opentiny.design/next-sdk/guide/",
   "repository": {
@@ -34,49 +34,43 @@
   },
   "description": "A frontend intelligent application development toolkit designed to simplify WebAgent integration and usage, supporting multiple programming languages and frontend frameworks to help developers rapidly implement intelligent features",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "~1.25.2",
-    "@opentiny/next": "^0.3.2",
-    "@ai-sdk/openai": "^3.0.0",
     "@ai-sdk/deepseek": "1.0.30",
-    "@ai-sdk/provider": "^3.0.0",
     "@ai-sdk/mcp": "^1.0.0",
+    "@ai-sdk/openai": "^3.0.0",
+    "@ai-sdk/provider": "^3.0.0",
     "@mcp-b/webmcp-polyfill": "^3.0.0",
-    "@page-agent/page-controller": "^1.9.0",
-    "qrcode": "^1.5.4",
-    "zod": "^3.25.76",
-    "zod-to-json-schema": "^3.25.2",
-    "ajv": "^8.17.1",
+    "@modelcontextprotocol/sdk": "~1.25.2",
+    "@opentiny/next": "^0.3.2",
+    "@page-agent/page-controller": "^1.10.0",
     "ai": "^6.0.0",
-    "dom-accessibility-api": "^0.6.3",
+    "ai-motion": "^0.4.8",
+    "ajv": "^8.17.1",
     "aria-query": "^5.3.2",
+    "diff": "^7.0.0",
+    "dom-accessibility-api": "^0.6.3",
+    "qrcode": "^1.5.4",
     "tabbable": "^6.2.0",
-    "diff": "^7.0.0"
+    "zod": "^3.25.76",
+    "zod-to-json-schema": "^3.25.2"
   },
   "devDependencies": {
+    "@types/diff": "^7.0.0",
+    "@types/node": "^24.6.0",
+    "@types/qrcode": "^1.5.5",
+    "@vitest/ui": "^4.1.10",
+    "jsdom": "^29.1.1",
     "typescript": "~5.9.3",
     "vite": "^7.1.7",
     "vite-plugin-dts": "^3.9.1",
-    "@types/qrcode": "^1.5.5",
-    "@types/node": "^24.6.0",
-    "@types/diff": "^7.0.0"
+    "vitest": "^4.1.10"
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build:all": "pnpm build:cdn && pnpm build:cdn:dev && pnpm build",
-    "build": "vite build --config vite-build-tsc.ts",
-    "build:cdn": "vite build && pnpm build:webAgent && pnpm build:webMcp && pnpm build:mcpSdk && pnpm build:zod && pnpm build:webMcpFull",
-    "build:cdn:dev": "vite build --mode dev && pnpm build:webAgent:dev && pnpm build:webMcp:dev && pnpm build:mcpSdk:dev && pnpm build:zod:dev && pnpm build:webMcpFull:dev",
-    "build:webAgent": "vite build --config vite.config.webAgent.ts",
-    "build:webAgent:dev": "vite build --config vite.config.webAgent.ts --mode dev",
-    "build:webMcp": "vite build --config vite.config.webMcp.ts",
-    "build:webMcp:dev": "vite build --config vite.config.webMcp.ts --mode dev",
-    "build:mcpSdk": "vite build --config vite.config.mcpSdk.ts",
-    "build:mcpSdk:dev": "vite build --config vite.config.mcpSdk.ts --mode dev",
-    "build:zod": "vite build --config vite.config.zod.ts",
-    "build:zod:dev": "vite build --config vite.config.zod.ts --mode dev",
-    "build:webMcpFull": "vite build --config vite.config.webMcpFull.ts",
-    "build:webMcpFull:dev": "vite build --config vite.config.webMcpFull.ts --mode dev"
+    "build": "vite build && vite build --config vite.config.runtime.ts",
+    "build:runtime": "vite build --config vite.config.runtime.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
 }

package/page-tools/a11y/build.ts

@@ -0,0 +1,74 @@
+/**
+ * a11y/build.ts
+ *
+ * 暴露生成整棵无障碍树的主逻辑方法。
+ */
+
+import type { A11yTreeOptions, A11yTreeResult, A11yTreeShapeOptions, RefMap } from './types'
+import type { A11yConfig } from './config'
+import { ensureResolvedA11yConfig } from './config'
+import { buildVNode, serializeVNode } from './vnode'
+import { getComposedChildren, collectHoverPointerElements } from './utils'
+import { deepQuerySelectorAll } from '../utils/dom'
+import { HIGHLIGHT_CONTAINER_ID } from '../page-agent-highlight'
+
+/** 将 whitelist/blacklist 中的 Element 引用与 CSS 选择器字符串统一解析为元素集合（字符串每次动态解析，适配 SPA 重渲染） */
+function resolveElementList(list: Array<Element | string>, root: Element): Set<Element> {
+  const set = new Set<Element>()
+  for (const item of list) {
+    if (typeof item === 'string') {
+      try {
+        for (const el of deepQuerySelectorAll(item, root)) set.add(el)
+      } catch {
+        // 忽略非法选择器
+      }
+    } else if (item) {
+      set.add(item)
+    }
+  }
+  return set
+}
+
+/**
+ * 生成当前页面的语义化 ARIA YAML 树
+ *
+ * @param root 遍历起点，默认 document.body
+ * @param config 统一无障碍配置（角色/状态规则、白/黑名单、自定义属性等）+ 树形状选项（pruneUnnamed/preserveRoles）
+ */
+export function buildA11yTree(root: Element = document.body, config?: A11yConfig & A11yTreeOptions): A11yTreeResult {
+  const { pruneUnnamed = true, preserveRoles = [], ...a11yConfig } = config ?? {}
+  // 运行期 a11yConfig 通常已是 ResolvedA11yConfig，走快路径避免再次与默认配置拼接
+  const resolved = ensureResolvedA11yConfig(a11yConfig)
+  const shapeOpts: A11yTreeShapeOptions = { pruneUnnamed, preserveRoles }
+
+  // 使用对象引用避免全局可变状态，消除并发调用隐患
+  const refCounter = { value: 0 }
+  const refMap: RefMap = new Map()
+  const blacklistSet = resolveElementList(resolved.blacklist, root)
+  const whitelistSet = resolveElementList(resolved.whitelist, root)
+  const lines: string[] = []
+
+  // 永远过滤高亮容器
+  const highlightContainer = document.getElementById(HIGHLIGHT_CONTAINER_ID)
+  if (highlightContainer) blacklistSet.add(highlightContainer)
+
+  // 一次性扫描样式表，收集只在 :hover/:focus/:active 下声明 cursor:pointer 的元素。
+  // 这类元素静止态 getComputedStyle 读到 auto，需靠样式表兜底才能识别为可点击。
+  const hoverPointerSet = collectHoverPointerElements(root)
+
+  for (const child of getComposedChildren(root)) {
+    const vnode = buildVNode(child, refCounter, refMap, blacklistSet, whitelistSet, resolved, hoverPointerSet)
+    if (vnode) {
+      lines.push(...serializeVNode(vnode, 0, shapeOpts))
+    }
+  }
+
+  const yaml = '```yaml\n' + lines.join('\n') + '\n```'
+
+  return {
+    yaml,
+    refMap,
+    interactiveCount: refMap.size,
+    lines,
+  }
+}