@tanzerfe/page-use 0.0.2

package/dist/vue.d.mts

@@ -0,0 +1,53 @@
+import { $ as PageUsePreset, A as runPageUseTool, B as DEFAULT_MODEL, C as PageUseGlobal, D as PageUseCommand, E as PAGE_USE_TOOL_NAME, F as PageUseLauncherConfig, G as PageUseOptions, H as DEFAULT_STORAGE_KEY_PREFIX, I as PageUseLauncherElement, J as readLauncherSwitch, K as PageUseRouterMode, L as PageUseHandle, M as definePageUseElements, N as mountPageUseUI, O as formatPageUseResultForModel, P as PAGE_USE_LAUNCHER_TAG, Q as PageUseMenuNode, R as createPageUse, S as PAGE_USE_GLOBAL_KEY, T as PAGE_USE_TOOL, U as NormalizedPageUseOptions, V as DEFAULT_SESSION_HEADER, W as PageUseLLMOptions, X as pageUseCapability, Y as PageUseCapability, Z as PageUseErrorCode, _ as getPageUseConfig, a as PAGE_USE_STATIC_PRESETS, at as PageUseTaskSource, b as pageUseStore, c as pageUseHistory, d as PageUseSettings, et as PageUseProgressEvent, f as pageUseSettings, g as getElapsedSeconds, h as clearPageUseLog, i as PageUseGlowElement, it as PageUseTaskResult, j as MountPageUseUIOptions, k as isPageUseCommand, l as DEFAULT_PAGE_USE_SETTINGS, m as PageUseState, n as SIMULATOR_MASK_ID, nt as PageUseSnapshot, o as buildMenuPresets, ot as PageUseTaskStatus, p as PageUseQuestion, q as normalizeOptions, r as PAGE_USE_GLOW_TAG, rt as PageUseStepLog, s as PageUseHistoryEntry, t as PAGE_USE_MASK_COLORS, tt as PageUseRunOptions, u as PageUsePoint, v as isPageUseConfigured, w as PAGE_USE_COMMAND_TYPE, x as ReadonlyStore, y as isRunning, z as DEFAULT_MAX_STEPS } from "./index-DtJ3mvL2.mjs";
+import { PropType, ShallowRef } from "vue";
+import { Router } from "vue-router";
+//#region src/vue.d.ts
+/**
+ * 由 vue-router 实例补齐路由相关选项（宿主显式传入的优先）：
+ * - routerMode：createWebHashHistory 的 base 必含 '#'
+ * - getCurrentPath：取 currentRoute.fullPath，与路由模式无关
+ * - resolveRouteName：router.resolve(path).name
+ */
+export declare function withVueRouter(options: PageUseOptions, router: Router): PageUseOptions;
+export declare const PageUseHost: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 初始化选项；仅在挂载时读取一次，变更需重新挂载组件 */
+  options: {
+    type: PropType<PageUseOptions>;
+    required: true;
+  };
+  /** 调试面板：false 不挂载；true 或配置对象挂载 */
+  launcher: {
+    type: PropType<boolean | PageUseLauncherConfig>;
+    default: boolean;
+  };
+  /** 运行期定制光晕 */
+  glow: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+}>, () => null, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 初始化选项；仅在挂载时读取一次，变更需重新挂载组件 */
+  options: {
+    type: PropType<PageUseOptions>;
+    required: true;
+  };
+  /** 调试面板：false 不挂载；true 或配置对象挂载 */
+  launcher: {
+    type: PropType<boolean | PageUseLauncherConfig>;
+    default: boolean;
+  };
+  /** 运行期定制光晕 */
+  glow: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+}>> & Readonly<{}>, {
+  launcher: boolean | PageUseLauncherConfig;
+  glow: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 执行状态的 Vue 响应式引用（整体替换，适合只读展示） */
+export declare function usePageUseState(): Readonly<ShallowRef<PageUseState>>;
+/** 本地设置的 Vue 响应式引用；修改请调用 pageUseSettings.update */
+export declare function usePageUseSettings(): Readonly<ShallowRef<PageUseSettings>>;
+//#endregion
+export { DEFAULT_MAX_STEPS, DEFAULT_MODEL, DEFAULT_PAGE_USE_SETTINGS, DEFAULT_SESSION_HEADER, DEFAULT_STORAGE_KEY_PREFIX, type MountPageUseUIOptions, type NormalizedPageUseOptions, PAGE_USE_COMMAND_TYPE, PAGE_USE_GLOBAL_KEY, PAGE_USE_GLOW_TAG, PAGE_USE_LAUNCHER_TAG, PAGE_USE_MASK_COLORS, PAGE_USE_STATIC_PRESETS, PAGE_USE_TOOL, PAGE_USE_TOOL_NAME, type PageUseCapability, type PageUseCommand, type PageUseErrorCode, type PageUseGlobal, PageUseGlowElement, type PageUseHandle, type PageUseHistoryEntry, type PageUseLLMOptions, type PageUseLauncherConfig, PageUseLauncherElement, type PageUseMenuNode, type PageUseOptions, type PageUsePoint, type PageUsePreset, type PageUseProgressEvent, type PageUseQuestion, type PageUseRouterMode, type PageUseRunOptions, type PageUseSettings, type PageUseSnapshot, type PageUseState, type PageUseStepLog, type PageUseTaskResult, type PageUseTaskSource, type PageUseTaskStatus, type ReadonlyStore, SIMULATOR_MASK_ID, buildMenuPresets, clearPageUseLog, createPageUse, definePageUseElements, formatPageUseResultForModel, getElapsedSeconds, getPageUseConfig, isPageUseCommand, isPageUseConfigured, isRunning, mountPageUseUI, normalizeOptions, pageUseCapability, pageUseHistory, pageUseSettings, pageUseStore, readLauncherSwitch, runPageUseTool };

package/dist/vue.mjs

@@ -0,0 +1,86 @@
+import { A as DEFAULT_MODEL, C as pageUseStore, D as SIMULATOR_MASK_ID, E as PAGE_USE_MASK_COLORS, M as DEFAULT_STORAGE_KEY_PREFIX, N as normalizeOptions, O as pageUseHistory, P as readLauncherSwitch, S as isRunning, T as pageUseSettings, _ as pageUseCapability, a as PAGE_USE_STATIC_PRESETS, b as getPageUseConfig, c as PageUseGlowElement, d as PAGE_USE_COMMAND_TYPE, f as PAGE_USE_TOOL, g as runPageUseTool, h as isPageUseCommand, i as PageUseLauncherElement, j as DEFAULT_SESSION_HEADER, k as DEFAULT_MAX_STEPS, l as createPageUse, m as formatPageUseResultForModel, n as mountPageUseUI, o as buildMenuPresets, p as PAGE_USE_TOOL_NAME, r as PAGE_USE_LAUNCHER_TAG, s as PAGE_USE_GLOW_TAG, t as definePageUseElements, u as PAGE_USE_GLOBAL_KEY, v as clearPageUseLog, w as DEFAULT_PAGE_USE_SETTINGS, x as isPageUseConfigured, y as getElapsedSeconds } from "./src-C8EWDZVz.mjs";
+import { defineComponent, inject, onBeforeUnmount, onScopeDispose, shallowRef } from "vue";
+import { routerKey } from "vue-router";
+
+//#region src/vue.ts
+/**
+* @tanzerfe/page-use/vue：Vue 3 适配层。
+* - PageUseHost：在组件生命周期内完成 createPageUse + mountPageUseUI，并从 vue-router 推导路由读取方式
+* - usePageUseState：把框架无关的状态容器转为 Vue 响应式引用
+* 本文件不使用 SFC，构建无需 Vue 插件；vue / vue-router 为可选 peer 依赖。
+*/
+/**
+* 由 vue-router 实例补齐路由相关选项（宿主显式传入的优先）：
+* - routerMode：createWebHashHistory 的 base 必含 '#'
+* - getCurrentPath：取 currentRoute.fullPath，与路由模式无关
+* - resolveRouteName：router.resolve(path).name
+*/
+function withVueRouter(options, router) {
+	return {
+		routerMode: router.options.history.base.includes("#") ? "hash" : "history",
+		getCurrentPath: () => router.currentRoute.value.fullPath,
+		resolveRouteName: (path) => {
+			try {
+				const name = router.resolve(path).name;
+				return name ? String(name) : void 0;
+			} catch {
+				return;
+			}
+		},
+		...options
+	};
+}
+const PageUseHost = defineComponent({
+	name: "PageUseHost",
+	props: {
+		/** 初始化选项；仅在挂载时读取一次，变更需重新挂载组件 */
+		options: {
+			type: Object,
+			required: true
+		},
+		/** 调试面板：false 不挂载；true 或配置对象挂载 */
+		launcher: {
+			type: [Boolean, Object],
+			default: false
+		},
+		/** 运行期定制光晕 */
+		glow: {
+			type: Boolean,
+			default: true
+		}
+	},
+	setup(props) {
+		const router = inject(routerKey, null);
+		const handle = createPageUse(router ? withVueRouter(props.options, router) : props.options);
+		const unmountUI = mountPageUseUI({
+			launcher: props.launcher,
+			glow: props.glow
+		});
+		onBeforeUnmount(() => {
+			unmountUI();
+			handle.destroy();
+		});
+		return () => null;
+	}
+});
+/** 执行状态的 Vue 响应式引用（整体替换，适合只读展示） */
+function usePageUseState() {
+	const state = shallowRef(pageUseStore.get());
+	const off = pageUseStore.subscribe((next) => {
+		state.value = next;
+	});
+	onScopeDispose(off);
+	return state;
+}
+/** 本地设置的 Vue 响应式引用；修改请调用 pageUseSettings.update */
+function usePageUseSettings() {
+	const state = shallowRef(pageUseSettings.get());
+	const off = pageUseSettings.store.subscribe((next) => {
+		state.value = next;
+	});
+	onScopeDispose(off);
+	return state;
+}
+
+//#endregion
+export { DEFAULT_MAX_STEPS, DEFAULT_MODEL, DEFAULT_PAGE_USE_SETTINGS, DEFAULT_SESSION_HEADER, DEFAULT_STORAGE_KEY_PREFIX, PAGE_USE_COMMAND_TYPE, PAGE_USE_GLOBAL_KEY, PAGE_USE_GLOW_TAG, PAGE_USE_LAUNCHER_TAG, PAGE_USE_MASK_COLORS, PAGE_USE_STATIC_PRESETS, PAGE_USE_TOOL, PAGE_USE_TOOL_NAME, PageUseGlowElement, PageUseHost, PageUseLauncherElement, SIMULATOR_MASK_ID, buildMenuPresets, clearPageUseLog, createPageUse, definePageUseElements, formatPageUseResultForModel, getElapsedSeconds, getPageUseConfig, isPageUseCommand, isPageUseConfigured, isRunning, mountPageUseUI, normalizeOptions, pageUseCapability, pageUseHistory, pageUseSettings, pageUseStore, readLauncherSwitch, runPageUseTool, usePageUseSettings, usePageUseState, withVueRouter };

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@tanzerfe/page-use",
+  "private": false,
+  "version": "0.0.2",
+  "description": "基于 page-agent 的页面操作智能体：自然语言指令驱动页面点击与输入，框架无关，附 Web Component 调试面板与 Vue 适配层",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./vue": {
+      "types": "./dist/vue.d.mts",
+      "import": "./dist/vue.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "page-agent",
+    "ai",
+    "agent",
+    "web-component",
+    "lit",
+    "vue"
+  ],
+  "author": "TanzerFE Team",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "vue": "^3.3.0",
+    "vue-router": "^4.0.0",
+    "zod": "^3.25.0 || ^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vue": {
+      "optional": true
+    },
+    "vue-router": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "lit": "^3.3.3",
+    "page-agent": "1.12.4"
+  },
+  "devDependencies": {
+    "jsdom": "^30.1.1",
+    "tsdown": "^0.23.0",
+    "typescript": "^5.9.3",
+    "vite": "^8.3.0",
+    "vitest": "^5.0.1",
+    "vue": "^3.5.43",
+    "vue-router": "^4.6.4",
+    "zod": "^4.6.5"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}