chore(version): bump version to 0.0.10

chore(deps-dev): bump the development-dependencies group across 1 directory with 18 updates

AGENTS.md

@@ -7,9 +7,10 @@ This is a **monorepo** with npm workspaces containing **two main packages**:
 1. **Core Library** (`packages/page-agent/`) - Pure JavaScript/TypeScript AI agent library for browser DOM automation, published as `page-agent` on npm
 2. **Website** (`packages/website/`) - React documentation and landing page. Also as demo and test page for the core lib. private package `@page-agent/website`
 
-And other internal packages. Such as:
+And other internal packages:
 
-- **Page Controller** (`packages/page-controller/`) - DOM operations and element interactions module. Independent of LLM, can be tested in unit tests.
+- **Page Controller** (`packages/page-controller/`) - DOM operations and element interactions. Independent of LLM.
+- **UI** (`packages/ui/`) - Panel, SimulatorMask, and i18n. Decoupled from PageAgent.
 
 ## Development Commands
 
@@ -18,22 +19,9 @@ And other internal packages. Such as:
 ```bash
 npm start                    # Start website dev server
 npm run build                # Build all packages
-npm run build:lib            # Build page-agent library only
 npm run lint                 # ESLint with TypeScript strict rules
 ```
 
-### Package-specific Commands
-
-```bash
-# Core library
-npm run build --workspace=page-agent
-npm run build:watch --workspace=page-agent
-
-# Website
-npm run dev --workspace=@page-agent/website
-npm run build --workspace=@page-agent/website
-```
-
 ## Architecture & Critical Patterns
 
 ### Monorepo Structure
@@ -45,11 +33,10 @@ You must update tsconfig and vite config if you add/remove/rename a package.
 ```bash
 packages/
 ├── page-agent/              # npm: "page-agent" ⭐ MAIN
-│   ├── src/                 # AI agent source
+│   ├── src/
 │   │   ├── PageAgent.ts     # Main AI agent class
 │   │   ├── tools/           # LLM tool definitions
-│   │   ├── llms/            # LLM integration
+│   │   └── llms/            # LLM integration
-│   │   └── ui/              # UI components
 │   ├── vite.config.js       # Library build (ES + UMD)
 │   └── package.json
 ├── website/                 # npm: "@page-agent/website" (private) ⭐ MAIN
@@ -58,19 +45,25 @@ packages/
 │
 │   # ...internal packages below...
 │
-└── page-controller/         # npm: "@page-agent/page-controller"
+├── page-controller/         # npm: "@page-agent/page-controller"
-    └── src/                 # DOM operations source
+│   └── src/                 # DOM operations
-        ├── PageController.ts  # Main controller class
+│       ├── PageController.ts
-        ├── actions.ts         # Element interaction actions
+│       ├── actions.ts
-        └── dom/               # DOM tree extraction
+│       └── dom/
+└── ui/                      # npm: "@page-agent/ui"
+    └── src/                 # Panel and Mask Effects
+        ├── Panel.ts
+        ├── SimulatorMask.ts
+        └── i18n/
 ```
 
 `workspaces` must be written in topological order to guarantee build order.
 
 ```json
 "workspaces": [
-    // internal deps ...
+    // internal deps (topological order)
     "packages/page-controller",
+    "packages/ui",
     "packages/page-agent",
     "packages/website"
 ],
@@ -79,8 +72,9 @@ packages/
 ### Module Boundaries (Critical)
 
 - **Website** (`packages/website/`): CAN import from `page-agent` for demos. Alias `@/` → `website/src/`
-- **Page Agent** (`packages/page-agent/`): The core lib. Imports from all internal packages. Never import from website.
+- **Page Agent** (`packages/page-agent/`): The core lib. Imports from `@page-agent/page-controller` and `@page-agent/ui`.
-- **Page Controller** (`packages/page-controller/`): Internal lib. Pure DOM operations, NO LLM dependency. Never import from page-agent.
+- **UI** (`packages/ui/`): Panel, Mask, i18n. No dependency on page-agent.
+- **Page Controller** (`packages/page-controller/`): Pure DOM operations. No LLM or UI dependency.
 
 ### PageController ↔ PageAgent Communication
 
@@ -132,9 +126,8 @@ Query params configure `PageAgentConfig` automatically in `src/entry.ts`.
 | File | Description |
 |------|-------------|
 | `src/PageAgent.ts` | ⭐ Main AI agent class orchestrating tools and LLM |
-| `src/entry.ts` | CDN/UMD entry point with auto-initialization |
+| `src/umd.ts` | CDN/UMD entry point with auto-initialization |
 | `src/tools/` | Tool definitions that call PageController methods |
-| `src/ui/` | UI components (Panel, SimulatorMask) with CSS modules |
 | `src/llms/` | LLM integration and communication layer |
 | `vite.config.js` | Library build configuration (ES + UMD) |
 

CONTRIBUTING.md

@@ -112,16 +112,16 @@ npm start                # React development server
 > @TODO this part is outdated. Update this.
 
 - Config your LLM API
-- Start a local script
+- Start and serve a local umd script
 
    ```bash
