chore: clean up structure; fix ai-motion warning

.markdownlint.json

@@ -1,3 +0,0 @@
-{
-	"extends": "markdownlint/style/relaxed"
-}

.prettierrc

@@ -1,16 +0,0 @@
-{
-  "singleQuote": true,
-  "semi": false,
-  "useTabs": true,
-  "printWidth": 100,
-  "trailingComma": "es5",
-  "plugins": ["@trivago/prettier-plugin-sort-imports"],
-  "importOrder": [
-    "<THIRD_PARTY_MODULES>",
-    "^(@/).*(?<!css)$",
-    "^[./].*(?<!css)$",
-    ".css$"
-  ],
-  "importOrderSeparation": true,
-  "importOrderSortSpecifiers": true
-}

.vscode/settings.json

@@ -1,4 +1,18 @@
 {
 	"editor.fontLigatures": true,
-	"cSpell.words": ["retryable"]
+	"cSpell.words": ["retryable"],
+	"markdownlint.config": {
+		// "comment": "Relaxed rules",
+		"default": true,
+		"whitespace": false,
+		"line_length": false,
+		"ul-indent": false,
+		"no-inline-html": false,
+		"no-bare-urls": false,
+		"fenced-code-language": false,
+		"first-line-h1": false,
+		"block-spacing": false,
+		"blanks-around-lists": false,
+		"ol-prefix": false
+	}
 }

CODE_OF_CONDUCT.md

@@ -1,5 +1,7 @@
 # Alibaba Open Source Code of Conduct
 
