@tanzerfe/page-use 0.0.9 → 0.0.10

package/dist/{index-BACVE8Ig.d.mts → index-DAwlbs2a.d.mts}

@@ -442,11 +442,18 @@ declare class PageUseLauncherElement extends LitElement {
   private fabFromWidth;
   /** 进行中宽度过渡的结束回调注销函数；过渡中再次切换时先注销，避免旧回调提前清除宽度 */
   private fabWidthCleanup;
+  /** 本次入口手势是否已判定为拖动。指针捕获会把手势结束后浏览器补发的 click 重定向到入口，该 click 不是点击意图，不得展开面板。 */
+  private fabDragged;
   /**
-   * 本次入口手势是否已判定为拖动。
-   * 指针捕获会把手势结束后浏览器补发的 click 重定向到入口，该 click 不是点击意图，不得展开面板。
+   * 移动端面板的纵向位移（px，0 为贴底原位）。跟手期间由指针事件直写样式，不进入响应式状态：
+   * 每帧触发模板重渲染会带来不必要的开销，且重渲染写 style 属性会覆盖内联位移。
+   * 也不写入设置，位移不持久化。
    */
-  private fabDragged;
+  private sheetOffsetY;
+  /** 本次下拉手势的纵向位移采样，用于松手判定与速度计算 */
+  private sheetSamples;
+  /** 进行中的面板位移动效的取消函数；调用后等待中的收起流程会中止 */
+  private sheetAnimCancel;
   private cleanups;
   /** 生效的面板布局：未声明或取值非法时按桌面端处理，既有接入方的行为不变 */
   private get isMobileLayout();
@@ -521,7 +528,31 @@ declare class PageUseLauncherElement extends LitElement {
   /** 在面板内显示轻提示，TOAST_DURATION_MS 后自动消失；连续触发时以最后一次为准并重新计时 */
   private showToast;
   private clearHistory;
+  /**
+   * 收起面板为浮动入口。移动端先向下滑出视口再隐藏，滑出期间面板不拦截页面点击——
+   * 「执行后自动收起」时页面上紧接着就是 agent 的操作，动画不能挡住它。
+   * 系统关闭动态效果（过渡时长为 0）时直接隐藏，不做动效。
+   */
   private collapse;
+  /** 面板过渡被禁用时为 true：系统「减少动态效果」或样式未生效，此时直接切换状态 */
+  private sheetMotionDisabled;
+  /** 写入面板纵向位移；0 表示回到贴底原位 */
+  private setSheetOffset;
+  /** 清除位移与内联过渡：先关过渡再清位移，避免清除动作本身被过渡动画化 */
+  private resetSheetStyles;
+  /** 取消进行中的位移动效并让面板回到原位；等待中的收起流程因取消而中止 */
+  private cancelSheetAnimation;
+  /**
+   * 把面板位移过渡到目标值，返回是否走到终点（被 cancelSheetAnimation 取消时为 false）。
+   * 过渡事件缺失（元素被隐藏、标签页切到后台）时由定时器兜底结束，面板不停在半途。
+   */
+  private sheetTransition;
+  /** 下拉手势开始：终止进行中的动效，并关闭过渡让面板直接跟手 */
+  private beginSheetGesture;
+  /** 跟手位移：只认纵向占优的向下拖动；上滑与横向拖动不移动面板（面板没有第二档高度可展开） */
+  private onSheetDragMove;
+  /** 松手：按位移或速度判定收起，否则回弹归位 */
+  private onSheetDragEnd;
   /** tourStyle：快捷指令携带的讲解风格；输入框提交时不传，按面板设置与宿主默认 */
   private submit;
   private applyPreset;

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as DEFAULT_TOUR_MAX_TAB_SWITCHES, A as PageUseGlobal, B as MountPageUseUIOptions, C as getElapsedSeconds, Ct as PageUseTaskResult, D as pageUseStore, E as isRunning, F as PAGE_USE_TOOL_NAME, G as PageUseLauncherElement, H as mountPageUseUI, I as PageUseCommand, J as createPageUse, K as PageUseLauncherLayout, L as formatPageUseResultForModel, M as showPageUseLauncher, N as PAGE_USE_COMMAND_TYPE, O as ReadonlyStore, P as PAGE_USE_TOOL, Q as DEFAULT_STORAGE_KEY_PREFIX, R as isPageUseCommand, S as clearPageUseLog, St as PageUseStepLog, T as isPageUseConfigured, Tt as PageUseTaskStatus, U as PAGE_USE_LAUNCHER_TAG, V as definePageUseElements, W as PageUseLauncherConfig, X as DEFAULT_MODEL, Y as DEFAULT_MAX_STEPS, Z as DEFAULT_SESSION_HEADER, _ as pageUseSettings, _t as PageUseMenuNode, a as PAGE_USE_ROBOT_ICON_SVG, at as normalizeOptions, b as PageUseQuestion, bt as PageUseRunOptions, c as PageUseCustomPreset, ct as PageUseTtsSpeakOptions, d as pageUsePresets, dt as PageUseTourStyle, et as NormalizedPageUseOptions, f as PageUseHistoryEntry, ft as TOUR_STYLE_TRAINER, g as PageUseSettings, gt as PageUseErrorCode, h as PageUsePoint, ht as pageUseCapability, i as PageUseGlowElement, it as PageUseTourOptions, j as hidePageUseLauncher, k as PAGE_USE_GLOBAL_KEY, l as PageUsePresetSaveResult, lt as PageUseTtsVoice, m as DEFAULT_PAGE_USE_SETTINGS, mt as PageUseCapability, n as SIMULATOR_MASK_ID, nt as PageUseOptions, o as PAGE_USE_STATIC_PRESETS, ot as readLauncherSwitch, p as pageUseHistory, pt as TOUR_STYLE_USER, q as PageUseHandle, r as PAGE_USE_GLOW_TAG, rt as PageUseRouterMode, s as buildMenuPresets, st as PageUseTtsEngine, t as PAGE_USE_MASK_COLORS, tt as PageUseLLMOptions, u as PageUsePresetState, ut as DEFAULT_TOUR_STYLES, v as BROWSER_ENGINE_ID, vt as PageUsePreset, w as getPageUseConfig, wt as PageUseTaskSource, x as PageUseState, xt as PageUseSnapshot, y as browserTtsEngine, yt as PageUseProgressEvent, z as runPageUseTool } from "./index-BACVE8Ig.mjs";
+import { $ as DEFAULT_TOUR_MAX_TAB_SWITCHES, A as PageUseGlobal, B as MountPageUseUIOptions, C as getElapsedSeconds, Ct as PageUseTaskResult, D as pageUseStore, E as isRunning, F as PAGE_USE_TOOL_NAME, G as PageUseLauncherElement, H as mountPageUseUI, I as PageUseCommand, J as createPageUse, K as PageUseLauncherLayout, L as formatPageUseResultForModel, M as showPageUseLauncher, N as PAGE_USE_COMMAND_TYPE, O as ReadonlyStore, P as PAGE_USE_TOOL, Q as DEFAULT_STORAGE_KEY_PREFIX, R as isPageUseCommand, S as clearPageUseLog, St as PageUseStepLog, T as isPageUseConfigured, Tt as PageUseTaskStatus, U as PAGE_USE_LAUNCHER_TAG, V as definePageUseElements, W as PageUseLauncherConfig, X as DEFAULT_MODEL, Y as DEFAULT_MAX_STEPS, Z as DEFAULT_SESSION_HEADER, _ as pageUseSettings, _t as PageUseMenuNode, a as PAGE_USE_ROBOT_ICON_SVG, at as normalizeOptions, b as PageUseQuestion, bt as PageUseRunOptions, c as PageUseCustomPreset, ct as PageUseTtsSpeakOptions, d as pageUsePresets, dt as PageUseTourStyle, et as NormalizedPageUseOptions, f as PageUseHistoryEntry, ft as TOUR_STYLE_TRAINER, g as PageUseSettings, gt as PageUseErrorCode, h as PageUsePoint, ht as pageUseCapability, i as PageUseGlowElement, it as PageUseTourOptions, j as hidePageUseLauncher, k as PAGE_USE_GLOBAL_KEY, l as PageUsePresetSaveResult, lt as PageUseTtsVoice, m as DEFAULT_PAGE_USE_SETTINGS, mt as PageUseCapability, n as SIMULATOR_MASK_ID, nt as PageUseOptions, o as PAGE_USE_STATIC_PRESETS, ot as readLauncherSwitch, p as pageUseHistory, pt as TOUR_STYLE_USER, q as PageUseHandle, r as PAGE_USE_GLOW_TAG, rt as PageUseRouterMode, s as buildMenuPresets, st as PageUseTtsEngine, t as PAGE_USE_MASK_COLORS, tt as PageUseLLMOptions, u as PageUsePresetState, ut as DEFAULT_TOUR_STYLES, v as BROWSER_ENGINE_ID, vt as PageUsePreset, w as getPageUseConfig, wt as PageUseTaskSource, x as PageUseState, xt as PageUseSnapshot, y as browserTtsEngine, yt as PageUseProgressEvent, z as runPageUseTool } from "./index-DAwlbs2a.mjs";
 export { BROWSER_ENGINE_ID, DEFAULT_MAX_STEPS, DEFAULT_MODEL, DEFAULT_PAGE_USE_SETTINGS, DEFAULT_SESSION_HEADER, DEFAULT_STORAGE_KEY_PREFIX, DEFAULT_TOUR_MAX_TAB_SWITCHES, DEFAULT_TOUR_STYLES, 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_ROBOT_ICON_SVG, PAGE_USE_STATIC_PRESETS, PAGE_USE_TOOL, PAGE_USE_TOOL_NAME, type PageUseCapability, type PageUseCommand, type PageUseCustomPreset, type PageUseErrorCode, type PageUseGlobal, PageUseGlowElement, type PageUseHandle, type PageUseHistoryEntry, type PageUseLLMOptions, type PageUseLauncherConfig, PageUseLauncherElement, type PageUseLauncherLayout, type PageUseMenuNode, type PageUseOptions, type PageUsePoint, type PageUsePreset, type PageUsePresetSaveResult, type PageUsePresetState, type PageUseProgressEvent, type PageUseQuestion, type PageUseRouterMode, type PageUseRunOptions, type PageUseSettings, type PageUseSnapshot, type PageUseState, type PageUseStepLog, type PageUseTaskResult, type PageUseTaskSource, type PageUseTaskStatus, type PageUseTourOptions, type PageUseTourStyle, type PageUseTtsEngine, type PageUseTtsSpeakOptions, type PageUseTtsVoice, type ReadonlyStore, SIMULATOR_MASK_ID, TOUR_STYLE_TRAINER, TOUR_STYLE_USER, browserTtsEngine, buildMenuPresets, clearPageUseLog, createPageUse, definePageUseElements, formatPageUseResultForModel, getElapsedSeconds, getPageUseConfig, hidePageUseLauncher, isPageUseCommand, isPageUseConfigured, isRunning, mountPageUseUI, normalizeOptions, pageUseCapability, pageUseHistory, pageUsePresets, pageUseSettings, pageUseStore, readLauncherSwitch, runPageUseTool, showPageUseLauncher };

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { A as pageUseSettings, B as BROWSER_ENGINE_ID, C as getPageUseConfig, D as pageUsePresets, E as pageUseStore, F as DEFAULT_TOUR_MAX_TAB_SWITCHES, H as DEFAULT_TOUR_STYLES, I as normalizeOptions, L as readLauncherSwitch, M as DEFAULT_MODEL, N as DEFAULT_SESSION_HEADER, O as pageUseHistory, P as DEFAULT_STORAGE_KEY_PREFIX, R as PAGE_USE_MASK_COLORS, S as getElapsedSeconds, T as isRunning, U as TOUR_STYLE_TRAINER, V as browserTtsEngine, W as TOUR_STYLE_USER, _ as runPageUseTool, a as PAGE_USE_STATIC_PRESETS, b as pageUseCapability, c as PAGE_USE_GLOW_TAG, d as PAGE_USE_GLOBAL_KEY, f as PAGE_USE_COMMAND_TYPE, g as isPageUseCommand, h as formatPageUseResultForModel, i as PageUseLauncherElement, j as DEFAULT_MAX_STEPS, k as DEFAULT_PAGE_USE_SETTINGS, l as PageUseGlowElement, m as PAGE_USE_TOOL_NAME, n as mountPageUseUI, o as buildMenuPresets, p as PAGE_USE_TOOL, r as PAGE_USE_LAUNCHER_TAG, s as PAGE_USE_ROBOT_ICON_SVG, t as definePageUseElements, u as createPageUse, v as hidePageUseLauncher, w as isPageUseConfigured, x as clearPageUseLog, y as showPageUseLauncher, z as SIMULATOR_MASK_ID } from "./src-MjVXh_cW.mjs";
+import { A as pageUseSettings, B as BROWSER_ENGINE_ID, C as getPageUseConfig, D as pageUsePresets, E as pageUseStore, F as DEFAULT_TOUR_MAX_TAB_SWITCHES, H as DEFAULT_TOUR_STYLES, I as normalizeOptions, L as readLauncherSwitch, M as DEFAULT_MODEL, N as DEFAULT_SESSION_HEADER, O as pageUseHistory, P as DEFAULT_STORAGE_KEY_PREFIX, R as PAGE_USE_MASK_COLORS, S as getElapsedSeconds, T as isRunning, U as TOUR_STYLE_TRAINER, V as browserTtsEngine, W as TOUR_STYLE_USER, _ as runPageUseTool, a as PAGE_USE_STATIC_PRESETS, b as pageUseCapability, c as PAGE_USE_GLOW_TAG, d as PAGE_USE_GLOBAL_KEY, f as PAGE_USE_COMMAND_TYPE, g as isPageUseCommand, h as formatPageUseResultForModel, i as PageUseLauncherElement, j as DEFAULT_MAX_STEPS, k as DEFAULT_PAGE_USE_SETTINGS, l as PageUseGlowElement, m as PAGE_USE_TOOL_NAME, n as mountPageUseUI, o as buildMenuPresets, p as PAGE_USE_TOOL, r as PAGE_USE_LAUNCHER_TAG, s as PAGE_USE_ROBOT_ICON_SVG, t as definePageUseElements, u as createPageUse, v as hidePageUseLauncher, w as isPageUseConfigured, x as clearPageUseLog, y as showPageUseLauncher, z as SIMULATOR_MASK_ID } from "./src-nVu9CCnz.mjs";
 
 export { BROWSER_ENGINE_ID, DEFAULT_MAX_STEPS, DEFAULT_MODEL, DEFAULT_PAGE_USE_SETTINGS, DEFAULT_SESSION_HEADER, DEFAULT_STORAGE_KEY_PREFIX, DEFAULT_TOUR_MAX_TAB_SWITCHES, DEFAULT_TOUR_STYLES, PAGE_USE_COMMAND_TYPE, PAGE_USE_GLOBAL_KEY, PAGE_USE_GLOW_TAG, PAGE_USE_LAUNCHER_TAG, PAGE_USE_MASK_COLORS, PAGE_USE_ROBOT_ICON_SVG, PAGE_USE_STATIC_PRESETS, PAGE_USE_TOOL, PAGE_USE_TOOL_NAME, PageUseGlowElement, PageUseLauncherElement, SIMULATOR_MASK_ID, TOUR_STYLE_TRAINER, TOUR_STYLE_USER, browserTtsEngine, buildMenuPresets, clearPageUseLog, createPageUse, definePageUseElements, formatPageUseResultForModel, getElapsedSeconds, getPageUseConfig, hidePageUseLauncher, isPageUseCommand, isPageUseConfigured, isRunning, mountPageUseUI, normalizeOptions, pageUseCapability, pageUseHistory, pageUsePresets, pageUseSettings, pageUseStore, readLauncherSwitch, runPageUseTool, showPageUseLauncher };

package/dist/{src-MjVXh_cW.mjs → src-nVu9CCnz.mjs}

@@ -3045,7 +3045,7 @@ var PageUseGlowElement = class extends LitElement {
 
 //#endregion
 //#region package.json
-var version = "0.0.9";
+var version = "0.0.10";
 
 //#endregion
 //#region src/ui/drag.ts
@@ -3085,25 +3085,30 @@ function createDrag(options) {
 			if (!moved && Math.hypot(dx, dy) < DRAG_THRESHOLD) return;
 			if (!moved) options.onDragStart?.();
 			moved = true;
+			options.onMove?.(dx, dy);
 			options.setPos(clampToViewport({
 				x: rect.left + dx,
 				y: rect.top + dy
 			}, el));
 		};
-		const onUp = () => {
+		const finish = (cancelled) => {
+			if (!dragging) return;
 			dragging = false;
 			handle.removeEventListener("pointermove", onMove);
 			handle.removeEventListener("pointerup", onUp);
-			handle.removeEventListener("pointercancel", onUp);
+			handle.removeEventListener("pointercancel", onCancel);
 			try {
 				handle.releasePointerCapture(event.pointerId);
 			} catch {}
+			options.onEnd?.({ cancelled });
 			if (!moved) options.onTap?.(tapTarget);
 		};
+		const onUp = () => finish(false);
+		const onCancel = () => finish(true);
 		handle.setPointerCapture(event.pointerId);
 		handle.addEventListener("pointermove", onMove);
 		handle.addEventListener("pointerup", onUp);
-		handle.addEventListener("pointercancel", onUp);
+		handle.addEventListener("pointercancel", onCancel);
 		event.preventDefault();
 	}
 	/** 视口尺寸变化后把已存位置夹回可见区域 */
@@ -3117,6 +3122,46 @@ function createDrag(options) {
 		reclamp
 	};
 }
+/** 判定收起所需的纵向位移占面板高度的比例 */
+const SHEET_DISTANCE_RATIO = .25;
+/** 判定收起所需的纵向速度（px/ms） */
+const SHEET_VELOCITY_THRESHOLD = .5;
+/** 速度取样的时间窗口（ms）：只取最近这一段，避免起手时的慢速稀释甩动判定 */
+const SHEET_VELOCITY_WINDOW_MS = 100;
+/** 速度判定要求的最小位移（px）：防止轻微抖动被当成甩动 */
+const SHEET_VELOCITY_MIN_DISTANCE = 24;
+/** 滑出时长的基准值（ms）与折算系数：剩余距离越短越快结束，避免短距离也拖满整个时长 */
+const SHEET_EXIT_BASE_MS = 120;
+const SHEET_EXIT_MAX_MS = 220;
+const SHEET_EXIT_PER_PX = .35;
+/** 滑出时长（ms）：随剩余距离增长，上限 220ms（需求上限为 240ms） */
+function sheetExitDuration(remainingPx) {
+	return Math.min(SHEET_EXIT_MAX_MS, SHEET_EXIT_BASE_MS + Math.max(0, remainingPx) * SHEET_EXIT_PER_PX);
+}
+/**
+* 松手判定：位移达到面板高度的四分之一，或最近 100ms 的平均速度达到阈值且位移足够时收起。
+* 手势被系统中断时一律回弹——中断不代表用户表达了收起意图。
+*/
+function decideSheetRelease(samples, options) {
+	if (options.cancelled) return "snapback";
+	const last = samples[samples.length - 1];
+	if (!last) return "snapback";
+	if (last.dy >= options.panelHeight * SHEET_DISTANCE_RATIO) return "dismiss";
+	if (last.dy < SHEET_VELOCITY_MIN_DISTANCE) return "snapback";
+	return sheetReleaseVelocity(samples, last) >= SHEET_VELOCITY_THRESHOLD ? "dismiss" : "snapback";
+}
+/**
+* 最近一个时间窗口内的平均纵向速度（px/ms）。
+* 窗口内不足两个采样时（采样稀疏、间隔超过窗口）退回上一个采样，否则速度不可测。
+*/
+function sheetReleaseVelocity(samples, last) {
+	const windowStart = last.t - SHEET_VELOCITY_WINDOW_MS;
+	const index = samples.findIndex((sample) => sample.t >= windowStart);
+	const start = index < samples.length - 1 ? samples[index] : samples[Math.max(0, samples.length - 2)];
+	const dt = last.t - start.t;
+	if (dt <= 0) return 0;
+	return (last.dy - start.dy) / dt;
+}
 
 //#endregion
 //#region src/ui/formatTokens.ts
@@ -3419,6 +3464,10 @@ const launcherStyles = css`
     .fab {
       transition: none;
     }
+    /* 面板位移过渡关闭后，launcher 读到 transitionDuration 为 0，收起与回弹直接切换状态 */
+    .panel.mobile {
+      transition: none;
+    }
     .fab,
     .panel::before,
     .fab.running .robot-antenna,
@@ -3526,12 +3575,34 @@ const launcherStyles = css`
     height: 70dvh;
     /* 底边与屏幕贴合，去掉下圆角 */
     border-radius: 12px 12px 0 0;
+    /*
+     * 下拉收起与回弹通过 transform 位移实现。过渡声明的另一作用是作为「可播放动效」的判据：
+     * launcher 读取生效的 transitionDuration，为 0 时（下方减少动态效果媒体查询）直接切换状态。
+     * 跟手期间由 launcher 临时置为 none，避免位移被过渡拖慢。
+     */
+    transition: transform 180ms cubic-bezier(0.22, 1, 0.36, 1);
   }