-   npm run build:watch --workspace=page-agent   # UMD with auto rebuild
+   npm run dev:umd # Serving UMD with auto rebuild at http://localhost:5173/page-agent.umd.cjs
    ```
 
 - Add a new bookmark enable it on other website
 
    ```
-   javascript:(function(){var s=document.createElement('script');s.src=`http://localhost:5173/dist/lib/page-agent.umd.cjs?t=${Math.random()}`;s.onload=()=>console.log(%27PageAgent ready!%27);document.head.appendChild(s);})();
+   javascript:(function(){var s=document.createElement('script');s.src=`http://localhost:5173/page-agent.umd.cjs?t=${Math.random()}`;s.onload=()=>console.log(%27PageAgent ready!%27);document.head.appendChild(s);})();
    ```
 
 ### Adding Documentation

README-zh.md

@@ -72,12 +72,9 @@ PageAgent adopts a simplified monorepo structure:
 ```
 packages/
 ├── page-agent/          # AI agent (npm: page-agent)
-│   ├── PageAgent        # Agent main loop
+├── page-controller/     # DOM 操作 (npm: @page-agent/page-controller)
-│   ├── tools/           # LLM tool definitions
+├── ui/                  # 面板 & 蒙层 & 模拟鼠标 (npm: @page-agent/ui)
-│   ├── ui/              # UI components & panels
+└── website/             # 文档站点
-│   └── llms/            # LLM integration layer
-├── page-controller/     # DOM operations (npm: @page-agent/page-controller)
-└── website/             # Documentation site
 ```
 
 ## 🤝 贡献

README.md

@@ -1,6 +1,6 @@
 # PageAgent 🤖🪄
 
-![banner](https://img.alicdn.com/imgextra/i1/O1CN01RY0Wvh26ATVeDIX7v_!!6000000007621-0-tps-1672-512.jpg)
+![banner](https://img.alicdn.com/imgextra/i3/O1CN01MyVCS21EoKkIHUT1s_!!6000000000398-49-tps-1280-353.webp)
 
 [![npm version](https://badge.fury.io/js/page-agent.svg)](https://badge.fury.io/js/page-agent) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/) [![Downloads](https://img.shields.io/npm/dt/page-agent.svg)](https://www.npmjs.com/package/page-agent) [![Bundle Size](https://img.shields.io/bundlephobia/minzip/page-agent)](https://bundlephobia.com/package/page-agent) [![GitHub stars](https://img.shields.io/github/stars/alibaba/page-agent.svg)](https://github.com/alibaba/page-agent)
 
@@ -72,11 +72,8 @@ PageAgent adopts a simplified monorepo structure:
 ```
 packages/
 ├── page-agent/          # AI agent (npm: page-agent)
-│   ├── PageAgent        # Agent main loop
-│   ├── tools/           # LLM tool definitions
-│   ├── ui/              # UI components & panels
-│   └── llms/            # LLM integration layer
 ├── page-controller/     # DOM operations (npm: @page-agent/page-controller)