+[¶中文版](#我们的保证)
+
 ## Our Pledge
 
 In the interest of fostering an open and welcoming environment, we as
@@ -69,3 +71,57 @@ members of the project's leadership.
 
 This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
 available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+----
+
+> Chinese Version
+> 《阿里巴巴开源行为准则》
+
+## 我们的保证
+
+为了促进一个开放透明且友好的环境，我们作为贡献者和维护者保证：无论年龄、种族、民族、性别认同和表达（方式）、体型、身体健全与否、经验水平、国籍、个人表现、宗教或性别取向，参与者在我们项目和社区中都免于骚扰。
+
+## 我们的标准
+
+有助于创造正面环境的行为包括但不限于：
+
+* 使用友好和包容性语言
+* 尊重不同的观点和经历
+* 耐心地接受建设性批评
+* 关注对社区最有利的事情
+* 友善对待其他社区成员
+
+身为参与者不能接受的行为包括但不限于：
+
+* 使用与性有关的言语或是图像，以及不受欢迎的性骚扰
+* 捣乱/煽动/造谣的行为或进行侮辱/贬损的评论，人身攻击及政治攻击
+* 公开或私下的骚扰
+* 未经许可地发布他人的个人资料，例如住址或是电子地址
+* 其他可以被合理地认定为不恰当或者违反职业操守的行为
+
+## 我们的责任
+
+项目维护者有责任为「可接受的行为」标准做出诠释，以及对已发生的不被接受的行为采取恰当且公平的纠正措施。
+
+项目维护者有权利及责任去删除、编辑、拒绝与本行为标准有所违背的评论 (comments)、提交 (commits)、代码、wiki 编辑、问题 (issues) 和其他贡献，以及项目维护者可暂时或永久性的禁止任何他们认为有不适当、威胁、冒犯、有害行为的贡献者。
+
+## 使用范围
+
+当一个人代表该项目或是其社区时，本行为标准适用于其项目平台和公共平台。
+
+代表项目或是社区的情况，举例来说包括使用官方项目的电子邮件地址、通过官方的社区媒体账号发布或线上或线下事件中担任指定代表。
+
+该项目的呈现方式可由其项目维护者进行进一步的定义及解释。
+
+## 强制执行
+
+可以通过 opensource@alibaba-inc.com 来联系项目团队来举报滥用、骚扰或其他不被接受的行为。
+
+任何维护团队认为有必要且适合的所有投诉都将进行审查及调查，并做出相对应的回应。项目小组有对事件回报者有保密的义务。具体执行的方针近一步细节可能会单独公布。
+
+没有切实地遵守或是执行本行为标准的项目维护人员，可能会因项目领导人或是其他成员的决定，暂时或是永久地取消其参与资格。
+
+## 来源
+
+本行为标准改编自[贡献者公约](https://www.contributor-covenant.org)，版本 1.4
+可在此查看[https://www.contributor-covenant.org/zh-cn/version/1/4/code-of-conduct.html](https://www.contributor-covenant.org/zh-cn/version/1/4/code-of-conduct.html)

CODE_OF_CONDUCT_zh.md

@@ -1,50 +0,0 @@
-# 阿里巴巴开源行为准则
-
-## 我们的保证
-
-为了促进一个开放透明且友好的环境，我们作为贡献者和维护者保证：无论年龄、种族、民族、性别认同和表达（方式）、体型、身体健全与否、经验水平、国籍、个人表现、宗教或性别取向，参与者在我们项目和社区中都免于骚扰。
-
-## 我们的标准
-
-有助于创造正面环境的行为包括但不限于：
-
-* 使用友好和包容性语言
-* 尊重不同的观点和经历
-* 耐心地接受建设性批评
-* 关注对社区最有利的事情
-* 友善对待其他社区成员
-
-身为参与者不能接受的行为包括但不限于：
-
-* 使用与性有关的言语或是图像，以及不受欢迎的性骚扰
-* 捣乱/煽动/造谣的行为或进行侮辱/贬损的评论，人身攻击及政治攻击
-* 公开或私下的骚扰
-* 未经许可地发布他人的个人资料，例如住址或是电子地址
-* 其他可以被合理地认定为不恰当或者违反职业操守的行为
-
-## 我们的责任
-
-项目维护者有责任为「可接受的行为」标准做出诠释，以及对已发生的不被接受的行为采取恰当且公平的纠正措施。
-
-项目维护者有权利及责任去删除、编辑、拒绝与本行为标准有所违背的评论 (comments)、提交 (commits)、代码、wiki 编辑、问题 (issues) 和其他贡献，以及项目维护者可暂时或永久性的禁止任何他们认为有不适当、威胁、冒犯、有害行为的贡献者。
-
-## 使用范围
-
-当一个人代表该项目或是其社区时，本行为标准适用于其项目平台和公共平台。
-
-代表项目或是社区的情况，举例来说包括使用官方项目的电子邮件地址、通过官方的社区媒体账号发布或线上或线下事件中担任指定代表。
-
-该项目的呈现方式可由其项目维护者进行进一步的定义及解释。
-
-## 强制执行
-
-可以通过 opensource@alibaba-inc.com 来联系项目团队来举报滥用、骚扰或其他不被接受的行为。
-
-任何维护团队认为有必要且适合的所有投诉都将进行审查及调查，并做出相对应的回应。项目小组有对事件回报者有保密的义务。具体执行的方针近一步细节可能会单独公布。
-
-没有切实地遵守或是执行本行为标准的项目维护人员，可能会因项目领导人或是其他成员的决定，暂时或是永久地取消其参与资格。
-
-## 来源
-
-本行为标准改编自[贡献者公约](https://www.contributor-covenant.org)，版本 1.4
-可在此查看[https://www.contributor-covenant.org/zh-cn/version/1/4/code-of-conduct.html](https://www.contributor-covenant.org/zh-cn/version/1/4/code-of-conduct.html)

CONTRIBUTING.md

@@ -14,6 +14,7 @@ Thank you for your interest in contributing to Page-Agent! We welcome contributi
    - make sure `eslint`, `auto-format` and `commit-lint` all work
 
 2. **Setup**
+
    ```bash
    npm install
    npm start          # Start demo and documentation site
@@ -38,12 +39,14 @@ This project has **two separate parts**:
 ### Code Contributions
 
 1. **Fork and Clone**
+
    ```bash
    git clone https://github.com/your-username/page-agent.git
    cd page-agent
    ```
 
 2. **Create Feature Branch**
+
    ```bash
    git checkout -b feat/your-feature-name
    ```
@@ -54,11 +57,13 @@ This project has **two separate parts**:
    - Update documentation as needed
 
 4. **Test Your Changes**
+
    ```bash
    # TODO
    ```
 
 5. **Commit and Push**
+
    ```bash
    git add .
    git commit -m "feat: add awesome feature"
@@ -80,12 +85,12 @@ This project has **two separate parts**:
 - Keep functions small and focused
 - Add JSDoc for public APIs
 
-### ✨ AI coder/copilot
+### Vibe coding with AI
 
-- It's **recommended** to heavily rely on AI when maintaining **the webpages and tests**.
+- It's **recommended** to heavily rely on AI (aka "vibe coding") when maintaining **demo pages and tests**.
-- BUT **NOT the core lib!!!** Be very careful if AI touched any code in the core lib.
+- BUT **NOT the core lib!!!** Be very careful if AI ever touched the core lib!!!
 - Review anything AI wrote before make a commit. You are the author of anything you commit. NOT AI.
-- Update the AI instructions.
+- Update the AI instructions when structure changed.
    - Cursor and Cline: `./.cursor/rules`
    - Github Copilot: `./.github/copilot-instructions.md`
    - Claude Code: `./CLAUDE.md`
@@ -96,7 +101,7 @@ This project has **two separate parts**:
 - Use event bus for component communication
 - Follow browser-use patterns for DOM operations
 
-### Documentation Site (`pages/`)
+### Doc&demo Site (`pages/`)
 
 - Use React 19 + TypeScript
 - Follow hash routing patterns (`useHashLocation`)
@@ -115,16 +120,17 @@ npm start                # React development server
 
 - Config your LLM API
 - Start a local script
+
    ```bash
    npm run build:lib:watch    # Auto-rebuild on changes
    ```
+
 - 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);})();
    ```
 
-
-
 ### Adding Documentation
 
 1. Create `pages/docs/section/page-name/page.tsx`

NOTICE

@@ -1,23 +0,0 @@
-Page-Agent
-Copyright (c) 2025 Alibaba Group Holding Limited
-Author: Simon<gaomeng1900>
-
-This project incorporates work covered by the following copyright and permission notices:
-
-================================================================================
-
-Browser Use
-Copyright (c) 2024 Gregor Zunic
-Licensed under the MIT License
-
-Original browser-use project: <https://github.com/browser-use/browser-use>
-License: MIT License
-
-We gratefully acknowledge the browser-use project and its contributors for their
-excellent work on web automation and DOM interaction patterns that helped make
-this project possible.
-
-================================================================================
-
-Third-party dependencies and their licenses can be found in the package.json
-file and in the node_modules directory after installation.

README-zh.md

@@ -99,7 +99,22 @@ PageAgent 专为**客户端网页增强**设计，不是服务端自动化工具
 
 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。
 
-DOM 处理与提示词参考了 [browser-use](https://github.com/browser-use/browser-use)（MIT 许可证）。完整归属请见 [NOTICE](NOTICE)。
+```
+DOM processing components and prompt are derived from browser-use: 
+
+Browser Use
+Copyright (c) 2024 Gregor Zunic
+Licensed under the MIT License
+
+Original browser-use project: <https://github.com/browser-use/browser-use>
+
+We gratefully acknowledge the browser-use project and its contributors for their
+excellent work on web automation and DOM interaction patterns that helped make
+this project possible.
+
+Third-party dependencies and their licenses can be found in the package.json
+file and in the node_modules directory after installation.
+```
 
 ---
 

README.md

@@ -99,7 +99,23 @@ PageAgent is designed for **client-side web enhancement**, not server-side autom
 
 MIT License - see the [LICENSE](LICENSE) file for details.
 
-DOM processing components and prompt are derived from [browser-use](https://github.com/browser-use/browser-use) (MIT License). See [NOTICE](NOTICE) for full attribution.
+
+```
+DOM processing components and prompt are derived from browser-use: 
+
+Browser Use
+Copyright (c) 2024 Gregor Zunic
+Licensed under the MIT License
+
+Original browser-use project: <https://github.com/browser-use/browser-use>
+
+We gratefully acknowledge the browser-use project and its contributors for their
+excellent work on web automation and DOM interaction patterns that helped make
+this project possible.
+
+Third-party dependencies and their licenses can be found in the package.json
+file and in the node_modules directory after installation.
+```
 
 ---
 

package-lock.json

@@ -11,7 +11,7 @@
 			"dependencies": {
 				"@ai-sdk/openai": "^2.0.22",
 				"ai": "^5.0.26",
-				"ai-motion": "^0.4.6",
+				"ai-motion": "^0.4.7",
 				"chalk": "^5.6.0",
 				"zod": "^4.1.3"
 			},
@@ -2538,7 +2538,6 @@
 			"integrity": "sha512-FYxk1I7wPv3K2XBaoyH2cTnocQEu8AOZ60hPbsyukMPLv5/5qr7V1i8PLHdl6Zf87I+xZXFvPCXYjiTFq+YSDQ==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"undici-types": "~7.12.0"
 			}
@@ -2549,7 +2548,6 @@
 			"integrity": "sha512-WBM/nDbEZmDUORKnh5i1bTnAz6vTohUf9b8esSMu+b24+srbaxa04UbJgWx78CVfNXA20sNu0odEIluZDFdCog==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"csstype": "^3.0.2"
 			}
@@ -2610,7 +2608,6 @@
 			"integrity": "sha512-TGf22kon8KW+DeKaUmOibKWktRY8b2NSAZNdtWh798COm1NWx8+xJ6iFBtk3IvLdv6+LGLJLRlyhrhEDZWargQ==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"@typescript-eslint/scope-manager": "8.45.0",
 				"@typescript-eslint/types": "8.45.0",
@@ -2875,7 +2872,6 @@
 			"integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"bin": {
 				"acorn": "bin/acorn"
 			},
@@ -2912,9 +2908,9 @@
 			}
 		},
 		"node_modules/ai-motion": {
-			"version": "0.4.6",
+			"version": "0.4.7",
-			"resolved": "https://registry.npmjs.org/ai-motion/-/ai-motion-0.4.6.tgz",
+			"resolved": "https://registry.npmjs.org/ai-motion/-/ai-motion-0.4.7.tgz",
-			"integrity": "sha512-F2CGMXsXen20gynyAZjsYcCanIexwa85qpEnY6Zw+dRds9AvPmU4wqE0tQfoAdpOchmOVB+tRR4phgbaB8o/gQ==",
+			"integrity": "sha512-yuFtVgWeaxKyvfSFocA01Mr4UbRvwwy7HWZ6Mq9NM/yccAkqp3UCGdWX6AflNB8cU27PgwTBiMRfx6C9di7xkQ==",
 			"license": "MIT"
 		},
 		"node_modules/ajv": {
@@ -3343,7 +3339,6 @@
 			"integrity": "sha512-itvL5h8RETACmOTFc4UfIyB2RfEHi71Ax6E/PivVxq9NseKbOWpeyHEOIbmAw1rs8Ak0VursQNww7lf7YtUwzg==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"env-paths": "^2.2.1",
 				"import-fresh": "^3.3.0",
@@ -3540,7 +3535,6 @@
 			"dev": true,
 			"hasInstallScript": true,
 			"license": "MIT",
-			"peer": true,
 			"bin": {
 				"esbuild": "bin/esbuild"
 			},
@@ -3605,7 +3599,6 @@
 			"integrity": "sha512-hB4FIzXovouYzwzECDcUkJ4OcfOEkXTv2zRY6B9bkwjx/cprAq0uvm1nl7zvQ0/TsUk0zQiN4uPfJpB9m+rPMQ==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"@eslint-community/eslint-utils": "^4.8.0",
 				"@eslint-community/regexpp": "^4.12.1",
@@ -5754,7 +5747,6 @@
 			"integrity": "sha512-I7AIg5boAr5R0FFtJ6rCfD+LFsWHp81dolrFD8S79U9tb8Az2nGrJncnMSnys+bpQJfRUzqs9hnA81OAA3hCuQ==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"bin": {
 				"prettier": "bin/prettier.cjs"
 			},
@@ -5819,7 +5811,6 @@
 			"integrity": "sha512-w8nqGImo45dmMIfljjMwOGtbmC/mk4CMYhWIicdSflH91J9TyCyczcPFXJzrZ/ZXcgGRFeP6BU0BEJTw6tZdfQ==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"engines": {
 				"node": ">=0.10.0"
 			}
@@ -5939,7 +5930,6 @@
 			"integrity": "sha512-RIDh866U8agLgiIcdpB+COKnlCreHJLfIhWC3LVflku5YHfpnsIKigRZeFfMfCc4dVcqNVfQQ5gO/afOck064A==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"@types/estree": "1.0.8"
 			},
@@ -6305,7 +6295,6 @@
 			"integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"engines": {
 				"node": ">=12"
 			},
@@ -6401,7 +6390,6 @@
 			"integrity": "sha512-CWBzXQrc/qOkhidw1OzBTQuYRbfyxDXJMVJ1XNwUHGROVmuaeiEm3OslpZ1RV96d7SKKjZKrSJu3+t/xlw3R9A==",
 			"dev": true,
 			"license": "Apache-2.0",
-			"peer": true,
 			"bin": {
 				"tsc": "bin/tsc",
 				"tsserver": "bin/tsserver"
@@ -6580,7 +6568,6 @@
 			"integrity": "sha512-VbA8ScMvAISJNJVbRDTJdCwqQoAareR/wutevKanhR2/1EkoXVZVkkORaYm/tNVCjP/UDTKtcw3bAkwOUdedmA==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"esbuild": "^0.25.0",
 				"fdir": "^6.5.0",
@@ -6684,7 +6671,6 @@
 			"integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"engines": {
 				"node": ">=12"
 			},
@@ -6918,7 +6904,6 @@
 			"resolved": "https://registry.npmjs.org/zod/-/zod-4.1.11.tgz",
 			"integrity": "sha512-WPsqwxITS2tzx1bzhIKsEs19ABD5vmCVa4xBo2tq/SrV4RNZtfws1EnCWQXM6yh8bD08a1idvkB5MZSBiZsjwg==",
 			"license": "MIT",
-			"peer": true,
 			"funding": {
 				"url": "https://github.com/sponsors/colinhacks"
 			}

package.json

@@ -52,7 +52,7 @@
 	"dependencies": {
 		"@ai-sdk/openai": "^2.0.22",
 		"ai": "^5.0.26",
-		"ai-motion": "^0.4.6",
+		"ai-motion": "^0.4.7",
 		"chalk": "^5.6.0",
 		"zod": "^4.1.3"
 	},
@@ -113,5 +113,23 @@
 				"never"
 			]
 		}
+	},
+	"prettier": {
+		"singleQuote": true,
+		"semi": false,
+		"useTabs": true,
+		"printWidth": 100,
+		"trailingComma": "es5",
+		"plugins": [
+			"@trivago/prettier-plugin-sort-imports"
+		],
+		"importOrder": [
+			"<THIRD_PARTY_MODULES>",
+			"^(@/).*(?<!css)$",
+			"^[./].*(?<!css)$",
+			".css$"
+		],
+		"importOrderSeparation": true,
+		"importOrderSortSpecifiers": true
 	}
 }

tsconfig.json

@@ -1,8 +1,4 @@
 {
 	"files": [],
-	"references": [
+	"references": [{ "path": "./tsconfig.app.json" }, { "path": "./tsconfig.node.json" }]
-		{ "path": "./tsconfig.app.json" },
-		{ "path": "./tsconfig.node.json" },
-		{ "path": "./tsconfig.lib.json" }
-	]
 }

tsconfig.lib.json

@@ -1,15 +0,0 @@
-{
-	"extends": "./tsconfig.app.json",
-	"compilerOptions": {
-		// "composite": true,
-		"noEmit": false,
-		"declaration": true,
-		"declarationMap": true,
-		"emitDeclarationOnly": true,
-		"outDir": "./dist/types",
-		"rootDir": "./src",
-		"stripInternal": true
-	},
-	"include": ["src", "env.d.ts"],
-	"exclude": ["src/**/*.test.ts", "src/**/*.test.tsx"]
-}

vite.lib.config.ts

@@ -10,7 +10,7 @@ const __dirname = dirname(__filename)
 // Library build configuration
 export default defineConfig({
 	plugins: [
-		dts({ tsconfigPath: './tsconfig.lib.json', bundleTypes: true }),
+		dts({ tsconfigPath: './tsconfig.app.json', bundleTypes: true }),
 		cssInjectedByJsPlugin({ relativeCSSInjection: true }),
 	],
 	resolve: {
@@ -20,7 +20,6 @@ export default defineConfig({
 	},
 	publicDir: false,
 	esbuild: {
-		// 禁用严格的未使用变量检查
 		keepNames: true,
 	},
 	build: {
@@ -33,18 +32,12 @@ export default defineConfig({
 		outDir: resolve(__dirname, 'dist', 'lib'),
 		rollupOptions: {
 			external: ['@ai-sdk/openai', 'ai', 'ai-motion', 'chalk', 'zod'],
-			output: {
-				globals: {
-					// 定义全局变量映射
-				},
-			},
 		},
 		// minify: 'terser',
 		minify: false,
 		sourcemap: true,
 	},
 	define: {
-		// 替换环境变量
 		'process.env.NODE_ENV': '"production"',
 	},
 })

vite.umd.config.ts

@@ -16,7 +16,6 @@ export default defineConfig({
 	},
 	publicDir: false,
 	esbuild: {
-		// 禁用严格的未使用变量检查
 		keepNames: true,
 	},
 	build: {
@@ -27,18 +26,8 @@ export default defineConfig({
 			formats: ['umd'],
 		},
 		outDir: resolve(__dirname, 'dist', 'umd'),
-		rollupOptions: {
-			output: {
-				globals: {
-					// 定义全局变量映射
-				},
-			},
-		},
-		// minify: 'terser',
-		// sourcemap: true,
 	},
 	define: {
-		// 替换环境变量
 		'process.env.NODE_ENV': '"production"',
 	},
 })