-  /* 位置由布局决定，头部不再是拖动区域；仍保留按下检测，用于标题连点解锁元信息 */
+  /*
+   * 移动端头部：位置由布局决定，不再是拖动改位置的区域，但仍保留按下检测——
+   * 向下拉动即收起面板。touch-action 必须保持 none：否则浏览器把手势解释为滚动或下拉刷新，
+   * 中途以 pointercancel 打断指针流，且 pointerdown 上的 preventDefault 对触摸滚动无效。
+   */
   .panel.mobile .head,
   .panel.mobile .head:active {
+    position: relative;
     cursor: default;
-    touch-action: auto;
+    touch-action: none;
+  }
+  /* 抓取条：绝对定位在头部顶端居中，不参与布局流，面板几何与桌面端头部高度均不受影响 */
+  .panel.mobile .grabber {
+    position: absolute;
+    top: 4px;
+    left: 50%;
+    width: 32px;
+    height: 4px;
+    margin-left: -16px;
+    border-radius: 2px;
+    background: rgba(100, 116, 139, 0.45);
   }
   /* 底边与屏幕贴合，不需要下圆角；底部内边距让出 iPhone 手势条 */
   .panel.mobile .composer {
@@ -4220,6 +4291,10 @@ const TEXTAREA_MIN_ROWS = 2;
 /** 元信息面板解锁：任意连续 META_UNLOCK_WINDOW_MS 毫秒内点击标题达到 META_UNLOCK_CLICKS 次（滑动窗口） */
 const META_UNLOCK_WINDOW_MS = 5e3;
 const META_UNLOCK_CLICKS = 10;
+/** 面板位移过渡曲线：下拉滑出与回弹共用，接近 iOS 的减速曲线 */
+const SHEET_EASING = "cubic-bezier(0.22, 1, 0.36, 1)";
+/** 面板位移动效兜底时长（ms）：过渡事件丢失时据此结束动效，避免面板停在半途 */
+const SHEET_ANIM_FALLBACK_MS = 60;
 /** 面板内轻提示（toast）的显示时长（毫秒） */
 const TOAST_DURATION_MS = 2e3;
 /** 标题栏返回按钮的目标视图：按层级返回；main 无上级，此时按钮用于进入设置页 */
@@ -4320,11 +4395,18 @@ var PageUseLauncherElement = class extends LitElement {
 	fabFromWidth = null;
 	/** 进行中宽度过渡的结束回调注销函数；过渡中再次切换时先注销，避免旧回调提前清除宽度 */
 	fabWidthCleanup = null;
+	/** 本次入口手势是否已判定为拖动。指针捕获会把手势结束后浏览器补发的 click 重定向到入口，该 click 不是点击意图，不得展开面板。 */
+	fabDragged = false;
 	/**
-	* 本次入口手势是否已判定为拖动。
-	* 指针捕获会把手势结束后浏览器补发的 click 重定向到入口，该 click 不是点击意图，不得展开面板。
+	* 移动端面板的纵向位移（px，0 为贴底原位）。跟手期间由指针事件直写样式，不进入响应式状态：
+	* 每帧触发模板重渲染会带来不必要的开销，且重渲染写 style 属性会覆盖内联位移。
+	* 也不写入设置，位移不持久化。
 	*/
-	fabDragged = false;
+	sheetOffsetY = 0;
+	/** 本次下拉手势的纵向位移采样，用于松手判定与速度计算 */
+	sheetSamples = [];
+	/** 进行中的面板位移动效的取消函数；调用后等待中的收起流程会中止 */
+	sheetAnimCancel = null;
 	cleanups = [];
 	/** 生效的面板布局：未声明或取值非法时按桌面端处理，既有接入方的行为不变 */
 	get isMobileLayout() {
@@ -4365,6 +4447,9 @@ var PageUseLauncherElement = class extends LitElement {
 		onTap: (target) => {
 			if (target?.closest?.(".title")) this.onTitleTap();
 		},
+		onDragStart: () => this.beginSheetGesture(),
+		onMove: (dx, dy) => this.onSheetDragMove(dx, dy),
+		onEnd: ({ cancelled }) => this.onSheetDragEnd(cancelled),
 		setPos: ({ x, y }) => {
 			if (this.isMobileLayout) return;
 			const el = this.panelEl;
@@ -4403,6 +4488,7 @@ var PageUseLauncherElement = class extends LitElement {
 		this.unregisterPanelName?.();
 		this.unregisterPanelName = null;
 		stopPreview();
+		this.cancelSheetAnimation();
 		window.removeEventListener("resize", this.onResize);
 		if (this.toastTimer) clearTimeout(this.toastTimer);
 		this.toastTimer = null;
@@ -4593,6 +4679,7 @@ var PageUseLauncherElement = class extends LitElement {
 		}
 		this.measureFab();
 		this.resolvePanelAnchor();
+		this.cancelSheetAnimation();
 		this.open = true;
 		this.requestUpdate();
 	};
@@ -4601,6 +4688,7 @@ var PageUseLauncherElement = class extends LitElement {
 		await this.updateComplete;
 		this.measureFab();
 		this.resolvePanelAnchor();
+		this.cancelSheetAnimation();
 		this.open = true;
 		this.requestUpdate();
 	}
@@ -4645,13 +4733,125 @@ var PageUseLauncherElement = class extends LitElement {
 		pageUseHistory.clear();
 		this.showToast(count ? `已清空 ${count} 条历史指令` : "暂无历史指令");
 	}
+	/**
+	* 收起面板为浮动入口。移动端先向下滑出视口再隐藏，滑出期间面板不拦截页面点击——
+	* 「执行后自动收起」时页面上紧接着就是 agent 的操作，动画不能挡住它。
+	* 系统关闭动态效果（过渡时长为 0）时直接隐藏，不做动效。
+	*/
 	async collapse() {
 		stopPreview();
+		const el = this.panelEl;
+		if (this.isMobileLayout && el && !this.sheetMotionDisabled(el)) {
+			el.style.pointerEvents = "none";
+			const remaining = Math.max(0, el.offsetHeight - this.sheetOffsetY);
+			const completed = await this.sheetTransition(el, el.offsetHeight, sheetExitDuration(remaining));
+			el.style.pointerEvents = "";
+			if (!completed) return;
+		}
 		this.open = false;
 		this.requestUpdate();
 		await this.updateComplete;
 		this.measureFab();
 		this.fabDrag.reclamp();
+		if (el) this.resetSheetStyles(el);
+	}
+	/** 面板过渡被禁用时为 true：系统「减少动态效果」或样式未生效，此时直接切换状态 */
+	sheetMotionDisabled(el) {
+		return parseFloat(getComputedStyle(el).transitionDuration) === 0;
+	}
+	/** 写入面板纵向位移；0 表示回到贴底原位 */
+	setSheetOffset(el, offsetY) {
+		this.sheetOffsetY = offsetY;
+		el.style.transform = offsetY ? `translateY(${offsetY}px)` : "";
+	}
+	/** 清除位移与内联过渡：先关过渡再清位移，避免清除动作本身被过渡动画化 */
+	resetSheetStyles(el) {
+		el.style.transition = "none";
+		this.setSheetOffset(el, 0);
+		el.style.transition = "";
+	}
+	/** 取消进行中的位移动效并让面板回到原位；等待中的收起流程因取消而中止 */
+	cancelSheetAnimation() {
+		const cancel = this.sheetAnimCancel;
+		this.sheetAnimCancel = null;
+		cancel?.();
+		const el = this.panelEl;
+		if (el && this.sheetOffsetY) this.resetSheetStyles(el);
+	}
+	/**
+	* 把面板位移过渡到目标值，返回是否走到终点（被 cancelSheetAnimation 取消时为 false）。
+	* 过渡事件缺失（元素被隐藏、标签页切到后台）时由定时器兜底结束，面板不停在半途。
+	*/
+	sheetTransition(el, target, duration) {
+		return new Promise((resolve) => {
+			let settled = false;
+			let timer;
+			const finish = (completed) => {
+				if (settled) return;
+				settled = true;
+				el.removeEventListener("transitionend", onEnd);
+				el.removeEventListener("transitioncancel", onCancel);
+				if (timer !== void 0) clearTimeout(timer);
+				if (this.sheetAnimCancel === cancel) this.sheetAnimCancel = null;
+				resolve(completed);
+			};
+			const cancel = () => finish(false);
+			const onEnd = (event) => {
+				if (event.propertyName === "transform") finish(true);
+			};
+			const onCancel = (event) => {
+				if (event.propertyName === "transform") finish(false);
+			};
+			timer = setTimeout(() => finish(true), duration + SHEET_ANIM_FALLBACK_MS);
+			this.sheetAnimCancel = cancel;
+			el.addEventListener("transitionend", onEnd);
+			el.addEventListener("transitioncancel", onCancel);
+			el.style.transition = `transform ${duration}ms ${SHEET_EASING}`;
+			el.style.transform = `translateY(${target}px)`;
+		});
+	}
+	/** 下拉手势开始：终止进行中的动效，并关闭过渡让面板直接跟手 */
+	beginSheetGesture() {
+		if (!this.isMobileLayout) return;
+		this.cancelSheetAnimation();
+		this.sheetSamples = [];
+		const el = this.panelEl;
+		if (el) el.style.transition = "none";
+	}
+	/** 跟手位移：只认纵向占优的向下拖动；上滑与横向拖动不移动面板（面板没有第二档高度可展开） */
+	onSheetDragMove(dx, dy) {
+		if (!this.isMobileLayout) return;
+		const el = this.panelEl;
+		if (!el) return;
+		const offsetY = dy > 0 && Math.abs(dy) > Math.abs(dx) ? dy : 0;
+		this.sheetSamples.push({
+			t: performance.now(),
+			dy: offsetY
+		});
+		this.setSheetOffset(el, offsetY);
+	}
+	/** 松手：按位移或速度判定收起，否则回弹归位 */
+	onSheetDragEnd(cancelled) {
+		if (!this.isMobileLayout) return;
+		const el = this.panelEl;
+		const samples = this.sheetSamples;
+		this.sheetSamples = [];
+		if (!el) return;
+		if (decideSheetRelease(samples, {
+			panelHeight: el.offsetHeight,
+			cancelled
+		}) === "dismiss") {
+			this.collapse();
+			return;
+		}
+		if (!this.sheetOffsetY) return;
+		if (this.sheetMotionDisabled(el)) {
+			this.resetSheetStyles(el);
+			return;
+		}
+		this.sheetTransition(el, 0, 180).then((completed) => {
+			if (completed) this.resetSheetStyles(el);
+		});
 	}
 	/** tourStyle：快捷指令携带的讲解风格；输入框提交时不传，按面板设置与宿主默认 */
 	async submit(tourStyle) {
@@ -5306,6 +5506,7 @@ var PageUseLauncherElement = class extends LitElement {
         style=${this.open ? this.panelStyle(settings) : ""}
       >
         <header class="head" @pointerdown=${this.panelDrag.onPointerDown}>
+          ${this.isMobileLayout ? html`<span class="grabber" aria-hidden="true"></span>` : nothing}
           <span class="dot ${state.status}" title=${STATUS_LABELS[state.status] || state.status}></span>
           <span class="title">${title}</span>
           <span class="status">

package/dist/vue.d.mts

@@ -1,4 +1,4 @@
-import { $ as DEFAULT_TOUR_MAX_TAB_SWITCHES, A as PageUseGlobal, B as MountPageUseUIOptions, C as getElapsedSeconds, Ct as PageUseTaskResult, D as pageUseStore, E as isRunning, F as PAGE_USE_TOOL_NAME, G as PageUseLauncherElement, H as mountPageUseUI, I as PageUseCommand, J as createPageUse, K as PageUseLauncherLayout, L as formatPageUseResultForModel, M as showPageUseLauncher, N as PAGE_USE_COMMAND_TYPE, O as ReadonlyStore, P as PAGE_USE_TOOL, Q as DEFAULT_STORAGE_KEY_PREFIX, R as isPageUseCommand, S as clearPageUseLog, St as PageUseStepLog, T as isPageUseConfigured, Tt as PageUseTaskStatus, U as PAGE_USE_LAUNCHER_TAG, V as definePageUseElements, W as PageUseLauncherConfig, X as DEFAULT_MODEL, Y as DEFAULT_MAX_STEPS, Z as DEFAULT_SESSION_HEADER, _ as pageUseSettings, _t as PageUseMenuNode, a as PAGE_USE_ROBOT_ICON_SVG, at as normalizeOptions, b as PageUseQuestion, bt as PageUseRunOptions, c as PageUseCustomPreset, ct as PageUseTtsSpeakOptions, d as pageUsePresets, dt as PageUseTourStyle, et as NormalizedPageUseOptions, f as PageUseHistoryEntry, ft as TOUR_STYLE_TRAINER, g as PageUseSettings, gt as PageUseErrorCode, h as PageUsePoint, ht as pageUseCapability, i as PageUseGlowElement, it as PageUseTourOptions, j as hidePageUseLauncher, k as PAGE_USE_GLOBAL_KEY, l as PageUsePresetSaveResult, lt as PageUseTtsVoice, m as DEFAULT_PAGE_USE_SETTINGS, mt as PageUseCapability, n as SIMULATOR_MASK_ID, nt as PageUseOptions, o as PAGE_USE_STATIC_PRESETS, ot as readLauncherSwitch, p as pageUseHistory, pt as TOUR_STYLE_USER, q as PageUseHandle, r as PAGE_USE_GLOW_TAG, rt as PageUseRouterMode, s as buildMenuPresets, st as PageUseTtsEngine, t as PAGE_USE_MASK_COLORS, tt as PageUseLLMOptions, u as PageUsePresetState, ut as DEFAULT_TOUR_STYLES, v as BROWSER_ENGINE_ID, vt as PageUsePreset, w as getPageUseConfig, wt as PageUseTaskSource, x as PageUseState, xt as PageUseSnapshot, y as browserTtsEngine, yt as PageUseProgressEvent, z as runPageUseTool } from "./index-BACVE8Ig.mjs";
+import { $ as DEFAULT_TOUR_MAX_TAB_SWITCHES, A as PageUseGlobal, B as MountPageUseUIOptions, C as getElapsedSeconds, Ct as PageUseTaskResult, D as pageUseStore, E as isRunning, F as PAGE_USE_TOOL_NAME, G as PageUseLauncherElement, H as mountPageUseUI, I as PageUseCommand, J as createPageUse, K as PageUseLauncherLayout, L as formatPageUseResultForModel, M as showPageUseLauncher, N as PAGE_USE_COMMAND_TYPE, O as ReadonlyStore, P as PAGE_USE_TOOL, Q as DEFAULT_STORAGE_KEY_PREFIX, R as isPageUseCommand, S as clearPageUseLog, St as PageUseStepLog, T as isPageUseConfigured, Tt as PageUseTaskStatus, U as PAGE_USE_LAUNCHER_TAG, V as definePageUseElements, W as PageUseLauncherConfig, X as DEFAULT_MODEL, Y as DEFAULT_MAX_STEPS, Z as DEFAULT_SESSION_HEADER, _ as pageUseSettings, _t as PageUseMenuNode, a as PAGE_USE_ROBOT_ICON_SVG, at as normalizeOptions, b as PageUseQuestion, bt as PageUseRunOptions, c as PageUseCustomPreset, ct as PageUseTtsSpeakOptions, d as pageUsePresets, dt as PageUseTourStyle, et as NormalizedPageUseOptions, f as PageUseHistoryEntry, ft as TOUR_STYLE_TRAINER, g as PageUseSettings, gt as PageUseErrorCode, h as PageUsePoint, ht as pageUseCapability, i as PageUseGlowElement, it as PageUseTourOptions, j as hidePageUseLauncher, k as PAGE_USE_GLOBAL_KEY, l as PageUsePresetSaveResult, lt as PageUseTtsVoice, m as DEFAULT_PAGE_USE_SETTINGS, mt as PageUseCapability, n as SIMULATOR_MASK_ID, nt as PageUseOptions, o as PAGE_USE_STATIC_PRESETS, ot as readLauncherSwitch, p as pageUseHistory, pt as TOUR_STYLE_USER, q as PageUseHandle, r as PAGE_USE_GLOW_TAG, rt as PageUseRouterMode, s as buildMenuPresets, st as PageUseTtsEngine, t as PAGE_USE_MASK_COLORS, tt as PageUseLLMOptions, u as PageUsePresetState, ut as DEFAULT_TOUR_STYLES, v as BROWSER_ENGINE_ID, vt as PageUsePreset, w as getPageUseConfig, wt as PageUseTaskSource, x as PageUseState, xt as PageUseSnapshot, y as browserTtsEngine, yt as PageUseProgressEvent, z as runPageUseTool } from "./index-DAwlbs2a.mjs";
 import { PropType, ShallowRef } from "vue";
 import { Router } from "vue-router";
 //#region src/vue.d.ts

package/dist/vue.mjs

@@ -1,4 +1,4 @@
-import { A as pageUseSettings, B as BROWSER_ENGINE_ID, C as getPageUseConfig, D as pageUsePresets, E as pageUseStore, F as DEFAULT_TOUR_MAX_TAB_SWITCHES, H as DEFAULT_TOUR_STYLES, I as normalizeOptions, L as readLauncherSwitch, M as DEFAULT_MODEL, N as DEFAULT_SESSION_HEADER, O as pageUseHistory, P as DEFAULT_STORAGE_KEY_PREFIX, R as PAGE_USE_MASK_COLORS, S as getElapsedSeconds, T as isRunning, U as TOUR_STYLE_TRAINER, V as browserTtsEngine, W as TOUR_STYLE_USER, _ as runPageUseTool, a as PAGE_USE_STATIC_PRESETS, b as pageUseCapability, c as PAGE_USE_GLOW_TAG, d as PAGE_USE_GLOBAL_KEY, f as PAGE_USE_COMMAND_TYPE, g as isPageUseCommand, h as formatPageUseResultForModel, i as PageUseLauncherElement, j as DEFAULT_MAX_STEPS, k as DEFAULT_PAGE_USE_SETTINGS, l as PageUseGlowElement, m as PAGE_USE_TOOL_NAME, n as mountPageUseUI, o as buildMenuPresets, p as PAGE_USE_TOOL, r as PAGE_USE_LAUNCHER_TAG, s as PAGE_USE_ROBOT_ICON_SVG, t as definePageUseElements, u as createPageUse, v as hidePageUseLauncher, w as isPageUseConfigured, x as clearPageUseLog, y as showPageUseLauncher, z as SIMULATOR_MASK_ID } from "./src-MjVXh_cW.mjs";
+import { A as pageUseSettings, B as BROWSER_ENGINE_ID, C as getPageUseConfig, D as pageUsePresets, E as pageUseStore, F as DEFAULT_TOUR_MAX_TAB_SWITCHES, H as DEFAULT_TOUR_STYLES, I as normalizeOptions, L as readLauncherSwitch, M as DEFAULT_MODEL, N as DEFAULT_SESSION_HEADER, O as pageUseHistory, P as DEFAULT_STORAGE_KEY_PREFIX, R as PAGE_USE_MASK_COLORS, S as getElapsedSeconds, T as isRunning, U as TOUR_STYLE_TRAINER, V as browserTtsEngine, W as TOUR_STYLE_USER, _ as runPageUseTool, a as PAGE_USE_STATIC_PRESETS, b as pageUseCapability, c as PAGE_USE_GLOW_TAG, d as PAGE_USE_GLOBAL_KEY, f as PAGE_USE_COMMAND_TYPE, g as isPageUseCommand, h as formatPageUseResultForModel, i as PageUseLauncherElement, j as DEFAULT_MAX_STEPS, k as DEFAULT_PAGE_USE_SETTINGS, l as PageUseGlowElement, m as PAGE_USE_TOOL_NAME, n as mountPageUseUI, o as buildMenuPresets, p as PAGE_USE_TOOL, r as PAGE_USE_LAUNCHER_TAG, s as PAGE_USE_ROBOT_ICON_SVG, t as definePageUseElements, u as createPageUse, v as hidePageUseLauncher, w as isPageUseConfigured, x as clearPageUseLog, y as showPageUseLauncher, z as SIMULATOR_MASK_ID } from "./src-nVu9CCnz.mjs";
 import { defineComponent, inject, onBeforeUnmount, onScopeDispose, shallowRef } from "vue";
 import { routerKey } from "vue-router";
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tanzerfe/page-use",
   "private": false,
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "基于 page-agent 的页面操作智能体：自然语言指令驱动页面点击与输入，框架无关，附 Web Component 调试面板与 Vue 适配层",
   "type": "module",
   "main": "./dist/index.mjs",