+├── ui/                  # Panel & Mask & Mouse Animation (npm: @page-agent/ui)
 └── website/             # Demo & Documentation site
 ```
 

package.json

@@ -1,7 +1,7 @@
 {
 	"name": "root",
 	"private": true,
-	"version": "0.0.9",
+	"version": "0.0.10",
 	"type": "module",
 	"workspaces": [
 		"packages/page-controller",
@@ -24,32 +24,33 @@
 	"scripts": {
 		"start": "npm run dev --workspace=@page-agent/website",
 		"build": "npm run build --workspaces --if-present",
-		"build:lib": "npm run build:lib --workspace=page-agent",
+		"dev:umd": "npm run dev:umd --workspace=page-agent",
 		"version": "node scripts/sync-version.js",
 		"lint": "eslint .",
 		"prepare": "husky"
 	},
 	"devDependencies": {
-		"@commitlint/cli": "^20.1.0",
+		"@commitlint/cli": "^20.2.0",
-		"@commitlint/config-conventional": "^20.0.0",
+		"@commitlint/config-conventional": "^20.2.0",
-		"@eslint/js": "^9.39.1",
+		"@eslint/js": "^9.39.2",
+		"@microsoft/api-extractor": "^7.55.2",
 		"@trivago/prettier-plugin-sort-imports": "^6.0.0",
+		"concurrently": "^9.2.1",
 		"dotenv": "^17.2.3",
-		"eslint": "^9.39.1",
+		"eslint": "^9.39.2",
 		"eslint-config-prettier": "^10.1.8",
-		"eslint-plugin-react-dom": "^2.3.9",
+		"eslint-plugin-react-dom": "^2.3.13",
 		"eslint-plugin-react-hooks": "^7.0.1",
-		"eslint-plugin-react-refresh": "^0.4.24",
+		"eslint-plugin-react-refresh": "^0.4.25",
-		"eslint-plugin-react-x": "^2.3.9",
+		"eslint-plugin-react-x": "^2.3.13",
 		"globals": "^16.4.0",
 		"husky": "^9.1.7",
 		"lint-staged": "^16.2.4",
-		"prettier": "^3.6.2",
+		"prettier": "^3.7.4",
 		"typescript": "^5.9.3",
-		"typescript-eslint": "^8.48.1",
+		"typescript-eslint": "^8.49.0",
-		"vite": "^7.2.6",
-		"@microsoft/api-extractor": "^7.55.1",
 		"unplugin-dts": "^1.0.0-beta.6",
+		"vite": "^7.3.0",
 		"vite-plugin-css-injected-by-js": "^3.5.2"
 	},
 	"lint-staged": {

packages/page-agent/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "page-agent",
 	"private": false,
-	"version": "0.0.9",
+	"version": "0.0.10",
 	"type": "module",
 	"main": "./dist/lib/page-agent.js",
 	"module": "./dist/lib/page-agent.js",
@@ -37,17 +37,16 @@
 	},
 	"homepage": "https://alibaba.github.io/page-agent/",
 	"scripts": {
-		"build": "npm run build:lib && npm run build:umd",
+		"build": "MODE=lib vite build && MODE=umd vite build",
-		"build:lib": "MODE=lib vite build",
+		"serve": "npx serve dist/umd -p 5173",
-		"build:umd": "MODE=umd vite build",
+		"dev:umd": "concurrently \"MODE=umd vite build --watch\" \"npm run serve\"",
-		"build:watch": "MODE=umd vite build --watch",
 		"prepublishOnly": "node -e \"const fs=require('fs');['README.md','LICENSE'].forEach(f=>fs.copyFileSync('../../'+f,f))\"",
 		"postpublish": "node -e \"['README.md','LICENSE'].forEach(f=>{try{require('fs').unlinkSync(f)}catch{}})\""
 	},
 	"dependencies": {
 		"chalk": "^5.6.2",
 		"zod": "^4.1.12",
-		"@page-agent/page-controller": "0.0.9",
+		"@page-agent/page-controller": "0.0.10",
-		"@page-agent/ui": "0.0.9"
+		"@page-agent/ui": "0.0.10"
 	}
 }

packages/page-agent/tsconfig.json

@@ -7,10 +7,16 @@
 		"baseUrl": ".",
 		"outDir": "dist",
 		"paths": {
-			"@page-agent/page-controller": ["../page-controller/src/PageController.ts"]
+			//
+			"@page-agent/page-controller": ["../page-controller/src/PageController.ts"],
+			"@page-agent/ui": ["../ui/src/index.ts"]
 		}
 	},
 	"include": ["**/*.ts"],
 	"exclude": ["dist", "node_modules"],
-	"references": [{ "path": "../page-controller" }]
+	"references": [
+		//
+		{ "path": "../page-controller" },
+		{ "path": "../ui" }
+	]
 }

packages/page-agent/vite.config.js

@@ -34,7 +34,13 @@ const libConfig = {
 		},
 		outDir: resolve(__dirname, 'dist', 'lib'),
 		rollupOptions: {
-			external: ['ai', 'ai-motion', 'chalk', 'zod', '@page-agent/*'],
+			external: [
+				'ai-motion',
+				'chalk',
+				'zod',
+				// all the internal packages
+				/^@page-agent\//,
+			],
 		},
 		minify: false,
 		sourcemap: true,

packages/page-controller/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@page-agent/page-controller",
-	"version": "0.0.9",
+	"version": "0.0.10",
 	"type": "module",
 	"main": "./dist/lib/page-controller.js",
 	"module": "./dist/lib/page-controller.js",
@@ -32,7 +32,6 @@
 	"homepage": "https://alibaba.github.io/page-agent/",
 	"scripts": {
 		"build": "vite build",
-		"build:watch": "vite build --watch",
 		"prepublishOnly": "node -e \"const fs=require('fs');['LICENSE'].forEach(f=>fs.copyFileSync('../../'+f,f))\"",
 		"postpublish": "node -e \"['LICENSE'].forEach(f=>{try{require('fs').unlinkSync(f)}catch{}})\""
 	}

packages/ui/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@page-agent/ui",
-	"version": "0.0.9",
+	"version": "0.0.10",
 	"type": "module",
 	"main": "./dist/lib/page-agent-ui.js",
 	"module": "./dist/lib/page-agent-ui.js",
@@ -32,7 +32,6 @@
 	"homepage": "https://alibaba.github.io/page-agent/",
 	"scripts": {
 		"build": "vite build",
-		"build:watch": "vite build --watch",
 		"prepublishOnly": "node -e \"const fs=require('fs');['LICENSE'].forEach(f=>fs.copyFileSync('../../'+f,f))\"",
 		"postpublish": "node -e \"['LICENSE'].forEach(f=>{try{require('fs').unlinkSync(f)}catch{}})\""
 	},

packages/website/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@page-agent/website",
 	"private": true,
-	"version": "0.0.9",
+	"version": "0.0.10",
 	"type": "module",
 	"scripts": {
 		"dev": "vite",
@@ -10,16 +10,16 @@
 		"typecheck": "tsc --noEmit"
 	},
 	"devDependencies": {
-		"@tailwindcss/vite": "^4.1.14",
+		"@tailwindcss/vite": "^4.1.18",
 		"@types/react": "^19.2.2",
 		"@types/react-dom": "^19.2.1",
 		"@vitejs/plugin-react-swc": "^4.1.0",
-		"i18next": "^25.7.1",
+		"i18next": "^25.7.3",
 		"i18next-browser-languagedetector": "^8.2.0",
-		"react": "^19.2.0",
+		"react": "^19.2.3",
-		"react-dom": "^19.2.0",
+		"react-dom": "^19.2.3",
-		"react-i18next": "^16.1.4",
+		"react-i18next": "^16.5.0",
 		"tailwindcss": "^4.1.14",
-		"wouter": "^3.7.1"
+		"wouter": "^3.8.1"
 	}
 }

packages/website/src/docs/introduction/overview/page.tsx

@@ -8,7 +8,7 @@ export default function Overview() {
 			{/* 头图 */}
 			<figure className="mb-8 rounded-xl overflow-hidden">
 				<img
-					src="https://img.alicdn.com/imgextra/i1/O1CN01RY0Wvh26ATVeDIX7v_!!6000000007621-0-tps-1672-512.jpg"
+					src="https://img.alicdn.com/imgextra/i3/O1CN014xLeic1gnF2iWdzjJ_!!6000000004186-49-tps-1280-353.webp"
 					alt="page-agent"
 					className="w-full h-64 object-cover"
 				/>

packages/website/src/main.tsx

@@ -4,8 +4,8 @@ import { useHashLocation } from 'wouter/use-hash-location'
 
 import './i18n/config'
 import './i18n/types'
-import { default as PagesRouter } from './router.tsx'
+import { default as PagesRouter } from './router'
-import { default as TestPagesRouter } from './test-pages/router.tsx'
+import { default as TestPagesRouter } from './test-pages/router'
 
 import './index.css'
 

packages/website/tsconfig.json

@@ -11,11 +11,17 @@
 			"@/*": ["src/*"],
 
 			// Simplified monorepo solution (raw npm workspace with hoisting)
+			"page-agent": ["../page-agent/src/PageAgent.ts"],
 			"@page-agent/page-controller": ["../page-controller/src/PageController.ts"],
-			"page-agent": ["../page-agent/src/PageAgent.ts"]
+			"@page-agent/ui": ["../ui/src/index.ts"]
 		}
 	},
 	"include": ["**/*.ts", "**/*.tsx"],
 	"exclude": ["dist", "node_modules"],
-	"references": [{ "path": "../page-controller" }, { "path": "../page-agent" }]
+	"references": [
+		//
+		{ "path": "../page-agent" },
+		{ "path": "../page-controller" },
+		{ "path": "../ui" }
+	]
 }