refactor(PageController): implement PageController

packages/website/package.json

@@ -9,10 +9,8 @@
 		"preview": "vite preview",
 		"typecheck": "tsc --noEmit"
 	},
-	"dependencies": {
-		"page-agent": "*"
-	},
 	"devDependencies": {
+		"page-agent": "*",
 		"@tailwindcss/vite": "^4.1.14",
 		"@types/react": "^19.2.2",
 		"@types/react-dom": "^19.2.1",

packages/website/src/docs/integration/configuration/page.tsx

@@ -9,7 +9,7 @@ export default function Configuration() {
 				className="mb-8"
 				language="typescript"
 				code={`// config
-type PageAgentConfig = LLMConfig & AgentConfig & DomConfig
+type PageAgentConfig = LLMConfig & AgentConfig & PageControllerConfig
 
 interface LLMConfig {
 	baseURL?: string
@@ -93,12 +93,13 @@ interface AgentConfig {
 	experimentalPreventNewPage?: boolean
 }
 
-interface DomConfig {
+interface PageControllerConfig {
 	interactiveBlacklist?: (Element | (() => Element))[]
 	interactiveWhitelist?: (Element | (() => Element))[]
 	include_attributes?: string[]
 	highlightOpacity?: number
 	highlightLabelOpacity?: number
+	viewportExpansion?: number
 }
 
 `}

packages/website/tsconfig.json

@@ -1,17 +1,21 @@
 {
-	"extends": "../../tsconfig.json",
+	"extends": "../../tsconfig.base.json",
 	"compilerOptions": {
-		"composite": true,
 		"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
-		"baseUrl": "./",
+		"noEmit": false,
+		"allowImportingTsExtensions": false,
+		"baseUrl": ".",
+		"outDir": "dist",
 		"paths": {
 			// Self root
 			"@/*": ["src/*"],
 
 			// Simplified monorepo solution (raw npm workspace with hoisting)
+			"@page-agent/page-controller": ["../page-controller/src/PageController.ts"],
 			"page-agent": ["../page-agent/src/PageAgent.ts"]
 		}
 	},
-	"include": ["src", "env.d.ts"],
-	"references": [{ "path": "../page-agent" }]
+	"include": ["**/*.ts", "**/*.tsx"],
+	"exclude": ["dist", "node_modules"],
+	"references": [{ "path": "../page-controller" }, { "path": "../page-agent" }]
 }

packages/website/vite.config.js

@@ -18,7 +18,8 @@ export default defineConfig({
 			// Self root
 			'@': resolve(__dirname, 'src'),
 
-			// Simplified monorepo solution (raw npm workspace with hoisting)
+			// Monorepo packages (always bundle local code instead of npm versions)
+			'@page-agent/page-controller': resolve(__dirname, '../page-controller/src/PageController.ts'),
 			'page-agent': resolve(__dirname, '../page-agent/src/PageAgent.ts'),
 		},
 	},