@greypan/web-ui 12.1.0 → 12.2.0

package/dist/components/drawer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["glass","modalSurface","scrollbarStyle","style","oouiClose"],"sources":["../../../src/components/drawer/index.ts"],"sourcesContent":["import '@/components/button'\nimport '@/components/icon'\n\nimport { html, LitElement, nothing, type PropertyValues, unsafeCSS } from 'lit'\nimport { customElement, property } from 'lit/decorators.js'\n\nimport modalSurface from '@/assets/modal-surface.css?inline'\nimport scrollbarStyle from '@/assets/scrollbar.css?inline'\nimport glass from '@/classes/glass.css?inline'\nimport { oouiClose } from '@/icons'\nimport { ElementHeightController } from '@/shared/element-height'\nimport { UserChangeController } from '@/shared/events/user-change'\nimport { trapTabKey } from '@/shared/focus/tabbable'\nimport { attachDragGesture, dampOverscroll, type DragGestureHandle } from '@/shared/gesture'\nimport { resolveBuiltinLabel } from '@/shared/locale/builtin-labels'\nimport { normalizeLiteral } from '@/shared/normalize'\nimport { dispatchOpenChangeEvent } from '@/shared/open-state'\nimport { defineNativeDialogPresence } from '@/shared/overlay/native-dialog-presence'\nimport { defineNestedDrawerLayers } from '@/shared/overlay/nested-drawer-layers'\nimport { defineOpenOverlay, type OpenOverlayHandle } from '@/shared/overlay/open-overlay'\nimport { defineScrollLockLease } from '@/shared/scroll-lock/scroll-lock'\nimport { prefersReducedMotion } from '@/shared/theme/reduced-motion'\n\nimport style from './style.css?inline'\n\nconst ALLOWED_PLACEMENTS = ['right', 'left', 'top', 'bottom'] as const\n\nexport type DrawerPlacement = (typeof ALLOWED_PLACEMENTS)[number]\n\n/*\n * 释放后的拖拽关闭判定：\n *\n * - 基准校准：位移零点与判定时钟都在**首个 pointermove** 处重置（手势层\n *   `calibrateOnFirstMove`，drawer 显式开启），吸收「按下 → 首个 move」之间的空隙——\n *   触摸输入的首个 move 常已相对按下点偏移，不重置会让元素在首个 move 一次性兑现\n *   而跳动。代价是这段位移被丢弃，一次手势至少要累积两个 move 才可能产生位移；\n *   `DragMoveInfo/DragEndInfo` 的 `delta*` 与 `duration` 均以该点为零点与起点。\n * - 距离：**自抓取瞬间起的净位移**超过 drawer 尺寸的一半（下限 10px）。用净位移而不是\n *   绝对位置：从弹回/收尾途中重新抓取时，抓取瞬间停在哪里都不算「已经拖过一半」。\n *   尺寸量不到时（0）由下限兜底，保证退化场景不会因为阈值 0 而「动一下就关」。\n * - 甩动：整段手势的平均速度**达到** 500px/s（含等号）。用「整段手势」而不是释放\n *   瞬间的滑窗速度：滑窗只描述最后一小段轨迹，反向回扫（先往打开方向拖进量程，\n *   再快速扫回）在释放瞬间同样能凑出很高的滑窗速度，但它不是朝关闭方向的甩动。\n *   净速度 = 净位移 / 整段时长（自校准点起算），分母钳到 50ms；时长为 0 时速度取 0，\n *   而不是按 50ms 兜底放大——直接放大会把「测不到时长」变成一次甩动。\n * - 方向：净位移未朝闭合方向（`<= 0`）时一律弹回。\n * - 改主意：拖拽期内追踪「自折返点起」的位移，一旦自方向确认点回撤满 10px 即标记\n *   取消，甩动分支此后拒绝关闭；位移重新越过关闭距离阈值时清除标记，即\n *   「已经拖过一半」不受回撤影响。见 `_trackSwipeCancel`。\n * - 过冲阻尼：闭合方向全额 1:1 跟手，反向按 `dampOverscroll` 平方根压缩。阻尼作用于\n *   **本次手势的增量**，再叠加抓取瞬间的基准位移；对总位移做阻尼会连基准一起压缩，\n *   元素不再接着视觉位置走。\n */\nconst DRAG_CLOSE_RATIO = 0.5\nconst DRAG_MIN_CLOSE_DISTANCE = 10\nconst DRAG_FLICK_VELOCITY = 500\nconst DRAG_MIN_VELOCITY_SPAN_MS = 50\nconst DRAG_REVERSE_CANCEL_THRESHOLD = 10\nconst DRAG_REQUEST_WINDOW_MS = 120\n// backdrop 点击（click 链路）的轻点判定距离：按下起点到 click 坐标的欧氏位移未越过该值\n// 视为轻点，沿用「点 backdrop 关闭」语义（对齐 _dragCloseThreshold 的 10px 下限量级）。\n// 必须用欧氏长度（而非仅主轴分量）：只看主轴会让「主轴不动、垂直大幅滑动」的\n// press–drag–release 链路仍落在窗口内被误读成轻点。\nconst BACKDROP_TAP_DISTANCE = 10\n\n/*\n * header / footer 让开给「可点控件」的选择器（上下 placement 专用）。\n *\n * 上下 placement 的端头整块可拖后，让开靠**逐个控件**在事件层判断，不靠几何切割：\n * 切割要测量每个控件的位置，控件一改位置就失效；逐个控件让开是结构性的。\n *\n * 判据是「这个元素自己就代表一次用户操作」，分三类：\n *   - 原生可交互元素与原生可点容器（button / input / label / a[href] / summary …）\n *   - 显式可编辑（contenteditable）\n *   - 交互语义 role（组件库自绘的 checkbox、tab、menuitem 等没有原生 tag）\n * 另加「作者显式给了可聚焦 tabindex」：自定义控件常只靠 tabindex 暴露可操作性。\n *\n * 方向是**保守让开**：判不出来就让开。让开的代价是那一小块起不了拖（用户多点一下），\n * 判错的代价是控件失效（A6 那条回归），两者不对等。\n */\nconst HEADER_FOOTER_INTERACTIVE_SELECTOR = [\n  'button',\n  'input',\n  'select',\n  'textarea',\n  'label',\n  'summary',\n  'a[href]',\n  'audio[controls]',\n  'video[controls]',\n  '[contenteditable]:not([contenteditable=\"false\"])',\n  '[tabindex]:not([tabindex=\"-1\"])',\n  '[role=\"button\"]',\n  '[role=\"link\"]',\n  '[role=\"checkbox\"]',\n  '[role=\"switch\"]',\n  '[role=\"radio\"]',\n  '[role=\"tab\"]',\n  '[role=\"menuitem\"]',\n  '[role=\"menuitemcheckbox\"]',\n  '[role=\"menuitemradio\"]',\n  '[role=\"option\"]',\n  '[role=\"textbox\"]',\n  '[role=\"combobox\"]',\n  '[role=\"slider\"]',\n  '[role=\"spinbutton\"]'\n].join(',')\n\n/*\n * 释放后的收尾（弹回打开位 / 滑出到闭合位）由 CSS transition 接管（issue #123）：\n * 拖拽期间内联 transform + `transition: none`，松手时把终值与过渡参数写入内联并在\n * 同一次样式重算里解除抑制，回弹即唯一的一次 CSS 过渡。全程无 `element.animate()`、\n * 无 fill、无 JS→CSS 动画交接边界，因此不存在 Safari 采不到 before-change style 的\n * 窗口。\n *\n * 代价是没有弹簧的速度感知轨迹：释放速度只用于估算过渡时长，过冲手感由缓动曲线\n * 近似。两条曲线对应弹簧预设的阻尼比——close（ζ≈1.05）无过冲，\n * rebound（ζ≈0.74）保留约 3% 过冲。\n */\nconst SETTLE_MIN_MS = 180\nconst SETTLE_MAX_MS = 420\nconst SETTLE_EASE_CLOSE = 'cubic-bezier(0.32, 0.72, 0, 1)'\n// 过冲量由 y1 决定：1.3 时峰值 ≈2.99%，与 ζ≈0.74 的理论过冲（3.15%）对齐；1.12 只剩 0.37%。\nconst SETTLE_EASE_REBOUND = 'cubic-bezier(0.22, 1.3, 0.36, 1)'\n// 估算时长的速度下限（px/s）：静止释放时退化为最大时长，避免除零与无限时长。\nconst SETTLE_MIN_VELOCITY = 1\n// transitionend 兜底定时器的宽限：覆盖一帧的调度抖动。\nconst SETTLE_GRACE_MS = 80\n\n/*\n * 拖拽期间由 JS 写入的 backdrop 透明度变量参与 WAAPI 关键帧。未注册的自定义属性在\n * 关键帧之间是离散插值（半帧跳变），注册为 <number> 后获得线性插值。\n * inherits 必须为 true：::backdrop 只从 originating element 继承「可继承属性」，\n * 注册为不可继承会让变量到不了 backdrop，跟手淡出整体失效（Chrome 151 实证）。\n * 注册表是全局的，模块重复执行（HMR）时捕获已注册错误并忽略。\n */\nif (typeof CSS !== 'undefined' && 'registerProperty' in CSS) {\n  try {\n    CSS.registerProperty({\n      name: '--wui-internal-drag-backdrop-opacity',\n      syntax: '<number>',\n      inherits: true,\n      initialValue: '1'\n    })\n  } catch {\n    // 已注册（如 HMR 重复执行）时忽略\n  }\n  /*\n   * 公开 token 注册为 <length>：Consumer 传 unitless 0 时计算值被归一为 0px，\n   * 避免 calc(100% + 0) 因 number/percentage 不兼容而使闭合位移失效。\n   */\n  try {\n    CSS.registerProperty({\n      name: '--wui-drawer-inset',\n      syntax: '<length>',\n      inherits: true,\n      initialValue: '8px'\n    })\n  } catch {\n    // 已注册（如 HMR 重复执行）时忽略\n  }\n  /*\n   * 嵌套层叠对数曲线的基准 A（shift = A · ln(depth + 1)）：注册为 <length> 后\n   * 桌面基准只有这一个真相源，JS 从 computed style 读到的永远是确定值；\n   * 窄视口基准由 style.css 的媒体查询覆盖同一 token。消费方写 unitless 的\n   * `0` 会在计算值阶段归一成 `0px`（层叠露边归零，而不是让 ln 项算出 NaN）。\n   *\n   * A = 43.2px 来自视觉 pass：四层等宽 320px 时逐层露边\n   * 29.94 / 17.52 / 12.43px，总堆叠宽 59.89px。\n   *\n   * 取值由**最里层**那一跳决定：对数曲线压得最狠的正是第四层，它只有\n   * A·ln(4/3) = 0.288A。12.43px 略高于 12px 的线性步进，但余量已经收窄到\n   * 3.5%——继续下调会让最里层那一条边与上一条边难以分辨。若还要更小的基准，\n   * 应先改 ln 的压缩比而不是只降 A。\n   */\n  try {\n    CSS.registerProperty({\n      name: '--wui-drawer-nested-peek-base',\n      syntax: '<length>',\n      inherits: true,\n      initialValue: '43.2px'\n    })\n  } catch {\n    // 已注册（如 HMR 重复执行）时忽略\n  }\n  /*\n   * 收尾过渡的时长：注册为 <time> 后 ::backdrop 也能继承到同一值。不注册时变量在\n   * transition 简写里只是 token 替换，值一旦无效整条声明在计算值阶段失效\n   * （退化为 transition: none），回弹会变成瞬移。\n   * 缓动不注册：CSS 属性语法没有 <easing-function>，且它不需要插值，靠 var() 的\n   * 兜底值即可。\n   */\n  try {\n    CSS.registerProperty({\n      name: '--wui-internal-settle-duration',\n      syntax: '<time>',\n      inherits: true,\n      initialValue: '280ms'\n    })\n  } catch {\n    // 已注册（如 HMR 重复执行）时忽略\n  }\n}\n\n@customElement('web-ui-drawer')\nexport class WebUiDrawer extends LitElement {\n  static override styles = [unsafeCSS(glass), unsafeCSS(modalSurface), unsafeCSS(scrollbarStyle), unsafeCSS(style)]\n\n  @property({ type: Boolean, reflect: true }) open = false\n  @property({ type: Boolean, reflect: true, attribute: 'no-scroll-lock' }) noScrollLock = false\n  @property({ type: Boolean, reflect: true, attribute: 'no-backdrop-close' }) noBackdropClose = false\n\n  /**\n   * Controlled 模式下，Escape、backdrop、关闭 button 和拖拽关闭只派发 `open-change` 请求，\n   * 不会自行修改 `open`。Consumer 回写 `open` 后才执行关闭动画。\n   * 程序化 API（show/close/直接赋值 open）不受此模式影响，始终直通。\n   */\n  @property({ type: Boolean, reflect: true }) controlled = false\n\n  @property({ type: String, reflect: true })\n  get placement(): DrawerPlacement {\n    return this._placement\n  }\n  set placement(v: string) {\n    const old = this._placement\n    this._placement = normalizeLiteral(v, ALLOWED_PLACEMENTS, 'right')\n    this.requestUpdate('placement', old)\n  }\n  private _placement: DrawerPlacement = 'right'\n\n  // 标题文字（未传 header slot 时显示默认 header）\n  @property({ type: String }) heading = ''\n\n  @property({ type: Boolean, reflect: true }) closable = false\n\n  /**\n   * Headless 模式：只保留 overlay 基础设施（backdrop、动画、scroll lock、dialog 语义），\n   * 移除内置 UI（glass 样式、header、close button、footer）。Consumer 自定义内容样式。\n   */\n  @property({ type: Boolean, reflect: true }) headless = false\n\n  /**\n   * 内部原生 dialog 的 accessible name。headless 模式必须由 Consumer 提供，\n   * 因为该模式不会渲染可自动关联的内置 header。\n   */\n  @property({ type: String, attribute: 'aria-dialog-label' }) ariaDialogLabel = ''\n\n  /*\n   * `dialog-label` 自 11.1.0 发布，为已上线消费方保留兼容别名：attribute 仍可写，\n   * 内部转发到 ariaDialogLabel。canonical 名是 aria-dialog-label；两个 attribute 同时\n   * 设置时后处理者生效，文档不推荐这样做。下个 major 移除本别名。\n   */\n  /** @deprecated 用 `aria-dialog-label`。 */\n  @property({ type: String, attribute: 'dialog-label' })\n  get dialogLabel(): string {\n    return this.ariaDialogLabel\n  }\n  set dialogLabel(value: string) {\n    this.ariaDialogLabel = value\n  }\n\n  /** 关闭按钮的无障碍名称；未设置时回退内置英文文案（见 ADR-0016）。 */\n  @property({ type: String, attribute: 'aria-close-label' }) ariaCloseLabel = ''\n\n  /**\n   * 启用拖拽关闭：打开态在 drawer 内缘渲染 drag bar（灰色胶囊 + 加宽 drag zone），\n   * 指针拖拽实时跟手，松手按位移与甩动速度判定关闭或弹回。\n   * 关闭态基于原生 dialog 无可见渲染物，因此不支持从关闭态拖拽打开。\n   */\n  @property({ type: Boolean, reflect: true }) override draggable = false\n\n  private get dialog() {\n    return this.shadowRoot?.querySelector('dialog') ?? null\n  }\n\n  private _hasHeaderSlot = false\n  private _hasFooterSlot = false\n  private readonly _userOpenChange = new UserChangeController()\n  /*\n   * 上下 placement 的拖拽 drag zone 要让开头尾两节（见 style.css 的 --wui-internal-drawer-* 说明）：\n   * `bottom` 贴顶边、drag zone 让开 header，`top` 贴底边、drag zone 让开 footer。让开的量就是那一节的\n   * border-box 高度，写成 host 上的自定义属性交给 CSS 去算偏移——样式侧因此不必知道\n   * header / footer 的存在与高度，两条 placement 规则各只读自己的那个属性。\n   *\n   * 用 offsetHeight 而非 CSS 侧推导：`[hidden]` 的节天然是 0（让位量归零，drag zone 回到 panel 边缘），\n   * 而「header 存在但高度为 0」与「没有 header」在布局上是同一件事，不需要额外的存在性 toggle。\n   * 高度是动态的（consumer 的 padding、窄屏断点改写、slotted 内容换行），所以观察而非读取一次。\n   */\n  private readonly _headerHeight = new ElementHeightController(this, '.wui-drawer-header', height =>\n    this._setAvoidance('--wui-internal-drawer-header-inset', height)\n  )\n  private readonly _footerHeight = new ElementHeightController(this, '.wui-drawer-footer', height =>\n    this._setAvoidance('--wui-internal-drawer-footer-inset', height)\n  )\n\n  /*\n   * 让位量 = 该节高度 + 一点呼吸间距，且**只在真有那一节时**才加间距。\n   *\n   * 间距写成属性值里的 calc 而不是让 CSS 无条件相加，是因为「没有 header」这一态必须精确等于\n   * 让位量 0 的几何（drag zone 顶边贴 panel 顶边）。若让间距无条件生效，无 header 的 drawer 会\n   * 平移 4px，drag zone 端边与 panel 端边的贴合关系跟着变——那是\n   * `header-drag-surface.browser.spec.ts` 的 R2 钉住的关系，这条护栏不该让步。\n   * 间距本身仍以 token 暴露，真机调参不必改代码。\n   */\n  private _setAvoidance(property: string, height: number) {\n    this.style.setProperty(\n      property,\n      height > 0 ? `calc(${height}px + var(--wui-drawer-drag-zone-inset, var(--wui-space-1, 4px)))` : '0px'\n    )\n  }\n  private readonly _scrollLock = defineScrollLockLease().make()\n  private readonly _presence = defineNativeDialogPresence().make({\n    getDialog: () => this.dialog,\n    isConnected: () => this.isConnected,\n    isOpen: () => this.open\n  })\n  // nested 层序：打开后纳入全局栈，上层打开/关闭时本层缩放平移。\n  private readonly _nestedLayers = defineNestedDrawerLayers().make({\n    getDialog: () => this.dialog,\n    getPlacement: () => this._placement\n  })\n  /*\n   * 开启态 overlay（issue #120 Block 1）。drawer 把自己的原生 <dialog> 登记为 panel，使挂在\n   * dialog 上的 portal panel（select / dropdown / tooltip）在逻辑组合树上成为它的后代，\n   * 仲裁者据此选出最内层。\n   *\n   * 拖拽进行中不响应 Escape，但**仍是候选**：仲裁者照旧吞掉按键并压掉原生 cancel，\n   * 只是不走关闭入口。关闭入口只有这一个执行者。\n   */\n  private readonly _overlay = defineOpenOverlay().make({\n    requestClose: () => this._closeFromUser(),\n    isConnected: () => this.isConnected\n  })\n  /** 当前开启会话的 handle；未开启时为 null。 */\n  private _handle: OpenOverlayHandle | null = null\n\n  private _dragGesture: DragGestureHandle | null = null\n  // pointerdown 时刻已存在的闭合方向位移（从弹回动画中抓取时非 0）。\n  private _dragInitialOffset = 0\n  private _dragOffset = 0\n  // 位移零点与判定时钟由手势层的 `calibrateOnFirstMove` 校准到首个 pointermove，\n  // 这里只保留「改主意」相关的追踪状态。\n  // 折返点（轴坐标）：随反向移动拉到当前坐标。\n  private _cancelBaseline = 0\n  // 上一次 move 的轴坐标，用于求移动量。\n  private _lastAxisPos = 0\n  // 方向确认时的位移；负值表示方向尚未确认。\n  private _swipeIntentDisp = -1\n  // 已判定为「改主意」，甩动分支据此拒绝关闭。\n  private _swipeCancelled = false\n  // 释放后的 CSS transition 收尾：完成回调，以及终值与当前值相同时\n  // 不会派发 transitionend 的兜底定时器。\n  private _settleFinish: (() => void) | null = null\n  private _settleTimer: ReturnType<typeof setTimeout> | undefined\n  // controlled：弹簧到闭合位后等待 Consumer 回写 open；超时未回写则弹回。\n  private _dragAwaitWriteback = false\n  private _dragRequestTimer: ReturnType<typeof setTimeout> | undefined\n\n  private get _dragAxis(): 'x' | 'y' {\n    return this._placement === 'left' || this._placement === 'right' ? 'x' : 'y'\n  }\n\n  // 位移正方向 = drawer 的闭合方向（拖出屏幕为正）。\n  private get _dragCloseSign(): number {\n    switch (this._placement) {\n      case 'right':\n        return 1\n      case 'left':\n        return -1\n      case 'top':\n        return -1\n      case 'bottom':\n        return 1\n    }\n  }\n\n  private _measureDragSize(): number {\n    const dialog = this.dialog\n    if (!dialog) return 0\n    return this._dragAxis === 'x' ? dialog.offsetWidth : dialog.offsetHeight\n  }\n\n  // 关闭距离阈值：尺寸的一半，下限 10px。\n  // 胶囊的 accent 视觉确认与实际判定共用同一阈值，两者不会漂移。\n  private _dragCloseThreshold(size: number): number {\n    return Math.max(size * DRAG_CLOSE_RATIO, DRAG_MIN_CLOSE_DISTANCE)\n  }\n\n  // 浮动卡片（非 headless）的四周留边；闭合位移需越过它才能完全滑出视口。\n  // headless 在 :host([headless]) dialog 上显式归零（防嵌套继承），解析失败回退 0。\n  private _readDrawerInset(dialog: HTMLDialogElement): number {\n    const raw = getComputedStyle(dialog).getPropertyValue('--wui-internal-drawer-inset')\n    const parsed = Number.parseFloat(raw)\n    return Number.isFinite(parsed) ? parsed : 0\n  }\n\n  // 闭合方向上的完全出屏距离：drawer 尺寸 + 浮动留边（headless 下即尺寸本身）。\n  // CSS 闭合态 transform、controlled 悬停终态与弹簧终点共用同一数学，避免衔接跳变。\n  private _dragCloseDistance(dialog: HTMLDialogElement): number {\n    return this._measureDragSize() + this._readDrawerInset(dialog)\n  }\n\n  private _isDragging(): boolean {\n    return this._dragGesture?.isDragging() ?? false\n  }\n\n  /*\n   * 拖拽期间本层仍是候选：仲裁者照旧 preventDefault（压掉原生 <dialog> 的 cancel）与\n   * stopPropagation，只是不调用 requestClose。`isDragging()` 的翻转由手势层内部决定，\n   * 所以随 move 与各终结路径同步（幂等）。除拖拽外本层没有别的惰性来源。\n   */\n  private _syncDragInert() {\n    this._handle?.setInert(this._isDragging())\n  }\n\n  private _cancelDragAwait() {\n    if (this._dragRequestTimer !== undefined) {\n      clearTimeout(this._dragRequestTimer)\n      this._dragRequestTimer = undefined\n    }\n    this._dragAwaitWriteback = false\n  }\n\n  /**\n   * 上下 placement 的 header / footer 自己接拖拽手势。\n   *\n   * 为什么不是「把 drag zone 铺到 header 上」：那样 header 里的控件会被透明命中层吞掉，\n   * 正是 A6 修掉的那条缺陷。这里在事件层让开——控件照常收自己的事件，拖拽只在\n   * 「落点不是可点控件」时起手。\n   *\n   * 三道闸门任一不成立就不接管：\n   * 1. placement 必须是上下。左右 placement 的拖拽轴是 x，端头在竖边上，header\n   *    既不在可抓边缘上也不该起手（R4 的行为侧）。\n   * 2. 下层嵌套 drawer 整套拖拽提示一起退场。drag zone 与 drag edge 靠 CSS 的 pointer-events 退场，\n   *    事件层必须自己判同一条，否则 header 会成为唯一一条漏网的入口。\n   * 3. 落点路径里有可点控件就让开——控件优先于「这一块可拖」。\n   */\n  private _handleSectionDragPointerDown(e: PointerEvent) {\n    if (this._placement !== 'top' && this._placement !== 'bottom') return\n    const section = (e.currentTarget as HTMLElement | null)?.closest('.wui-drawer-header, .wui-drawer-footer')\n    const isHeader = section?.classList.contains('wui-drawer-header') ?? false\n    // 只有**贴着可抓边缘**的那一节接手势：bottom 的 header、top 的 footer。\n    // 另一节在 panel 远端，在那里起手却朝闭合方向拖是反直觉的，也不属于「端头」——\n    // 与 drag zone 只让开同一侧那节是同一条边界。\n    if (this._placement === 'bottom' && !isHeader) return\n    if (this._placement === 'top' && isHeader) return\n    // 下层嵌套 drawer 整套拖拽提示一起退场：drag zone 与 drag edge 靠 CSS 的 pointer-events 退场，\n    // 事件层必须判同一条，否则这里是唯一一条漏网的入口。\n    if (this.dialog?.classList.contains('is-nested-lower')) return\n    if (this._isInteractivePath(e)) return\n    this._handleDragPointerDown(e)\n  }\n\n  /**\n   * 按下路径上是否出现可点控件。\n   *\n   * 走 composedPath 而不是 event.target：消费侧 slotted 控件与组件库自绘控件都各有\n   * shadow root，target 只给出最内层那个节点，沿 parentElement 上行会在 shadow 边界\n   * 断掉，控件自己那层反而看不见。\n   */\n  private _isInteractivePath(e: PointerEvent): boolean {\n    const path = typeof e.composedPath === 'function' ? e.composedPath() : [e.target]\n    for (const node of path) {\n      if (node instanceof Element && node.matches(HEADER_FOOTER_INTERACTIVE_SELECTOR)) return true\n    }\n    return false\n  }\n\n  private _handleDragPointerDown(e: PointerEvent) {\n    if (!this.open || !this.draggable || this._isDragging()) return\n    // 多点触控的副指针（isPrimary 明确为 false）不参与手势。\n    if (e.isPrimary === false) return\n\n    const dialog = this.dialog\n    if (!dialog) return\n    // is-visible 由 presence 在 showModal 后一帧加上；就位前（打开极早期）忽略。\n    // 就位后即使 enter 过渡仍在进行也允许抓取，起始位移从当前计算值续接。\n    if (!dialog.classList.contains('is-visible')) return\n\n    // 先读取动画中的当前位移再取消弹回动画，避免取消后回跳到内联样式值。\n    const currentTransform = getComputedStyle(dialog).transform\n    const axisValue =\n      currentTransform && currentTransform !== 'none' && typeof DOMMatrixReadOnly === 'function'\n        ? new DOMMatrixReadOnly(currentTransform)[this._dragAxis === 'x' ? 'm41' : 'm42']\n        : 0\n    // 收尾过渡进行中被重新抓取：丢弃收尾状态（不执行其回调，避免它回头写内联），\n    // 位移已在下面按当前计算值续接。\n    this._abortSettle()\n    this._cancelDragAwait()\n\n    this._dragInitialOffset = axisValue * this._dragCloseSign\n    this._dragOffset = this._dragInitialOffset\n    // 判定基准复位：折返点从按下位置起算。\n    const axisPos = this._dragAxis === 'x' ? e.clientX : e.clientY\n    this._cancelBaseline = axisPos\n    this._lastAxisPos = axisPos\n    this._swipeIntentDisp = -1\n    this._swipeCancelled = false\n    dialog.classList.add('is-dragging')\n    // 收尾过渡进行中重新抓取时内联还停在收尾终值（打开位/闭合位），不写回当前位移\n    // 会在抑制生效的瞬间跳到终值。写回后计算值 == 抓取瞬间的视觉位置，无跳变。\n    this._applyDragOffset(dialog, this._dragOffset)\n\n    this._dragGesture = attachDragGesture(e, {\n      axis: this._dragAxis,\n      // 拖拽零点与判定时钟一起重置到首个 move。\n      calibrateOnFirstMove: true,\n      onMove: info => {\n        // info 的 delta/duration 已以校准点为零点。\n        const pointerDelta = this._dragAxis === 'x' ? info.deltaX : info.deltaY\n        // 本次手势自校准点起的**增量**（朝闭合方向为正，未阻尼）。\n        const dragDelta = pointerDelta * this._dragCloseSign\n        // 阻尼只作用于增量，再叠加抓取瞬间的基准位移。对总位移做阻尼会在「从弹回中\n        // 重新抓取」时差出可见位移——基准位移本身会被一起压缩，元素不再接着视觉位置走。\n        this._dragOffset = this._dragInitialOffset + dampOverscroll(dragDelta)\n        this._trackSwipeCancel(this._dragAxis === 'x' ? info.clientX : info.clientY, dragDelta)\n\n        // 达到关闭阈值时胶囊换成更实的中性灰作视觉确认。与距离分支共用同一量\n        //（自抓取瞬间起的净位移）与同一阈值，视觉确认与实际判定不会漂移。\n        const dragSize = this._measureDragSize()\n        const dragDisplacement = this._dragOffset - this._dragInitialOffset\n        dialog.classList.toggle('is-drag-close', dragDisplacement > this._dragCloseThreshold(dragSize))\n        this._applyDragOffset(dialog, this._dragOffset)\n      },\n      onEnd: info => {\n        this._dragGesture = null\n        this._syncDragInert()\n        dialog.classList.remove('is-dragging', 'is-drag-close')\n        const size = this._measureDragSize()\n        const velocity = (this._dragAxis === 'x' ? info.velocityX : info.velocityY) * this._dragCloseSign\n        // 净位移从抓取瞬间的位移起算（弹回/收尾过渡中被重新抓取时起点非 0）。\n        const displacement = this._dragOffset - this._dragInitialOffset\n        // 时长同样自校准点（首个 move）起算，与位移零点同源：按下后的停顿不参与分母。\n        // 分母下限 50ms；时长量为 0（首尾时间戳相同，或事件时间戳不可用/倒退）时速度取\n        // 0——直接按 50ms 兜底会把「测不到时长」放大成一次甩动。\n        const netVelocity =\n          info.duration > 0 ? (displacement / Math.max(info.duration, DRAG_MIN_VELOCITY_SPAN_MS)) * 1000 : 0\n        // 甩动判据：净位移朝闭合方向（`> 0`）、平均速度达到阈值（`>=`）、\n        // 且本次手势未被判定为「改主意」。\n        const flicked = displacement > 0 && netVelocity >= DRAG_FLICK_VELOCITY && !this._swipeCancelled\n        // 距离分支同样用净位移，不是绝对位置：抓取瞬间停在哪里都不算「已经拖过一半」。\n        // `_dragOffset` 只留给收尾的起点使用。\n        const shouldClose = displacement > this._dragCloseThreshold(size) || flicked\n\n        if (shouldClose) this._settleToClose(dialog, velocity)\n        else this._settleRebound(dialog, velocity, this._dragOffset)\n      },\n      onCancel: () => {\n        this._dragGesture = null\n        this._syncDragInert()\n        dialog.classList.remove('is-dragging', 'is-drag-close')\n        this._settleRebound(dialog, 0, this._dragOffset)\n      }\n    })\n    /*\n     * 惰性必须与 attach 同拍。漏掉这里，按下到手势终结之间那一整段里 Escape 仍会关闭\n     * drawer——push 通道没有自动同步，每个翻转点自己推一次。\n     *\n     * `isDragging()` 的翻转点不止 attach 与 onEnd：手势层的 `handlePointerMove` 在越过死区后\n     * 若判定轴向冲突（限定了 x 轴却明显纵向移动，或反之）会直接 `cancel()`，\n     * `lostpointercapture` 也会终结手势。这些路径都走 `onCancel`，所以 `onCancel` 里那次\n     * `_syncDragInert()` **不是**冗余——删掉它，「移动中取消拖拽」会让 drawer 重新变回可被\n     * Escape 关闭。\n     */\n    this._syncDragInert()\n  }\n\n  /*\n   * 「改主意」守卫。\n   *\n   * 折返点随「反向移动」被拉到当前坐标，因此「自折返点起的位移」度量的是**自最近一次\n   * 折返之后**回撤了多少：一旦它比方向确认时的位移少满 10px，本次手势即被标记为\n   * 「改主意」，甩动分支据此拒绝关闭；位移重新越过关闭距离阈值即清除标记，\n   * 即「已经拖过一半」不受回撤影响。\n   *\n   * @param axisPos 本次 move 在主轴上（`_dragAxis`）的指针坐标\n   * @param displacement 自校准点起、朝闭合方向的**未阻尼**位移\n   */\n  private _trackSwipeCancel(axisPos: number, displacement: number) {\n    const movement = axisPos - this._lastAxisPos\n    this._lastAxisPos = axisPos\n    if ((movement < 0 && axisPos > this._cancelBaseline) || (movement > 0 && axisPos < this._cancelBaseline)) {\n      this._cancelBaseline = axisPos\n    }\n\n    if (this._swipeIntentDisp < 0) {\n      // 方向确认：首次朝闭合方向累积出位移。\n      if (displacement > 0) this._swipeIntentDisp = displacement\n      return\n    }\n\n    const cancelDisplacement = (axisPos - this._cancelBaseline) * this._dragCloseSign\n    if (cancelDisplacement > this._dragCloseThreshold(this._measureDragSize())) {\n      this._swipeCancelled = false\n    } else if (this._swipeIntentDisp - cancelDisplacement >= DRAG_REVERSE_CANCEL_THRESHOLD) {\n      this._swipeCancelled = true\n    }\n  }\n\n  // 受控状态写入等外部原因强制终结拖拽：清手势状态与拖拽样式，不弹回，\n  // 后续管线（关闭/打开）由调用方继续执行。\n  private _cancelActiveDrag() {\n    if (!this._isDragging()) return\n    this._dragGesture?.destroy()\n    this._dragGesture = null\n    this._syncDragInert()\n    const dialog = this.dialog\n    if (!dialog) return\n    dialog.classList.remove('is-dragging', 'is-drag-close')\n    this._clearDragStyles(dialog)\n  }\n\n  // 将闭合方向位移映射为 dialog transform，并同步 backdrop 透明度保持跟手反馈。\n  private _applyDragOffset(dialog: HTMLDialogElement, offset: number) {\n    const sign = this._dragCloseSign\n    const value = offset * sign\n    dialog.style.transform = this._dragAxis === 'x' ? `translateX(${value}px)` : `translateY(${value}px)`\n    const size = this._measureDragSize()\n    const progress = size > 0 ? Math.min(1, Math.max(0, offset / size)) : 0\n    dialog.style.setProperty('--wui-internal-drag-backdrop-opacity', String(1 - progress))\n  }\n\n  private _clearDragStyles(dialog: HTMLDialogElement) {\n    dialog.style.removeProperty('transform')\n    dialog.style.removeProperty('--wui-internal-drag-backdrop-opacity')\n  }\n\n  // 由 CSS transition 收尾到完全闭合；controlled 下保持闭合位等待回写，其余走常规关闭管线。\n  private _settleToClose(dialog: HTMLDialogElement, velocity: number) {\n    const from = this._dragOffset\n    this._dragOffset = 0\n    // 终点 = 完全出屏距离（含浮动留边），与 CSS 闭合态/悬停终态一致，\n    // 否则收尾结束后会有一个留边宽度的瞬移。\n    const to = this._dragCloseDistance(dialog)\n\n    const finishClose = () => {\n      if (this.controlled) {\n        // 保持在闭合位（is-visible 未移除，状态仍 open），等待 Consumer 回写或超时弹回。\n        this._applyDragOffset(dialog, to)\n      } else {\n        // 移除 is-visible 后基础 transform 即闭合位，清内联样式不产生跳变；\n        // presence.sync(false) 检测不到 is-visible 会立即完成关闭，不重播退出动画。\n        dialog.classList.remove('is-visible')\n        this._clearDragStyles(dialog)\n      }\n      this._closeFromDrag()\n    }\n\n    if (prefersReducedMotion(this) || Math.abs(to - from) < 1) {\n      // 与 _settleRebound 的无动画路径对称：自己解除抑制，不依赖调用方清过类。\n      dialog.classList.remove('is-dragging')\n      finishClose()\n      return\n    }\n\n    this._startSettle(\n      dialog,\n      to,\n      0,\n      this._settleDuration(Math.abs(to - from), velocity),\n      SETTLE_EASE_CLOSE,\n      finishClose\n    )\n  }\n\n  // 弹回打开位：从 from 位移回到 0；结束后把内联样式交还 CSS 打开态。\n  private _settleRebound(dialog: HTMLDialogElement, velocity: number, from: number) {\n    this._dragOffset = 0\n\n    // 收尾结束必须清掉内联 transform：translateX(0px) 内联会盖住闭合态 CSS transform，\n    // 之后用 button/backdrop/Esc 关闭时计算值恒为 0、开与关都不再触发过渡。\n    const finishRebound = () => {\n      this._clearDragStyles(dialog)\n    }\n\n    if (prefersReducedMotion(this) || Math.abs(from) < 1) {\n      // 无动画路径：直接移除内联回到 CSS 打开位。计算值就是可信的打开位 0，\n      // 不存在 WAAPI fill 覆盖，无需强制 reflow「烘焙」。\n      dialog.classList.remove('is-dragging')\n      finishRebound()\n      return\n    }\n\n    this._startSettle(dialog, 0, 1, this._settleDuration(Math.abs(from), velocity), SETTLE_EASE_REBOUND, finishRebound)\n  }\n\n  // 释放速度只影响收尾时长：以它走完剩余距离的时间作为估计，慢放长、甩动短。\n  private _settleDuration(distance: number, velocity: number): number {\n    const ms = (distance / Math.max(Math.abs(velocity), SETTLE_MIN_VELOCITY)) * 1000\n    return Math.min(SETTLE_MAX_MS, Math.max(SETTLE_MIN_MS, ms))\n  }\n\n  /*\n   * 把释放后的收尾交给 CSS transition：写入终值与「时长/缓动」两个内部变量，并在\n   * 同一次样式重算里解除抑制（is-dragging → is-settling）。过渡的 before-change\n   * style 就是拖拽期间写入的内联值——没有 WAAPI 覆盖层，各引擎采样一致，这正是\n   * 对 Safari「不采信 fill 覆盖」怪癖免疫的原因。\n   */\n  private _startSettle(\n    dialog: HTMLDialogElement,\n    offset: number,\n    backdropOpacity: number,\n    duration: number,\n    easing: string,\n    onDone: () => void\n  ) {\n    // 覆盖前先丢弃上一次收尾：否则它的兜底定时器会提前结束这一次的过渡。\n    this._abortSettle()\n    const sign = this._dragCloseSign\n    dialog.style.setProperty('--wui-internal-settle-duration', `${duration}ms`)\n    dialog.style.setProperty('--wui-internal-settle-easing', easing)\n    dialog.style.transform =\n      this._dragAxis === 'x' ? `translateX(${offset * sign}px)` : `translateY(${offset * sign}px)`\n    dialog.style.setProperty('--wui-internal-drag-backdrop-opacity', String(backdropOpacity))\n    dialog.classList.add('is-settling')\n    dialog.classList.remove('is-dragging')\n\n    this._settleFinish = onDone\n    // 终值与当前值相同时不会派发 transitionend（也没有可见变化），用定时器兜底。\n    this._settleTimer = setTimeout(() => this._finishSettle(), duration + SETTLE_GRACE_MS)\n  }\n\n  // 收尾过渡结束（transitionend 或兜底超时）：先撤 settle 状态再执行收尾。\n  private _finishSettle() {\n    const finish = this._settleFinish\n    if (!finish) return\n    this._abortSettle()\n    finish()\n  }\n\n  // 丢弃进行中的收尾（重新抓取、强制关闭、断连）：只撤状态，不执行收尾回调。\n  private _abortSettle() {\n    this._settleFinish = null\n    if (this._settleTimer !== undefined) {\n      clearTimeout(this._settleTimer)\n      this._settleTimer = undefined\n    }\n    const dialog = this.dialog\n    if (!dialog) return\n    dialog.classList.remove('is-settling')\n    dialog.style.removeProperty('--wui-internal-settle-duration')\n    dialog.style.removeProperty('--wui-internal-settle-easing')\n  }\n\n  private _closeFromDrag() {\n    // 先派发关闭请求（_closeFromUser），再进入悬停等待：等待态中 _closeFromUser\n    // 会被 L2 去重守卫短路，顺序颠倒会吞掉首次请求。\n    this._closeFromUser()\n    if (this.controlled) {\n      this._dragAwaitWriteback = true\n      this._dragRequestTimer = setTimeout(this._handleDragWritebackTimeout, DRAG_REQUEST_WINDOW_MS)\n    }\n  }\n\n  // controlled 回写窗口超时：Consumer 拒绝关闭，从闭合位弹回打开位。\n  private readonly _handleDragWritebackTimeout = () => {\n    this._dragRequestTimer = undefined\n    if (!this._dragAwaitWriteback || !this.open || this._isDragging()) {\n      this._dragAwaitWriteback = false\n      return\n    }\n    this._dragAwaitWriteback = false\n\n    const dialog = this.dialog\n    if (!dialog) return\n    dialog.classList.add('is-visible')\n    // 悬停终态位于完全出屏位（含留边），弹回也从该真实位置起步，避免首帧内跳。\n    this._settleRebound(dialog, 0, this._dragCloseDistance(dialog))\n  }\n\n  override connectedCallback() {\n    super.connectedCallback()\n    this._resyncSlotPresence()\n    // 重挂载对账：断连时 presence、滚动锁、nested 层序与登记都已被撤销，而\n    // `open` 未变化时 `updated()` 不会补跑任何 sync 分支。首次连接时 shadow 尚未\n    // 渲染、`this.dialog` 为 null，三种情况都直接跳过；打开态的首次进入仍由\n    // updated() 的 `props.has('open')` 分支处理。\n    this._presence.reconcile()\n    if (this.open) {\n      // presence.reconcile 已让打开态的 dialog 同步回到 top layer（此刻 dialog.open\n      // 为真），层序 depth 可正确计数，与 updated() 的 register 时机一致。\n      this._nestedLayers.register()\n    }\n    this._syncScrollLock()\n    this._reclaimIfOpen()\n  }\n\n  override firstUpdated() {\n    this._checkSlotContent('footer')\n  }\n\n  override disconnectedCallback() {\n    super.disconnectedCallback()\n    this._nestedLayers.dispose()\n    this._dragGesture?.destroy()\n    this._dragGesture = null\n    this._presence.dispose()\n    this._scrollLock.release()\n    // 断连即撤销登记，重连后由 _reclaimIfOpen 显式重新声明。\n    this._handle?.release()\n    this._handle = null\n    this._abortSettle()\n    this._cancelDragAwait()\n  }\n\n  /** 「重挂载恢复」的调用方一半：模块刻意不观察 DOM 连接状态。 */\n  private _reclaimIfOpen() {\n    if (!this.open || this._handle) return\n    const dialog = this.dialog\n    if (!dialog) return\n    this._handle = this._overlay.claim(dialog, { ancestryFrom: this })\n    this._syncDragInert()\n  }\n\n  /**\n   * 对账 header / footer slot 的有无，**只在真的变了时排一次更新**。\n   *\n   * 排更新是这条对账不可省的一半：`showHeader` 与 footer 的 `?hidden` 只在 render 里求值，\n   * 而 Lit 的 `connectedCallback` 只做 `enableUpdating(true)` 与 `setConnected(true)`，本身不排\n   * 更新。两条 slotchange 处理器也接不住这条路径——slotchange 只在**分配集合**变化时派发，\n   * 断连期间清空槽位内容时宿主节点本身没动，事件不触发（Chromium 实测）。\n   *\n   * 漏掉这一半的后果：断连前有 footer、重连时已清空的 drawer 留下一节空的 footer。它在 style.css\n   * 的 padding 下仍有真实高度（实测 32px），于是底部一条点不动的死带，拖拽 drag zone 的让位量也照\n   * 它算而不归零。\n   *\n   * 判据取 light DOM 子节点而非 `slot.assignedNodes()`：首次连接时 shadow 尚未渲染，slot 元素\n   * 还不存在，那一侧会直接跳过（首次连接的 presence 由 `firstUpdated()` 与 slotchange 兜底）；\n   * 这里要的正是重连对账——shadow root 跨断连保留，两侧都可用，但只有子节点扫描不依赖渲染\n   * 时序。「只在真变了才排」与两条 slotchange 处理器同一纪律，避免每次重连都多一次空渲染。\n   */\n  private _resyncSlotPresence() {\n    const hasHeader = this._hasSlottedChild('header')\n    const hasFooter = this._hasSlottedChild('footer')\n    if (hasHeader === this._hasHeaderSlot && hasFooter === this._hasFooterSlot) return\n    this._hasHeaderSlot = hasHeader\n    this._hasFooterSlot = hasFooter\n    this.requestUpdate()\n  }\n\n  private _hasSlottedChild(name: 'header' | 'footer') {\n    return Array.from(this.children).some(child => child.getAttribute('slot') === name)\n  }\n\n  private _checkSlotContent(name: string) {\n    const slot = this.shadowRoot?.querySelector(`slot[name=\"${name}\"]`) as HTMLSlotElement | null\n    if (!slot) return\n    const has = slot.assignedNodes().length > 0\n    if (name === 'footer' && has !== this._hasFooterSlot) {\n      this._hasFooterSlot = has\n      this.requestUpdate()\n    }\n  }\n\n  private handleHeaderSlotChange(e: Event) {\n    const has = (e.target as HTMLSlotElement).assignedNodes().length > 0\n    if (has !== this._hasHeaderSlot) {\n      this._hasHeaderSlot = has\n      this.requestUpdate()\n    }\n  }\n\n  private handleFooterSlotChange(e: Event) {\n    const has = (e.target as HTMLSlotElement).assignedNodes().length > 0\n    if (has !== this._hasFooterSlot) {\n      this._hasFooterSlot = has\n      this.requestUpdate()\n    }\n  }\n\n  protected override updated(props: PropertyValues) {\n    super.updated(props)\n    if (!this.isConnected) return\n\n    if (props.has('open')) {\n      // Consumer 在拖拽进行中写入受控 open：受控状态优先，立即终结手势（等同\n      // pointercancel 的清理但不弹回），交由下方 presence 走标准关闭/打开管线。\n      if (this._isDragging() && !this.open) this._cancelActiveDrag()\n      if (this._userOpenChange.consume()) this.emitOpenChange()\n      // controlled 拖拽关闭的回写结果：确认关闭则清除闭合位悬停状态走正常关闭；\n      // 拒绝关闭（回写 open=true）则从闭合位（含留边）弹回。\n      if (this._dragAwaitWriteback) {\n        this._cancelDragAwait()\n        const dialog = this.dialog\n        if (dialog && !this.open) {\n          dialog.classList.remove('is-visible')\n          this._clearDragStyles(dialog)\n        } else if (dialog && this.open) {\n          this._settleRebound(dialog, 0, this._dragCloseDistance(dialog))\n        }\n      }\n      // 关闭且无进行中的拖拽/收尾时，清理可能残留的内联拖拽样式（如收尾路径写在\n      // 打开位的 translateX(0px)）。若不清理，0px 内联会盖住闭合态 CSS transform，\n      // 后续开/关都不再触发过渡。收尾进行中由 _finishSettle 自行收尾，这里丢弃它\n      // 以免回调回头写内联与关闭管线竞争。\n      if (!this.open && !this._isDragging()) {\n        this._abortSettle()\n        const dialog = this.dialog\n        if (dialog) this._clearDragStyles(dialog)\n      }\n      this._presence.sync(this.open)\n      if (this.open) {\n        // presence.sync 内的 showModal() 把 dialog 提升进 top layer。双击手势本身\n        // 留下的活选区会被浏览器拿去和提升后的新布局重新解析，结果选区落到刚挂载的\n        // drawer 正文上。脆弱的是「手势来源的活选区」，不是 dblclick 的判定窗口：把\n        // 打开推迟 250ms（早过双击判定）仍然复现。选区由浏览器在 showModal() 调用\n        // 内部生成：脚本没有任何 Selection API 调用，在 dblclick 上 preventDefault\n        // 也拦不住。\n        //\n        // 实测（Chromium）showModal() 不会动打开前已经存在的选区，所以这一次清理\n        // 同时也覆盖「先选中页面文本、再打开」的情况——modal 打开后被选中的内容挡在\n        // backdrop 后面本来也已不可用。这里只清文档选区，不动 user-select，drawer 内正文\n        // 仍可正常拖选；拖拽 handle 与 toggle 时序不受影响。\n        window.getSelection()?.removeAllRanges()\n        // presence.sync 已同步发起 showModal：此刻 dialog.open 为真，计数出正确\n        // 的层序 depth 并驱动下层缩放。直接同步 register，不等待 is-visible\n        //（那要再等一帧，且打开过渡期间上层关系已应确立）。\n        this._nestedLayers.register()\n        // 原生 dialog 登记为开启态 overlay：挂在它上面的 portal panel 在逻辑组合树上\n        // 成为本层后代，Escape 仲裁据此判出最内层（issue #120 Block 1）。\n        const dialog = this.dialog\n        if (dialog) {\n          // 同一 panel 重新 claim = 新的一次开启：旧会话（含其子层）整体作废。\n          this._handle?.release()\n          this._handle = this._overlay.claim(dialog, { ancestryFrom: this })\n          this._syncDragInert()\n        }\n      } else {\n        this._nestedLayers.unregister()\n        this._handle?.release()\n        this._handle = null\n      }\n    }\n    if (props.has('open') || props.has('noScrollLock')) this._syncScrollLock()\n  }\n\n  private handleTransitionEnd(e: TransitionEvent) {\n    // transitionend 会从后代元素冒泡上来（slotted 消费者内容、嵌套子 drawer）。\n    // 只处理 dialog 自身的事件：presence 与收尾都只认本层 dialog 的过渡，\n    // 后代一条 transform 过渡结束不能提前终结本层收尾（与 presence 内部守卫同规则）。\n    if (e.target !== e.currentTarget) return\n    this._presence.handleTransitionEnd(e)\n\n    // 收尾过渡结束：::backdrop 的 opacity 过渡 target 也是 dialog（带 pseudoElement），\n    // 因此再按 propertyName 只认 transform。\n    if (e.propertyName === 'transform') this._finishSettle()\n  }\n\n  private _isNestedDialogEvent(e: KeyboardEvent): boolean {\n    const path = e.composedPath()\n    const ownDialogIndex = path.indexOf(e.currentTarget as Node)\n    return ownDialogIndex > 0 && path.slice(0, ownDialogIndex).some(node => node instanceof HTMLDialogElement)\n  }\n\n  private handleKeydown(e: KeyboardEvent) {\n    if (e.key === 'Tab') {\n      if (e.defaultPrevented || this._isNestedDialogEvent(e)) return\n      const dialog = this.dialog\n      if (dialog) trapTabKey(e, dialog)\n      return\n    }\n    if (e.key !== 'Escape') return\n    /*\n     * Escape 的归属由共享仲裁者在 document 捕获阶段判定（issue #120 Block 1）；命中后\n     * 它会 stopPropagation，本 handler 不再执行。此处保留两条兜底：\n     * ① defaultPrevented 说明仲裁者已介入，不再重复关闭；\n     * ② 兜底路径仍按原逻辑处理，避免「panel 未登记」时 Escape 失灵。\n     *\n     * 本 handler **不是**可随手删掉的：仲裁者挂在 document 上，只对能跨 shadow\n     * 边界的事件生效。实测（overlay-open-owner-260918，2026-09-18）摘掉 `@keydown` 后\n     * layout.browser.spec.ts 的两例 Escape 用例立刻转红——它们派发的 keydown 没有\n     * `composed: true`，事件止步于 shadow root，到不了 document。\n     */\n    if (e.defaultPrevented) return\n    /*\n     * nested 场景防连锁：子 drawer 的 dialog 经 slot 投影在本层 shadow 内，其\n     * keydown composed 冒泡路径会再次经过本层 dialog（事件路径含 slot 宿主链）。\n     * 若事件传播路径在本层 dialog 之前已存在其他 <dialog>，说明该事件来自子层，本层忽略。\n     */\n    if (this._isNestedDialogEvent(e)) return\n    // 拖拽进行中忽略 ESC，避免手势与关闭管线竞争。\n    if (this._isDragging()) {\n      e.preventDefault()\n      return\n    }\n    e.preventDefault()\n    this._closeFromUser()\n  }\n\n  show() {\n    if (this.open) return\n    this.open = true\n  }\n\n  close() {\n    if (!this.open) return\n    this.open = false\n  }\n\n  private readonly _closeFromUser = () => {\n    if (!this.open) return\n    // controlled 悬停等待回写期间，关闭意图已在途（open-change 已派发）：\n    // Escape/backdrop/关闭 button 的重复触发不再派发第二次请求，也不与超时弹回竞争。\n    if (this._dragAwaitWriteback) return\n    if (this.controlled) {\n      this.emitOpenChange(false)\n      return\n    }\n\n    this._userOpenChange.mark()\n    this.close()\n  }\n\n  /*\n   * 仲裁者在 capture 阶段 preventDefault 了 Escape 的 keydown，UA 因此不再派发原生\n   * cancel，但本 handler 仍是「原生 cancel 到达时也要走完整关闭管线」的契约入口，\n   * **不可删**。实测（overlay-open-owner-260918，2026-09-18）摘掉 `@cancel` 后\n   * drawer.spec.ts 的「no-backdrop-close 存在时 cancel 仍通过关闭过渡退出」与\n   * remount-reconcile 的「打开态被移出文档再接回」两例立刻转红。\n   */\n  private handleCancel(e: Event) {\n    // 保留 top layer 直到 CSS 过渡结束，避免原生关闭跳过退出动画。\n    e.preventDefault()\n    this._closeFromUser()\n  }\n\n  private handleNativeClose() {\n    // 关闭态下的 close 事件只可能是我们自己 finishClosing 排队的异步事件（或冗余的\n    // 外部关闭）：交给 presence 消费 self-close 标志，避免标志泄漏到下一次真实关闭。\n    if (!this.open) {\n      this._presence.handleNativeClose()\n      return\n    }\n\n    // 我们自己 dialog.close() 排队的 close 事件是异步任务：正常时序在本关闭会话内\n    // 到达，快速「关闭→重开」时它在重新打开之后才到达（过期事件）。两种情况都已在\n    // finishClosing 完成全部清理，由 presence 消费并返回 true，不能当成外部关闭把\n    // 刚重开的 dialog 关掉——否则重开即被误关，表现为连续 toggle 丢失过渡动画。\n    if (this._presence.handleNativeClose()) return\n\n    // 悬停等待期间的原生关闭（如表单 method=\"dialog\"）：视为回写窗口内的重复\n    // 关闭意图，取消等待不补发请求；已原生关闭的 dialog 不再被超时弹回拉起。\n    if (this._dragAwaitWriteback) {\n      this._cancelDragAwait()\n      return\n    }\n\n    // 原生关闭可绕过 cancel；controlled 时恢复受控状态，由 Consumer 决定是否关闭。\n    if (this.controlled) {\n      this._presence.sync(true)\n      this.emitOpenChange(false)\n      return\n    }\n\n    this._userOpenChange.mark()\n    this.open = false\n  }\n\n  /*\n   * backdrop 点击（backdrop click）的按-放链路回溯。\n   *\n   * 浏览器对「按下 → 拖动 → 松手」生成的 click 落在起点与松手点 DOM 的**共同祖先**\n   * 上：从 panel 内容、拖拽 drag zone 甚至 backdrop 本处开始拖拽、松手落在 backdrop 上时，click 的\n   * target 都是 dialog，与真正的轻点 backdrop 从 click 自身无法区分（真实鼠标/触摸下\n   * 必现的误关路径，合成事件不派发 click 故自动化易漏测）。因此在 dialog 的\n   * pointerdown 记录按下起点与是否落在 backdrop 上，click 时回溯校验：\n   * - 按下起点不在 backdrop 上（从 panel 内容/drag zone 开始的链路）→ 不是点 backdrop，忽略；\n   * - 按下到松手位移超过轻点量级 → 是拖拽松手而非点击，忽略；\n   * 两者都通过才沿用「点 backdrop 关闭」语义。\n   */\n  private _backdropPress: { onMask: boolean; x: number; y: number } | null = null\n\n  private handleDialogPointerDown(e: PointerEvent) {\n    this._backdropPress = { onMask: e.target === e.currentTarget, x: e.clientX, y: e.clientY }\n  }\n\n  private handleBackdropClick(e: MouseEvent) {\n    if (e.target !== (e.currentTarget as HTMLDialogElement)) return\n    if (this.noBackdropClose) return\n    // 拖拽进行中 pointer capture 使 click 落在 dialog 上，忽略以避免与手势竞争。\n    if (this._isDragging()) return\n    // detail 为 0 表示这次 click 不来自指针（键盘激活、程序化 .click()）：\n    // pointerdown 记录可能是上一次指针交互的残留，不能据此判定 backdrop 点击\n    //（对齐 image-preview 的既有守卫）。\n    if (e.detail === 0) return\n    const press = this._backdropPress\n    this._backdropPress = null\n    if (!press || !press.onMask) return\n    if (Math.hypot(e.clientX - press.x, e.clientY - press.y) > BACKDROP_TAP_DISTANCE) return\n    this._closeFromUser()\n  }\n\n  private emitOpenChange(open = this.open) {\n    dispatchOpenChangeEvent(this, open)\n  }\n\n  private _syncScrollLock(isOpen = this.open) {\n    this._scrollLock.sync(isOpen && !this.noScrollLock)\n  }\n\n  override render() {\n    const showHeader = this._hasHeaderSlot || !!this.heading\n    const dialogLabel = this.ariaDialogLabel.trim()\n    const dialogLabelledBy = !dialogLabel && !this.headless && showHeader ? 'wui-drawer-heading' : nothing\n\n    // 拖拽 drag zone：仅在打开且 draggable 时渲染；胶囊 + 加宽命中条贴在 drawer 内缘。\n    // 胶囊是 drag zone 的**兄弟节点**而非后代：drag zone 要让开 header / footer（见 style.css），\n    // 胶囊作为后代会连带继承那份让位量，被一起推离 panel 边缘。两者都是 dialog 的直接子节点，\n    // 胶囊因此相对 dialog 定位、恒贴可抓取边缘，drag zone 则继续为端头上的 button 让位。\n    //\n    // 端头 drag edge 补上解耦留下的空档：胶囊贴回边缘后就不再落在 drag zone 的让开区里\n    // （bottom + header 实测胶囊带 [8,12]、drag zone 带 [60,80]），那一段若没有命中层，\n    // 胶囊就成了一条按不下去、悬停不亮的死装饰——R1 与 R3 在几何上本就不可同满足，\n    // 结构解耦只让两者不再互相位移，命中层必须另给。drag edge 只在上下 placement 渲染：\n    // 左右两条的胶囊本就落在 drag zone 内，多一个元素只会让 R5「左右几何不变」需要额外论证。\n    //\n    // 顺序要紧：胶囊排最后，两条 drag zone（边、区）都在它前面，hover / active / 确认态三条规则\n    // 因此靠通用兄弟选择器 `~` 挂上去。写成相邻兄弟 `+` 的话 drag edge 那条会静默失效。\n    const needsEdgeBand = this.placement === 'top' || this.placement === 'bottom'\n    const dragBar = this.draggable\n      ? html`\n          ${\n            needsEdgeBand\n              ? html`<div class=\"wui-drawer-drag-edge\" @pointerdown=${this._handleDragPointerDown}></div>`\n              : nothing\n          }\n          <div class=\"wui-drawer-drag-zone\" @pointerdown=${this._handleDragPointerDown}></div>\n          <div class=\"wui-drawer-drag-bar\"></div>\n        `\n      : nothing\n\n    // 保持同一个 dialog 实例，避免打开期间切换 headless 时脱离 top layer。\n    return html`\n      <dialog\n        aria-label=${dialogLabel || nothing}\n        aria-labelledby=${dialogLabelledBy}\n        @cancel=${this.handleCancel}\n        @close=${this.handleNativeClose}\n        @click=${this.handleBackdropClick}\n        @pointerdown=${this.handleDialogPointerDown}\n        @keydown=${this.handleKeydown}\n        @transitionend=${this.handleTransitionEnd}\n      >\n        ${\n          this.headless\n            ? html`<slot></slot>${dragBar}`\n            : html`\n                <div class=\"wui-drawer-body wui-glass\">\n                  <div\n                    class=\"wui-drawer-header\"\n                    id=\"wui-drawer-heading\"\n                    ?hidden=${!showHeader}\n                    @pointerdown=${this._handleSectionDragPointerDown}\n                  >\n                    <slot name=\"header\" @slotchange=${this.handleHeaderSlotChange}>\n                      ${this.heading ? html`<span class=\"wui-drawer-heading\">${this.heading}</span>` : nothing}\n                    </slot>\n                  </div>\n                  <div class=\"wui-drawer-content wui-scroll\">\n                    <slot></slot>\n                  </div>\n                  <div\n                    class=\"wui-drawer-footer\"\n                    ?hidden=${!this._hasFooterSlot}\n                    @pointerdown=${this._handleSectionDragPointerDown}\n                  >\n                    <slot name=\"footer\" @slotchange=${this.handleFooterSlotChange}></slot>\n                  </div>\n                </div>\n                ${\n                  this.closable\n                    ? html`\n                        <web-ui-button\n                          class=\"wui-drawer-close\"\n                          @click=${this._closeFromUser}\n                          aria-label=${resolveBuiltinLabel('close', this.ariaCloseLabel)}\n                          variant=\"secondary\"\n                          icon\n                          size=\"26\"\n                        >\n                          <web-ui-icon size=\"14\" .icon=${oouiClose}></web-ui-icon>\n                        </web-ui-button>\n                      `\n                    : nothing\n                }\n                ${dragBar}\n              `\n        }\n      </dialog>\n    `\n  }\n\n  declare readonly $events: {\n    'open-change': CustomEvent<{ open: boolean }>\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'web-ui-drawer': WebUiDrawer\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["glass","modalSurface","scrollbarStyle","style","oouiClose"],"sources":["../../../src/components/drawer/index.ts"],"sourcesContent":["import '@/components/button'\nimport '@/components/icon'\n\nimport { html, LitElement, nothing, type PropertyValues, unsafeCSS } from 'lit'\nimport { customElement, property } from 'lit/decorators.js'\n\nimport modalSurface from '@/assets/modal-surface.css?inline'\nimport scrollbarStyle from '@/assets/scrollbar.css?inline'\nimport glass from '@/classes/glass.css?inline'\nimport { oouiClose } from '@/icons'\nimport { ElementHeightController } from '@/shared/element-height'\nimport { UserChangeController } from '@/shared/events/user-change'\nimport { trapTabKey } from '@/shared/focus/tabbable'\nimport { attachDragGesture, dampOverscroll, type DragGestureHandle } from '@/shared/gesture'\nimport { resolveBuiltinLabel } from '@/shared/locale/builtin-labels'\nimport { normalizeLiteral } from '@/shared/normalize'\nimport { dispatchOpenChangeEvent } from '@/shared/open-state'\nimport { defineNativeDialogPresence } from '@/shared/overlay/native-dialog-presence'\nimport { defineNestedDrawerLayers } from '@/shared/overlay/nested-drawer-layers'\nimport { defineOpenOverlay, type OpenOverlayHandle } from '@/shared/overlay/open-overlay'\nimport { defineScrollLockLease } from '@/shared/scroll-lock/scroll-lock'\nimport { prefersReducedMotion } from '@/shared/theme/reduced-motion'\n\nimport { definePageShift } from './page-shift'\nimport style from './style.css?inline'\n\nconst ALLOWED_PLACEMENTS = ['right', 'left', 'top', 'bottom'] as const\n\nexport type DrawerPlacement = (typeof ALLOWED_PLACEMENTS)[number]\n\n/*\n * 释放后的拖拽关闭判定：\n *\n * - 基准校准：位移零点与判定时钟都在**首个 pointermove** 处重置（手势层\n *   `calibrateOnFirstMove`，drawer 显式开启），吸收「按下 → 首个 move」之间的空隙——\n *   触摸输入的首个 move 常已相对按下点偏移，不重置会让元素在首个 move 一次性兑现\n *   而跳动。代价是这段位移被丢弃，一次手势至少要累积两个 move 才可能产生位移；\n *   `DragMoveInfo/DragEndInfo` 的 `delta*` 与 `duration` 均以该点为零点与起点。\n * - 距离：**自抓取瞬间起的净位移**超过 drawer 尺寸的一半（下限 10px）。用净位移而不是\n *   绝对位置：从弹回/收尾途中重新抓取时，抓取瞬间停在哪里都不算「已经拖过一半」。\n *   尺寸量不到时（0）由下限兜底，保证退化场景不会因为阈值 0 而「动一下就关」。\n * - 甩动：整段手势的平均速度**达到** 500px/s（含等号）。用「整段手势」而不是释放\n *   瞬间的滑窗速度：滑窗只描述最后一小段轨迹，反向回扫（先往打开方向拖进量程，\n *   再快速扫回）在释放瞬间同样能凑出很高的滑窗速度，但它不是朝关闭方向的甩动。\n *   净速度 = 净位移 / 整段时长（自校准点起算），分母钳到 50ms；时长为 0 时速度取 0，\n *   而不是按 50ms 兜底放大——直接放大会把「测不到时长」变成一次甩动。\n * - 方向：净位移未朝闭合方向（`<= 0`）时一律弹回。\n * - 改主意：拖拽期内追踪「自折返点起」的位移，一旦自方向确认点回撤满 10px 即标记\n *   取消，甩动分支此后拒绝关闭；位移重新越过关闭距离阈值时清除标记，即\n *   「已经拖过一半」不受回撤影响。见 `_trackSwipeCancel`。\n * - 过冲阻尼：闭合方向全额 1:1 跟手，反向按 `dampOverscroll` 平方根压缩。阻尼作用于\n *   **本次手势的增量**，再叠加抓取瞬间的基准位移；对总位移做阻尼会连基准一起压缩，\n *   元素不再接着视觉位置走。\n */\nconst DRAG_CLOSE_RATIO = 0.5\nconst DRAG_MIN_CLOSE_DISTANCE = 10\nconst DRAG_FLICK_VELOCITY = 500\nconst DRAG_MIN_VELOCITY_SPAN_MS = 50\nconst DRAG_REVERSE_CANCEL_THRESHOLD = 10\nconst DRAG_REQUEST_WINDOW_MS = 120\n// backdrop 点击（click 链路）的轻点判定距离：按下起点到 click 坐标的欧氏位移未越过该值\n// 视为轻点，沿用「点 backdrop 关闭」语义（对齐 _dragCloseThreshold 的 10px 下限量级）。\n// 必须用欧氏长度（而非仅主轴分量）：只看主轴会让「主轴不动、垂直大幅滑动」的\n// press–drag–release 链路仍落在窗口内被误读成轻点。\nconst BACKDROP_TAP_DISTANCE = 10\n\n/*\n * header / footer 让开给「可点控件」的选择器（上下 placement 专用）。\n *\n * 上下 placement 的端头整块可拖后，让开靠**逐个控件**在事件层判断，不靠几何切割：\n * 切割要测量每个控件的位置，控件一改位置就失效；逐个控件让开是结构性的。\n *\n * 判据是「这个元素自己就代表一次用户操作」，分三类：\n *   - 原生可交互元素与原生可点容器（button / input / label / a[href] / summary …）\n *   - 显式可编辑（contenteditable）\n *   - 交互语义 role（组件库自绘的 checkbox、tab、menuitem 等没有原生 tag）\n * 另加「作者显式给了可聚焦 tabindex」：自定义控件常只靠 tabindex 暴露可操作性。\n *\n * 方向是**保守让开**：判不出来就让开。让开的代价是那一小块起不了拖（用户多点一下），\n * 判错的代价是控件失效（A6 那条回归），两者不对等。\n */\nconst HEADER_FOOTER_INTERACTIVE_SELECTOR = [\n  'button',\n  'input',\n  'select',\n  'textarea',\n  'label',\n  'summary',\n  'a[href]',\n  'audio[controls]',\n  'video[controls]',\n  '[contenteditable]:not([contenteditable=\"false\"])',\n  '[tabindex]:not([tabindex=\"-1\"])',\n  '[role=\"button\"]',\n  '[role=\"link\"]',\n  '[role=\"checkbox\"]',\n  '[role=\"switch\"]',\n  '[role=\"radio\"]',\n  '[role=\"tab\"]',\n  '[role=\"menuitem\"]',\n  '[role=\"menuitemcheckbox\"]',\n  '[role=\"menuitemradio\"]',\n  '[role=\"option\"]',\n  '[role=\"textbox\"]',\n  '[role=\"combobox\"]',\n  '[role=\"slider\"]',\n  '[role=\"spinbutton\"]'\n].join(',')\n\n/*\n * 释放后的收尾（弹回打开位 / 滑出到闭合位）由 CSS transition 接管（issue #123）：\n * 拖拽期间内联 transform + `transition: none`，松手时把终值与过渡参数写入内联并在\n * 同一次样式重算里解除抑制，回弹即唯一的一次 CSS 过渡。全程无 `element.animate()`、\n * 无 fill、无 JS→CSS 动画交接边界，因此不存在 Safari 采不到 before-change style 的\n * 窗口。\n *\n * 代价是没有弹簧的速度感知轨迹：释放速度只用于估算过渡时长，过冲手感由缓动曲线\n * 近似。两条曲线对应弹簧预设的阻尼比——close（ζ≈1.05）无过冲，\n * rebound（ζ≈0.74）保留约 3% 过冲。\n */\nconst SETTLE_MIN_MS = 180\nconst SETTLE_MAX_MS = 420\nconst SETTLE_EASE_CLOSE = 'cubic-bezier(0.32, 0.72, 0, 1)'\n// 过冲量由 y1 决定：1.3 时峰值 ≈2.99%，与 ζ≈0.74 的理论过冲（3.15%）对齐；1.12 只剩 0.37%。\nconst SETTLE_EASE_REBOUND = 'cubic-bezier(0.22, 1.3, 0.36, 1)'\n// 估算时长的速度下限（px/s）：静止释放时退化为最大时长，避免除零与无限时长。\nconst SETTLE_MIN_VELOCITY = 1\n// transitionend 兜底定时器的宽限：覆盖一帧的调度抖动。\nconst SETTLE_GRACE_MS = 80\n\n/*\n * 拖拽期间由 JS 写入的 backdrop 透明度变量参与 WAAPI 关键帧。未注册的自定义属性在\n * 关键帧之间是离散插值（半帧跳变），注册为 <number> 后获得线性插值。\n * inherits 必须为 true：::backdrop 只从 originating element 继承「可继承属性」，\n * 注册为不可继承会让变量到不了 backdrop，跟手淡出整体失效（Chrome 151 实证）。\n * 注册表是全局的，模块重复执行（HMR）时捕获已注册错误并忽略。\n */\nif (typeof CSS !== 'undefined' && 'registerProperty' in CSS) {\n  try {\n    CSS.registerProperty({\n      name: '--wui-internal-drag-backdrop-opacity',\n      syntax: '<number>',\n      inherits: true,\n      initialValue: '1'\n    })\n  } catch {\n    // 已注册（如 HMR 重复执行）时忽略\n  }\n  /*\n   * 公开 token 注册为 <length>：Consumer 传 unitless 0 时计算值被归一为 0px，\n   * 避免 calc(100% + 0) 因 number/percentage 不兼容而使闭合位移失效。\n   */\n  try {\n    CSS.registerProperty({\n      name: '--wui-drawer-inset',\n      syntax: '<length>',\n      inherits: true,\n      initialValue: '8px'\n    })\n  } catch {\n    // 已注册（如 HMR 重复执行）时忽略\n  }\n  /*\n   * 嵌套层叠对数曲线的基准 A（shift = A · ln(depth + 1)）：注册为 <length> 后\n   * 桌面基准只有这一个真相源，JS 从 computed style 读到的永远是确定值；\n   * 窄视口基准由 style.css 的媒体查询覆盖同一 token。消费方写 unitless 的\n   * `0` 会在计算值阶段归一成 `0px`（层叠露边归零，而不是让 ln 项算出 NaN）。\n   *\n   * A = 43.2px 来自视觉 pass：四层等宽 320px 时逐层露边\n   * 29.94 / 17.52 / 12.43px，总堆叠宽 59.89px。\n   *\n   * 取值由**最里层**那一跳决定：对数曲线压得最狠的正是第四层，它只有\n   * A·ln(4/3) = 0.288A。12.43px 略高于 12px 的线性步进，但余量已经收窄到\n   * 3.5%——继续下调会让最里层那一条边与上一条边难以分辨。若还要更小的基准，\n   * 应先改 ln 的压缩比而不是只降 A。\n   */\n  try {\n    CSS.registerProperty({\n      name: '--wui-drawer-nested-peek-base',\n      syntax: '<length>',\n      inherits: true,\n      initialValue: '43.2px'\n    })\n  } catch {\n    // 已注册（如 HMR 重复执行）时忽略\n  }\n  /*\n   * 收尾过渡的时长：注册为 <time> 后 ::backdrop 也能继承到同一值。不注册时变量在\n   * transition 简写里只是 token 替换，值一旦无效整条声明在计算值阶段失效\n   * （退化为 transition: none），回弹会变成瞬移。\n   * 缓动不注册：CSS 属性语法没有 <easing-function>，且它不需要插值，靠 var() 的\n   * 兜底值即可。\n   */\n  try {\n    CSS.registerProperty({\n      name: '--wui-internal-settle-duration',\n      syntax: '<time>',\n      inherits: true,\n      initialValue: '280ms'\n    })\n  } catch {\n    // 已注册（如 HMR 重复执行）时忽略\n  }\n}\n\n@customElement('web-ui-drawer')\nexport class WebUiDrawer extends LitElement {\n  static override styles = [unsafeCSS(glass), unsafeCSS(modalSurface), unsafeCSS(scrollbarStyle), unsafeCSS(style)]\n\n  @property({ type: Boolean, reflect: true }) open = false\n  @property({ type: Boolean, reflect: true, attribute: 'no-scroll-lock' }) noScrollLock = false\n  @property({ type: Boolean, reflect: true, attribute: 'no-backdrop-close' }) noBackdropClose = false\n\n  /**\n   * Controlled 模式下，Escape、backdrop、关闭 button 和拖拽关闭只派发 `open-change` 请求，\n   * 不会自行修改 `open`。Consumer 回写 `open` 后才执行关闭动画。\n   * 程序化 API（show/close/直接赋值 open）不受此模式影响，始终直通。\n   */\n  @property({ type: Boolean, reflect: true }) controlled = false\n\n  @property({ type: String, reflect: true })\n  get placement(): DrawerPlacement {\n    return this._placement\n  }\n  set placement(v: string) {\n    const old = this._placement\n    this._placement = normalizeLiteral(v, ALLOWED_PLACEMENTS, 'right')\n    this.requestUpdate('placement', old)\n  }\n  private _placement: DrawerPlacement = 'right'\n\n  // 标题文字（未传 header slot 时显示默认 header）\n  @property({ type: String }) heading = ''\n\n  @property({ type: Boolean, reflect: true }) closable = false\n\n  /**\n   * Headless 模式：只保留 overlay 基础设施（backdrop、动画、scroll lock、dialog 语义），\n   * 移除内置 UI（glass 样式、header、close button、footer）。Consumer 自定义内容样式。\n   */\n  @property({ type: Boolean, reflect: true }) headless = false\n\n  /**\n   * 内部原生 dialog 的 accessible name。headless 模式必须由 Consumer 提供，\n   * 因为该模式不会渲染可自动关联的内置 header。\n   */\n  @property({ type: String, attribute: 'aria-dialog-label' }) ariaDialogLabel = ''\n\n  /*\n   * `dialog-label` 自 11.1.0 发布，为已上线消费方保留兼容别名：attribute 仍可写，\n   * 内部转发到 ariaDialogLabel。canonical 名是 aria-dialog-label；两个 attribute 同时\n   * 设置时后处理者生效，文档不推荐这样做。下个 major 移除本别名。\n   */\n  /** @deprecated 用 `aria-dialog-label`。 */\n  @property({ type: String, attribute: 'dialog-label' })\n  get dialogLabel(): string {\n    return this.ariaDialogLabel\n  }\n  set dialogLabel(value: string) {\n    this.ariaDialogLabel = value\n  }\n\n  /** 关闭按钮的无障碍名称；未设置时回退内置英文文案（见 ADR-0016）。 */\n  @property({ type: String, attribute: 'aria-close-label' }) ariaCloseLabel = ''\n\n  /**\n   * 启用拖拽关闭：打开态在 drawer 内缘渲染 drag bar（灰色胶囊 + 加宽 drag zone），\n   * 指针拖拽实时跟手，松手按位移与甩动速度判定关闭或弹回。\n   * 关闭态基于原生 dialog 无可见渲染物，因此不支持从关闭态拖拽打开。\n   */\n  @property({ type: Boolean, reflect: true }) override draggable = false\n\n  /**\n   * 打开时整页朝 drawer 进场方向让开一段距离：横向 1 个轴单位 a 是 `1vw`、纵向是 `1vh`，\n   * 第 1 层让开 16a，之后每层减半，等比和收敛到 32a、不会超过。\n   * 位移写在 `documentElement` 上：页面里的 fixed 内容会一起走，top layer 中的\n   * `<dialog>`（含本 drawer 自己）不受影响。位移以 `vw` / `vh` 写在根元素上，视口宽高\n   * 变化时跟着重算，不需要重新打开。\n   * 嵌套与同级 drawer 都按打开先后排层。reduce 档位下整套不生效。\n   */\n  @property({ type: Boolean, reflect: true, attribute: 'page-shift' }) pageShift = false\n\n  private get dialog() {\n    return this.shadowRoot?.querySelector('dialog') ?? null\n  }\n\n  private _hasHeaderSlot = false\n  private _hasFooterSlot = false\n  private readonly _userOpenChange = new UserChangeController()\n  /*\n   * 上下 placement 的拖拽 drag zone 要让开头尾两节（见 style.css 的 --wui-internal-drawer-* 说明）：\n   * `bottom` 贴顶边、drag zone 让开 header，`top` 贴底边、drag zone 让开 footer。让开的量就是那一节的\n   * border-box 高度，写成 host 上的自定义属性交给 CSS 去算偏移——样式侧因此不必知道\n   * header / footer 的存在与高度，两条 placement 规则各只读自己的那个属性。\n   *\n   * 用 offsetHeight 而非 CSS 侧推导：`[hidden]` 的节天然是 0（让位量归零，drag zone 回到 panel 边缘），\n   * 而「header 存在但高度为 0」与「没有 header」在布局上是同一件事，不需要额外的存在性 toggle。\n   * 高度是动态的（consumer 的 padding、窄屏断点改写、slotted 内容换行），所以观察而非读取一次。\n   */\n  private readonly _headerHeight = new ElementHeightController(this, '.wui-drawer-header', height =>\n    this._setAvoidance('--wui-internal-drawer-header-inset', height)\n  )\n  private readonly _footerHeight = new ElementHeightController(this, '.wui-drawer-footer', height =>\n    this._setAvoidance('--wui-internal-drawer-footer-inset', height)\n  )\n\n  /*\n   * 让位量 = 该节高度 + 一点呼吸间距，且**只在真有那一节时**才加间距。\n   *\n   * 间距写成属性值里的 calc 而不是让 CSS 无条件相加，是因为「没有 header」这一态必须精确等于\n   * 让位量 0 的几何（drag zone 顶边贴 panel 顶边）。若让间距无条件生效，无 header 的 drawer 会\n   * 平移 4px，drag zone 端边与 panel 端边的贴合关系跟着变——那是\n   * `header-drag-surface.browser.spec.ts` 的 R2 钉住的关系，这条护栏不该让步。\n   * 间距本身仍以 token 暴露，真机调参不必改代码。\n   */\n  private _setAvoidance(property: string, height: number) {\n    this.style.setProperty(\n      property,\n      height > 0 ? `calc(${height}px + var(--wui-drawer-drag-zone-inset, var(--wui-space-1, 4px)))` : '0px'\n    )\n  }\n  private readonly _scrollLock = defineScrollLockLease().make()\n  private readonly _presence = defineNativeDialogPresence().make({\n    getDialog: () => this.dialog,\n    isConnected: () => this.isConnected,\n    isOpen: () => this.open\n  })\n  // nested 层序：打开后纳入全局栈，上层打开/关闭时本层缩放平移。\n  private readonly _nestedLayers = defineNestedDrawerLayers().make({\n    getDialog: () => this.dialog,\n    getPlacement: () => this._placement\n  })\n  /*\n   * 整页让开（page-shift）。轴向与符号都取自拖拽那套：页面朝 drawer 的**进场方向**移动，\n   * 即闭合方向的反向，所以符号是 `-_dragCloseSign`。两者共用同一张 placement 表，\n   * 新增 placement 时只需要改一处。\n   */\n  private readonly _pageShift = definePageShift().make({\n    getHost: () => this,\n    isEnabled: () => this.pageShift,\n    getAxis: () => this._dragAxis,\n    getSign: () => -this._dragCloseSign\n  })\n  /*\n   * 开启态 overlay（issue #120 Block 1）。drawer 把自己的原生 <dialog> 登记为 panel，使挂在\n   * dialog 上的 portal panel（select / dropdown / tooltip）在逻辑组合树上成为它的后代，\n   * 仲裁者据此选出最内层。\n   *\n   * 拖拽进行中不响应 Escape，但**仍是候选**：仲裁者照旧吞掉按键并压掉原生 cancel，\n   * 只是不走关闭入口。关闭入口只有这一个执行者。\n   */\n  private readonly _overlay = defineOpenOverlay().make({\n    requestClose: () => this._closeFromUser(),\n    isConnected: () => this.isConnected\n  })\n  /** 当前开启会话的 handle；未开启时为 null。 */\n  private _handle: OpenOverlayHandle | null = null\n\n  private _dragGesture: DragGestureHandle | null = null\n  // pointerdown 时刻已存在的闭合方向位移（从弹回动画中抓取时非 0）。\n  private _dragInitialOffset = 0\n  private _dragOffset = 0\n  // 位移零点与判定时钟由手势层的 `calibrateOnFirstMove` 校准到首个 pointermove，\n  // 这里只保留「改主意」相关的追踪状态。\n  // 折返点（轴坐标）：随反向移动拉到当前坐标。\n  private _cancelBaseline = 0\n  // 上一次 move 的轴坐标，用于求移动量。\n  private _lastAxisPos = 0\n  // 方向确认时的位移；负值表示方向尚未确认。\n  private _swipeIntentDisp = -1\n  // 已判定为「改主意」，甩动分支据此拒绝关闭。\n  private _swipeCancelled = false\n  // 释放后的 CSS transition 收尾：完成回调，以及终值与当前值相同时\n  // 不会派发 transitionend 的兜底定时器。\n  private _settleFinish: (() => void) | null = null\n  private _settleTimer: ReturnType<typeof setTimeout> | undefined\n  // controlled：弹簧到闭合位后等待 Consumer 回写 open；超时未回写则弹回。\n  private _dragAwaitWriteback = false\n  private _dragRequestTimer: ReturnType<typeof setTimeout> | undefined\n\n  private get _dragAxis(): 'x' | 'y' {\n    return this._placement === 'left' || this._placement === 'right' ? 'x' : 'y'\n  }\n\n  // 位移正方向 = drawer 的闭合方向（拖出屏幕为正）。\n  private get _dragCloseSign(): number {\n    switch (this._placement) {\n      case 'right':\n        return 1\n      case 'left':\n        return -1\n      case 'top':\n        return -1\n      case 'bottom':\n        return 1\n    }\n  }\n\n  private _measureDragSize(): number {\n    const dialog = this.dialog\n    if (!dialog) return 0\n    return this._dragAxis === 'x' ? dialog.offsetWidth : dialog.offsetHeight\n  }\n\n  // 关闭距离阈值：尺寸的一半，下限 10px。\n  // 胶囊的 accent 视觉确认与实际判定共用同一阈值，两者不会漂移。\n  private _dragCloseThreshold(size: number): number {\n    return Math.max(size * DRAG_CLOSE_RATIO, DRAG_MIN_CLOSE_DISTANCE)\n  }\n\n  // 浮动卡片（非 headless）的四周留边；闭合位移需越过它才能完全滑出视口。\n  // headless 在 :host([headless]) dialog 上显式归零（防嵌套继承），解析失败回退 0。\n  private _readDrawerInset(dialog: HTMLDialogElement): number {\n    const raw = getComputedStyle(dialog).getPropertyValue('--wui-internal-drawer-inset')\n    const parsed = Number.parseFloat(raw)\n    return Number.isFinite(parsed) ? parsed : 0\n  }\n\n  // 闭合方向上的完全出屏距离：drawer 尺寸 + 浮动留边（headless 下即尺寸本身）。\n  // CSS 闭合态 transform、controlled 悬停终态与弹簧终点共用同一数学，避免衔接跳变。\n  private _dragCloseDistance(dialog: HTMLDialogElement): number {\n    return this._measureDragSize() + this._readDrawerInset(dialog)\n  }\n\n  private _isDragging(): boolean {\n    return this._dragGesture?.isDragging() ?? false\n  }\n\n  /*\n   * 拖拽期间本层仍是候选：仲裁者照旧 preventDefault（压掉原生 <dialog> 的 cancel）与\n   * stopPropagation，只是不调用 requestClose。`isDragging()` 的翻转由手势层内部决定，\n   * 所以随 move 与各终结路径同步（幂等）。除拖拽外本层没有别的惰性来源。\n   */\n  private _syncDragInert() {\n    this._handle?.setInert(this._isDragging())\n  }\n\n  private _cancelDragAwait() {\n    if (this._dragRequestTimer !== undefined) {\n      clearTimeout(this._dragRequestTimer)\n      this._dragRequestTimer = undefined\n    }\n    this._dragAwaitWriteback = false\n  }\n\n  /**\n   * 上下 placement 的 header / footer 自己接拖拽手势。\n   *\n   * 为什么不是「把 drag zone 铺到 header 上」：那样 header 里的控件会被透明命中层吞掉，\n   * 正是 A6 修掉的那条缺陷。这里在事件层让开——控件照常收自己的事件，拖拽只在\n   * 「落点不是可点控件」时起手。\n   *\n   * 三道闸门任一不成立就不接管：\n   * 1. placement 必须是上下。左右 placement 的拖拽轴是 x，端头在竖边上，header\n   *    既不在可抓边缘上也不该起手（R4 的行为侧）。\n   * 2. 下层嵌套 drawer 整套拖拽提示一起退场。drag zone 与 drag edge 靠 CSS 的 pointer-events 退场，\n   *    事件层必须自己判同一条，否则 header 会成为唯一一条漏网的入口。\n   * 3. 落点路径里有可点控件就让开——控件优先于「这一块可拖」。\n   */\n  private _handleSectionDragPointerDown(e: PointerEvent) {\n    if (this._placement !== 'top' && this._placement !== 'bottom') return\n    const section = (e.currentTarget as HTMLElement | null)?.closest('.wui-drawer-header, .wui-drawer-footer')\n    const isHeader = section?.classList.contains('wui-drawer-header') ?? false\n    // 只有**贴着可抓边缘**的那一节接手势：bottom 的 header、top 的 footer。\n    // 另一节在 panel 远端，在那里起手却朝闭合方向拖是反直觉的，也不属于「端头」——\n    // 与 drag zone 只让开同一侧那节是同一条边界。\n    if (this._placement === 'bottom' && !isHeader) return\n    if (this._placement === 'top' && isHeader) return\n    // 下层嵌套 drawer 整套拖拽提示一起退场：drag zone 与 drag edge 靠 CSS 的 pointer-events 退场，\n    // 事件层必须判同一条，否则这里是唯一一条漏网的入口。\n    if (this.dialog?.classList.contains('is-nested-lower')) return\n    if (this._isInteractivePath(e)) return\n    this._handleDragPointerDown(e)\n  }\n\n  /**\n   * 按下路径上是否出现可点控件。\n   *\n   * 走 composedPath 而不是 event.target：消费侧 slotted 控件与组件库自绘控件都各有\n   * shadow root，target 只给出最内层那个节点，沿 parentElement 上行会在 shadow 边界\n   * 断掉，控件自己那层反而看不见。\n   */\n  private _isInteractivePath(e: PointerEvent): boolean {\n    const path = typeof e.composedPath === 'function' ? e.composedPath() : [e.target]\n    for (const node of path) {\n      if (node instanceof Element && node.matches(HEADER_FOOTER_INTERACTIVE_SELECTOR)) return true\n    }\n    return false\n  }\n\n  private _handleDragPointerDown(e: PointerEvent) {\n    if (!this.open || !this.draggable || this._isDragging()) return\n    // 多点触控的副指针（isPrimary 明确为 false）不参与手势。\n    if (e.isPrimary === false) return\n\n    const dialog = this.dialog\n    if (!dialog) return\n    // is-visible 由 presence 在 showModal 后一帧加上；就位前（打开极早期）忽略。\n    // 就位后即使 enter 过渡仍在进行也允许抓取，起始位移从当前计算值续接。\n    if (!dialog.classList.contains('is-visible')) return\n\n    // 先读取动画中的当前位移再取消弹回动画，避免取消后回跳到内联样式值。\n    const currentTransform = getComputedStyle(dialog).transform\n    const axisValue =\n      currentTransform && currentTransform !== 'none' && typeof DOMMatrixReadOnly === 'function'\n        ? new DOMMatrixReadOnly(currentTransform)[this._dragAxis === 'x' ? 'm41' : 'm42']\n        : 0\n    // 收尾过渡进行中被重新抓取：丢弃收尾状态（不执行其回调，避免它回头写内联），\n    // 位移已在下面按当前计算值续接。\n    this._abortSettle()\n    this._cancelDragAwait()\n\n    this._dragInitialOffset = axisValue * this._dragCloseSign\n    this._dragOffset = this._dragInitialOffset\n    // 判定基准复位：折返点从按下位置起算。\n    const axisPos = this._dragAxis === 'x' ? e.clientX : e.clientY\n    this._cancelBaseline = axisPos\n    this._lastAxisPos = axisPos\n    this._swipeIntentDisp = -1\n    this._swipeCancelled = false\n    dialog.classList.add('is-dragging')\n    // 收尾过渡进行中重新抓取时内联还停在收尾终值（打开位/闭合位），不写回当前位移\n    // 会在抑制生效的瞬间跳到终值。写回后计算值 == 抓取瞬间的视觉位置，无跳变。\n    this._applyDragOffset(dialog, this._dragOffset)\n\n    this._dragGesture = attachDragGesture(e, {\n      axis: this._dragAxis,\n      // 拖拽零点与判定时钟一起重置到首个 move。\n      calibrateOnFirstMove: true,\n      onMove: info => {\n        // info 的 delta/duration 已以校准点为零点。\n        const pointerDelta = this._dragAxis === 'x' ? info.deltaX : info.deltaY\n        // 本次手势自校准点起的**增量**（朝闭合方向为正，未阻尼）。\n        const dragDelta = pointerDelta * this._dragCloseSign\n        // 阻尼只作用于增量，再叠加抓取瞬间的基准位移。对总位移做阻尼会在「从弹回中\n        // 重新抓取」时差出可见位移——基准位移本身会被一起压缩，元素不再接着视觉位置走。\n        this._dragOffset = this._dragInitialOffset + dampOverscroll(dragDelta)\n        this._trackSwipeCancel(this._dragAxis === 'x' ? info.clientX : info.clientY, dragDelta)\n\n        // 达到关闭阈值时胶囊换成更实的中性灰作视觉确认。与距离分支共用同一量\n        //（自抓取瞬间起的净位移）与同一阈值，视觉确认与实际判定不会漂移。\n        const dragSize = this._measureDragSize()\n        const dragDisplacement = this._dragOffset - this._dragInitialOffset\n        dialog.classList.toggle('is-drag-close', dragDisplacement > this._dragCloseThreshold(dragSize))\n        this._applyDragOffset(dialog, this._dragOffset)\n      },\n      onEnd: info => {\n        this._dragGesture = null\n        this._syncDragInert()\n        dialog.classList.remove('is-dragging', 'is-drag-close')\n        const size = this._measureDragSize()\n        const velocity = (this._dragAxis === 'x' ? info.velocityX : info.velocityY) * this._dragCloseSign\n        // 净位移从抓取瞬间的位移起算（弹回/收尾过渡中被重新抓取时起点非 0）。\n        const displacement = this._dragOffset - this._dragInitialOffset\n        // 时长同样自校准点（首个 move）起算，与位移零点同源：按下后的停顿不参与分母。\n        // 分母下限 50ms；时长量为 0（首尾时间戳相同，或事件时间戳不可用/倒退）时速度取\n        // 0——直接按 50ms 兜底会把「测不到时长」放大成一次甩动。\n        const netVelocity =\n          info.duration > 0 ? (displacement / Math.max(info.duration, DRAG_MIN_VELOCITY_SPAN_MS)) * 1000 : 0\n        // 甩动判据：净位移朝闭合方向（`> 0`）、平均速度达到阈值（`>=`）、\n        // 且本次手势未被判定为「改主意」。\n        const flicked = displacement > 0 && netVelocity >= DRAG_FLICK_VELOCITY && !this._swipeCancelled\n        // 距离分支同样用净位移，不是绝对位置：抓取瞬间停在哪里都不算「已经拖过一半」。\n        // `_dragOffset` 只留给收尾的起点使用。\n        const shouldClose = displacement > this._dragCloseThreshold(size) || flicked\n\n        if (shouldClose) this._settleToClose(dialog, velocity)\n        else this._settleRebound(dialog, velocity, this._dragOffset)\n      },\n      onCancel: () => {\n        this._dragGesture = null\n        this._syncDragInert()\n        dialog.classList.remove('is-dragging', 'is-drag-close')\n        this._settleRebound(dialog, 0, this._dragOffset)\n      }\n    })\n    /*\n     * 惰性必须与 attach 同拍。漏掉这里，按下到手势终结之间那一整段里 Escape 仍会关闭\n     * drawer——push 通道没有自动同步，每个翻转点自己推一次。\n     *\n     * `isDragging()` 的翻转点不止 attach 与 onEnd：手势层的 `handlePointerMove` 在越过死区后\n     * 若判定轴向冲突（限定了 x 轴却明显纵向移动，或反之）会直接 `cancel()`，\n     * `lostpointercapture` 也会终结手势。这些路径都走 `onCancel`，所以 `onCancel` 里那次\n     * `_syncDragInert()` **不是**冗余——删掉它，「移动中取消拖拽」会让 drawer 重新变回可被\n     * Escape 关闭。\n     */\n    this._syncDragInert()\n  }\n\n  /*\n   * 「改主意」守卫。\n   *\n   * 折返点随「反向移动」被拉到当前坐标，因此「自折返点起的位移」度量的是**自最近一次\n   * 折返之后**回撤了多少：一旦它比方向确认时的位移少满 10px，本次手势即被标记为\n   * 「改主意」，甩动分支据此拒绝关闭；位移重新越过关闭距离阈值即清除标记，\n   * 即「已经拖过一半」不受回撤影响。\n   *\n   * @param axisPos 本次 move 在主轴上（`_dragAxis`）的指针坐标\n   * @param displacement 自校准点起、朝闭合方向的**未阻尼**位移\n   */\n  private _trackSwipeCancel(axisPos: number, displacement: number) {\n    const movement = axisPos - this._lastAxisPos\n    this._lastAxisPos = axisPos\n    if ((movement < 0 && axisPos > this._cancelBaseline) || (movement > 0 && axisPos < this._cancelBaseline)) {\n      this._cancelBaseline = axisPos\n    }\n\n    if (this._swipeIntentDisp < 0) {\n      // 方向确认：首次朝闭合方向累积出位移。\n      if (displacement > 0) this._swipeIntentDisp = displacement\n      return\n    }\n\n    const cancelDisplacement = (axisPos - this._cancelBaseline) * this._dragCloseSign\n    if (cancelDisplacement > this._dragCloseThreshold(this._measureDragSize())) {\n      this._swipeCancelled = false\n    } else if (this._swipeIntentDisp - cancelDisplacement >= DRAG_REVERSE_CANCEL_THRESHOLD) {\n      this._swipeCancelled = true\n    }\n  }\n\n  // 受控状态写入等外部原因强制终结拖拽：清手势状态与拖拽样式，不弹回，\n  // 后续管线（关闭/打开）由调用方继续执行。\n  private _cancelActiveDrag() {\n    if (!this._isDragging()) return\n    this._dragGesture?.destroy()\n    this._dragGesture = null\n    this._syncDragInert()\n    const dialog = this.dialog\n    if (!dialog) return\n    dialog.classList.remove('is-dragging', 'is-drag-close')\n    this._clearDragStyles(dialog)\n  }\n\n  // 将闭合方向位移映射为 dialog transform，并同步 backdrop 透明度保持跟手反馈。\n  private _applyDragOffset(dialog: HTMLDialogElement, offset: number) {\n    const sign = this._dragCloseSign\n    const value = offset * sign\n    dialog.style.transform = this._dragAxis === 'x' ? `translateX(${value}px)` : `translateY(${value}px)`\n    const size = this._measureDragSize()\n    const progress = size > 0 ? Math.min(1, Math.max(0, offset / size)) : 0\n    dialog.style.setProperty('--wui-internal-drag-backdrop-opacity', String(1 - progress))\n  }\n\n  private _clearDragStyles(dialog: HTMLDialogElement) {\n    dialog.style.removeProperty('transform')\n    dialog.style.removeProperty('--wui-internal-drag-backdrop-opacity')\n  }\n\n  // 由 CSS transition 收尾到完全闭合；controlled 下保持闭合位等待回写，其余走常规关闭管线。\n  private _settleToClose(dialog: HTMLDialogElement, velocity: number) {\n    const from = this._dragOffset\n    this._dragOffset = 0\n    // 终点 = 完全出屏距离（含浮动留边），与 CSS 闭合态/悬停终态一致，\n    // 否则收尾结束后会有一个留边宽度的瞬移。\n    const to = this._dragCloseDistance(dialog)\n\n    const finishClose = () => {\n      if (this.controlled) {\n        // 保持在闭合位（is-visible 未移除，状态仍 open），等待 Consumer 回写或超时弹回。\n        this._applyDragOffset(dialog, to)\n      } else {\n        // 移除 is-visible 后基础 transform 即闭合位，清内联样式不产生跳变；\n        // presence.sync(false) 检测不到 is-visible 会立即完成关闭，不重播退出动画。\n        dialog.classList.remove('is-visible')\n        this._clearDragStyles(dialog)\n      }\n      this._closeFromDrag()\n    }\n\n    if (prefersReducedMotion(this) || Math.abs(to - from) < 1) {\n      // 与 _settleRebound 的无动画路径对称：自己解除抑制，不依赖调用方清过类。\n      dialog.classList.remove('is-dragging')\n      finishClose()\n      return\n    }\n\n    this._startSettle(\n      dialog,\n      to,\n      0,\n      this._settleDuration(Math.abs(to - from), velocity),\n      SETTLE_EASE_CLOSE,\n      finishClose\n    )\n  }\n\n  // 弹回打开位：从 from 位移回到 0；结束后把内联样式交还 CSS 打开态。\n  private _settleRebound(dialog: HTMLDialogElement, velocity: number, from: number) {\n    this._dragOffset = 0\n\n    // 收尾结束必须清掉内联 transform：translateX(0px) 内联会盖住闭合态 CSS transform，\n    // 之后用 button/backdrop/Esc 关闭时计算值恒为 0、开与关都不再触发过渡。\n    const finishRebound = () => {\n      this._clearDragStyles(dialog)\n    }\n\n    if (prefersReducedMotion(this) || Math.abs(from) < 1) {\n      // 无动画路径：直接移除内联回到 CSS 打开位。计算值就是可信的打开位 0，\n      // 不存在 WAAPI fill 覆盖，无需强制 reflow「烘焙」。\n      dialog.classList.remove('is-dragging')\n      finishRebound()\n      return\n    }\n\n    this._startSettle(dialog, 0, 1, this._settleDuration(Math.abs(from), velocity), SETTLE_EASE_REBOUND, finishRebound)\n  }\n\n  // 释放速度只影响收尾时长：以它走完剩余距离的时间作为估计，慢放长、甩动短。\n  private _settleDuration(distance: number, velocity: number): number {\n    const ms = (distance / Math.max(Math.abs(velocity), SETTLE_MIN_VELOCITY)) * 1000\n    return Math.min(SETTLE_MAX_MS, Math.max(SETTLE_MIN_MS, ms))\n  }\n\n  /*\n   * 把释放后的收尾交给 CSS transition：写入终值与「时长/缓动」两个内部变量，并在\n   * 同一次样式重算里解除抑制（is-dragging → is-settling）。过渡的 before-change\n   * style 就是拖拽期间写入的内联值——没有 WAAPI 覆盖层，各引擎采样一致，这正是\n   * 对 Safari「不采信 fill 覆盖」怪癖免疫的原因。\n   */\n  private _startSettle(\n    dialog: HTMLDialogElement,\n    offset: number,\n    backdropOpacity: number,\n    duration: number,\n    easing: string,\n    onDone: () => void\n  ) {\n    // 覆盖前先丢弃上一次收尾：否则它的兜底定时器会提前结束这一次的过渡。\n    this._abortSettle()\n    const sign = this._dragCloseSign\n    dialog.style.setProperty('--wui-internal-settle-duration', `${duration}ms`)\n    dialog.style.setProperty('--wui-internal-settle-easing', easing)\n    dialog.style.transform =\n      this._dragAxis === 'x' ? `translateX(${offset * sign}px)` : `translateY(${offset * sign}px)`\n    dialog.style.setProperty('--wui-internal-drag-backdrop-opacity', String(backdropOpacity))\n    dialog.classList.add('is-settling')\n    dialog.classList.remove('is-dragging')\n\n    this._settleFinish = onDone\n    // 终值与当前值相同时不会派发 transitionend（也没有可见变化），用定时器兜底。\n    this._settleTimer = setTimeout(() => this._finishSettle(), duration + SETTLE_GRACE_MS)\n  }\n\n  // 收尾过渡结束（transitionend 或兜底超时）：先撤 settle 状态再执行收尾。\n  private _finishSettle() {\n    const finish = this._settleFinish\n    if (!finish) return\n    this._abortSettle()\n    finish()\n  }\n\n  // 丢弃进行中的收尾（重新抓取、强制关闭、断连）：只撤状态，不执行收尾回调。\n  private _abortSettle() {\n    this._settleFinish = null\n    if (this._settleTimer !== undefined) {\n      clearTimeout(this._settleTimer)\n      this._settleTimer = undefined\n    }\n    const dialog = this.dialog\n    if (!dialog) return\n    dialog.classList.remove('is-settling')\n    dialog.style.removeProperty('--wui-internal-settle-duration')\n    dialog.style.removeProperty('--wui-internal-settle-easing')\n  }\n\n  private _closeFromDrag() {\n    // 先派发关闭请求（_closeFromUser），再进入悬停等待：等待态中 _closeFromUser\n    // 会被 L2 去重守卫短路，顺序颠倒会吞掉首次请求。\n    this._closeFromUser()\n    if (this.controlled) {\n      this._dragAwaitWriteback = true\n      this._dragRequestTimer = setTimeout(this._handleDragWritebackTimeout, DRAG_REQUEST_WINDOW_MS)\n    }\n  }\n\n  // controlled 回写窗口超时：Consumer 拒绝关闭，从闭合位弹回打开位。\n  private readonly _handleDragWritebackTimeout = () => {\n    this._dragRequestTimer = undefined\n    if (!this._dragAwaitWriteback || !this.open || this._isDragging()) {\n      this._dragAwaitWriteback = false\n      return\n    }\n    this._dragAwaitWriteback = false\n\n    const dialog = this.dialog\n    if (!dialog) return\n    dialog.classList.add('is-visible')\n    // 悬停终态位于完全出屏位（含留边），弹回也从该真实位置起步，避免首帧内跳。\n    this._settleRebound(dialog, 0, this._dragCloseDistance(dialog))\n  }\n\n  override connectedCallback() {\n    super.connectedCallback()\n    this._resyncSlotPresence()\n    // 重挂载对账：断连时 presence、滚动锁、nested 层序与登记都已被撤销，而\n    // `open` 未变化时 `updated()` 不会补跑任何 sync 分支。首次连接时 shadow 尚未\n    // 渲染、`this.dialog` 为 null，三种情况都直接跳过；打开态的首次进入仍由\n    // updated() 的 `props.has('open')` 分支处理。\n    this._presence.reconcile()\n    if (this.open) {\n      // presence.reconcile 已让打开态的 dialog 同步回到 top layer（此刻 dialog.open\n      // 为真），层序 depth 可正确计数，与 updated() 的 register 时机一致。\n      this._nestedLayers.register()\n      // 重挂载前已让开过的页面停在位移位：push 的动画起点取当前计算值，与终点相同\n      // 时不起动画，页面不会被再推一次、也不会先弹回原位再推出去。\n      this._pageShift.push()\n    }\n    this._syncScrollLock()\n    this._reclaimIfOpen()\n  }\n\n  override firstUpdated() {\n    this._checkSlotContent('footer')\n  }\n\n  override disconnectedCallback() {\n    super.disconnectedCallback()\n    this._nestedLayers.dispose()\n    this._pageShift.dispose()\n    this._dragGesture?.destroy()\n    this._dragGesture = null\n    this._presence.dispose()\n    this._scrollLock.release()\n    // 断连即撤销登记，重连后由 _reclaimIfOpen 显式重新声明。\n    this._handle?.release()\n    this._handle = null\n    this._abortSettle()\n    this._cancelDragAwait()\n  }\n\n  /** 「重挂载恢复」的调用方一半：模块刻意不观察 DOM 连接状态。 */\n  private _reclaimIfOpen() {\n    if (!this.open || this._handle) return\n    const dialog = this.dialog\n    if (!dialog) return\n    this._handle = this._overlay.claim(dialog, { ancestryFrom: this })\n    this._syncDragInert()\n  }\n\n  /**\n   * 对账 header / footer slot 的有无，**只在真的变了时排一次更新**。\n   *\n   * 排更新是这条对账不可省的一半：`showHeader` 与 footer 的 `?hidden` 只在 render 里求值，\n   * 而 Lit 的 `connectedCallback` 只做 `enableUpdating(true)` 与 `setConnected(true)`，本身不排\n   * 更新。两条 slotchange 处理器也接不住这条路径——slotchange 只在**分配集合**变化时派发，\n   * 断连期间清空槽位内容时宿主节点本身没动，事件不触发（Chromium 实测）。\n   *\n   * 漏掉这一半的后果：断连前有 footer、重连时已清空的 drawer 留下一节空的 footer。它在 style.css\n   * 的 padding 下仍有真实高度（实测 32px），于是底部一条点不动的死带，拖拽 drag zone 的让位量也照\n   * 它算而不归零。\n   *\n   * 判据取 light DOM 子节点而非 `slot.assignedNodes()`：首次连接时 shadow 尚未渲染，slot 元素\n   * 还不存在，那一侧会直接跳过（首次连接的 presence 由 `firstUpdated()` 与 slotchange 兜底）；\n   * 这里要的正是重连对账——shadow root 跨断连保留，两侧都可用，但只有子节点扫描不依赖渲染\n   * 时序。「只在真变了才排」与两条 slotchange 处理器同一纪律，避免每次重连都多一次空渲染。\n   */\n  private _resyncSlotPresence() {\n    const hasHeader = this._hasSlottedChild('header')\n    const hasFooter = this._hasSlottedChild('footer')\n    if (hasHeader === this._hasHeaderSlot && hasFooter === this._hasFooterSlot) return\n    this._hasHeaderSlot = hasHeader\n    this._hasFooterSlot = hasFooter\n    this.requestUpdate()\n  }\n\n  private _hasSlottedChild(name: 'header' | 'footer') {\n    return Array.from(this.children).some(child => child.getAttribute('slot') === name)\n  }\n\n  private _checkSlotContent(name: string) {\n    const slot = this.shadowRoot?.querySelector(`slot[name=\"${name}\"]`) as HTMLSlotElement | null\n    if (!slot) return\n    const has = slot.assignedNodes().length > 0\n    if (name === 'footer' && has !== this._hasFooterSlot) {\n      this._hasFooterSlot = has\n      this.requestUpdate()\n    }\n  }\n\n  private handleHeaderSlotChange(e: Event) {\n    const has = (e.target as HTMLSlotElement).assignedNodes().length > 0\n    if (has !== this._hasHeaderSlot) {\n      this._hasHeaderSlot = has\n      this.requestUpdate()\n    }\n  }\n\n  private handleFooterSlotChange(e: Event) {\n    const has = (e.target as HTMLSlotElement).assignedNodes().length > 0\n    if (has !== this._hasFooterSlot) {\n      this._hasFooterSlot = has\n      this.requestUpdate()\n    }\n  }\n\n  protected override updated(props: PropertyValues) {\n    super.updated(props)\n    if (!this.isConnected) return\n\n    if (props.has('open')) {\n      // Consumer 在拖拽进行中写入受控 open：受控状态优先，立即终结手势（等同\n      // pointercancel 的清理但不弹回），交由下方 presence 走标准关闭/打开管线。\n      if (this._isDragging() && !this.open) this._cancelActiveDrag()\n      if (this._userOpenChange.consume()) this.emitOpenChange()\n      // controlled 拖拽关闭的回写结果：确认关闭则清除闭合位悬停状态走正常关闭；\n      // 拒绝关闭（回写 open=true）则从闭合位（含留边）弹回。\n      if (this._dragAwaitWriteback) {\n        this._cancelDragAwait()\n        const dialog = this.dialog\n        if (dialog && !this.open) {\n          dialog.classList.remove('is-visible')\n          this._clearDragStyles(dialog)\n        } else if (dialog && this.open) {\n          this._settleRebound(dialog, 0, this._dragCloseDistance(dialog))\n        }\n      }\n      // 关闭且无进行中的拖拽/收尾时，清理可能残留的内联拖拽样式（如收尾路径写在\n      // 打开位的 translateX(0px)）。若不清理，0px 内联会盖住闭合态 CSS transform，\n      // 后续开/关都不再触发过渡。收尾进行中由 _finishSettle 自行收尾，这里丢弃它\n      // 以免回调回头写内联与关闭管线竞争。\n      if (!this.open && !this._isDragging()) {\n        this._abortSettle()\n        const dialog = this.dialog\n        if (dialog) this._clearDragStyles(dialog)\n      }\n      this._presence.sync(this.open)\n      if (this.open) {\n        // presence.sync 内的 showModal() 把 dialog 提升进 top layer。双击手势本身\n        // 留下的活选区会被浏览器拿去和提升后的新布局重新解析，结果选区落到刚挂载的\n        // drawer 正文上。脆弱的是「手势来源的活选区」，不是 dblclick 的判定窗口：把\n        // 打开推迟 250ms（早过双击判定）仍然复现。选区由浏览器在 showModal() 调用\n        // 内部生成：脚本没有任何 Selection API 调用，在 dblclick 上 preventDefault\n        // 也拦不住。\n        //\n        // 实测（Chromium）showModal() 不会动打开前已经存在的选区，所以这一次清理\n        // 同时也覆盖「先选中页面文本、再打开」的情况——modal 打开后被选中的内容挡在\n        // backdrop 后面本来也已不可用。这里只清文档选区，不动 user-select，drawer 内正文\n        // 仍可正常拖选；拖拽 handle 与 toggle 时序不受影响。\n        window.getSelection()?.removeAllRanges()\n        // presence.sync 已同步发起 showModal：此刻 dialog.open 为真，计数出正确\n        // 的层序 depth 并驱动下层缩放。直接同步 register，不等待 is-visible\n        //（那要再等一帧，且打开过渡期间上层关系已应确立）。\n        this._nestedLayers.register()\n        // 原生 dialog 登记为开启态 overlay：挂在它上面的 portal panel 在逻辑组合树上\n        // 成为本层后代，Escape 仲裁据此判出最内层（issue #120 Block 1）。\n        const dialog = this.dialog\n        if (dialog) {\n          // 同一 panel 重新 claim = 新的一次开启：旧会话（含其子层）整体作废。\n          this._handle?.release()\n          this._handle = this._overlay.claim(dialog, { ancestryFrom: this })\n          this._syncDragInert()\n        }\n      } else {\n        this._nestedLayers.unregister()\n        this._handle?.release()\n        this._handle = null\n      }\n    }\n    if (props.has('open') || props.has('noScrollLock')) this._syncScrollLock()\n    // pageShift 与 open 同一条同步：打开期间关掉该属性要立刻把已经让开的页面收回来，\n    // 只盯 open 会留下一层没人负责的位移。\n    if (props.has('open') || props.has('pageShift')) this._syncPageShift()\n  }\n\n  private handleTransitionEnd(e: TransitionEvent) {\n    // transitionend 会从后代元素冒泡上来（slotted 消费者内容、嵌套子 drawer）。\n    // 只处理 dialog 自身的事件：presence 与收尾都只认本层 dialog 的过渡，\n    // 后代一条 transform 过渡结束不能提前终结本层收尾（与 presence 内部守卫同规则）。\n    if (e.target !== e.currentTarget) return\n    this._presence.handleTransitionEnd(e)\n\n    // 收尾过渡结束：::backdrop 的 opacity 过渡 target 也是 dialog（带 pseudoElement），\n    // 因此再按 propertyName 只认 transform。\n    if (e.propertyName === 'transform') this._finishSettle()\n  }\n\n  private _isNestedDialogEvent(e: KeyboardEvent): boolean {\n    const path = e.composedPath()\n    const ownDialogIndex = path.indexOf(e.currentTarget as Node)\n    return ownDialogIndex > 0 && path.slice(0, ownDialogIndex).some(node => node instanceof HTMLDialogElement)\n  }\n\n  private handleKeydown(e: KeyboardEvent) {\n    if (e.key === 'Tab') {\n      if (e.defaultPrevented || this._isNestedDialogEvent(e)) return\n      const dialog = this.dialog\n      if (dialog) trapTabKey(e, dialog)\n      return\n    }\n    if (e.key !== 'Escape') return\n    /*\n     * Escape 的归属由共享仲裁者在 document 捕获阶段判定（issue #120 Block 1）；命中后\n     * 它会 stopPropagation，本 handler 不再执行。此处保留两条兜底：\n     * ① defaultPrevented 说明仲裁者已介入，不再重复关闭；\n     * ② 兜底路径仍按原逻辑处理，避免「panel 未登记」时 Escape 失灵。\n     *\n     * 本 handler **不是**可随手删掉的：仲裁者挂在 document 上，只对能跨 shadow\n     * 边界的事件生效。实测（overlay-open-owner-260918，2026-09-18）摘掉 `@keydown` 后\n     * layout.browser.spec.ts 的两例 Escape 用例立刻转红——它们派发的 keydown 没有\n     * `composed: true`，事件止步于 shadow root，到不了 document。\n     */\n    if (e.defaultPrevented) return\n    /*\n     * nested 场景防连锁：子 drawer 的 dialog 经 slot 投影在本层 shadow 内，其\n     * keydown composed 冒泡路径会再次经过本层 dialog（事件路径含 slot 宿主链）。\n     * 若事件传播路径在本层 dialog 之前已存在其他 <dialog>，说明该事件来自子层，本层忽略。\n     */\n    if (this._isNestedDialogEvent(e)) return\n    // 拖拽进行中忽略 ESC，避免手势与关闭管线竞争。\n    if (this._isDragging()) {\n      e.preventDefault()\n      return\n    }\n    e.preventDefault()\n    this._closeFromUser()\n  }\n\n  show() {\n    if (this.open) return\n    this.open = true\n  }\n\n  close() {\n    if (!this.open) return\n    this.open = false\n  }\n\n  private readonly _closeFromUser = () => {\n    if (!this.open) return\n    // controlled 悬停等待回写期间，关闭意图已在途（open-change 已派发）：\n    // Escape/backdrop/关闭 button 的重复触发不再派发第二次请求，也不与超时弹回竞争。\n    if (this._dragAwaitWriteback) return\n    if (this.controlled) {\n      this.emitOpenChange(false)\n      return\n    }\n\n    this._userOpenChange.mark()\n    this.close()\n  }\n\n  /*\n   * 仲裁者在 capture 阶段 preventDefault 了 Escape 的 keydown，UA 因此不再派发原生\n   * cancel，但本 handler 仍是「原生 cancel 到达时也要走完整关闭管线」的契约入口，\n   * **不可删**。实测（overlay-open-owner-260918，2026-09-18）摘掉 `@cancel` 后\n   * drawer.spec.ts 的「no-backdrop-close 存在时 cancel 仍通过关闭过渡退出」与\n   * remount-reconcile 的「打开态被移出文档再接回」两例立刻转红。\n   */\n  private handleCancel(e: Event) {\n    // 保留 top layer 直到 CSS 过渡结束，避免原生关闭跳过退出动画。\n    e.preventDefault()\n    this._closeFromUser()\n  }\n\n  private handleNativeClose() {\n    // 关闭态下的 close 事件只可能是我们自己 finishClosing 排队的异步事件（或冗余的\n    // 外部关闭）：交给 presence 消费 self-close 标志，避免标志泄漏到下一次真实关闭。\n    if (!this.open) {\n      this._presence.handleNativeClose()\n      return\n    }\n\n    // 我们自己 dialog.close() 排队的 close 事件是异步任务：正常时序在本关闭会话内\n    // 到达，快速「关闭→重开」时它在重新打开之后才到达（过期事件）。两种情况都已在\n    // finishClosing 完成全部清理，由 presence 消费并返回 true，不能当成外部关闭把\n    // 刚重开的 dialog 关掉——否则重开即被误关，表现为连续 toggle 丢失过渡动画。\n    if (this._presence.handleNativeClose()) return\n\n    // 悬停等待期间的原生关闭（如表单 method=\"dialog\"）：视为回写窗口内的重复\n    // 关闭意图，取消等待不补发请求；已原生关闭的 dialog 不再被超时弹回拉起。\n    if (this._dragAwaitWriteback) {\n      this._cancelDragAwait()\n      return\n    }\n\n    // 原生关闭可绕过 cancel；controlled 时恢复受控状态，由 Consumer 决定是否关闭。\n    if (this.controlled) {\n      this._presence.sync(true)\n      this.emitOpenChange(false)\n      return\n    }\n\n    this._userOpenChange.mark()\n    this.open = false\n  }\n\n  /*\n   * backdrop 点击（backdrop click）的按-放链路回溯。\n   *\n   * 浏览器对「按下 → 拖动 → 松手」生成的 click 落在起点与松手点 DOM 的**共同祖先**\n   * 上：从 panel 内容、拖拽 drag zone 甚至 backdrop 本处开始拖拽、松手落在 backdrop 上时，click 的\n   * target 都是 dialog，与真正的轻点 backdrop 从 click 自身无法区分（真实鼠标/触摸下\n   * 必现的误关路径，合成事件不派发 click 故自动化易漏测）。因此在 dialog 的\n   * pointerdown 记录按下起点与是否落在 backdrop 上，click 时回溯校验：\n   * - 按下起点不在 backdrop 上（从 panel 内容/drag zone 开始的链路）→ 不是点 backdrop，忽略；\n   * - 按下到松手位移超过轻点量级 → 是拖拽松手而非点击，忽略；\n   * 两者都通过才沿用「点 backdrop 关闭」语义。\n   */\n  private _backdropPress: { onMask: boolean; x: number; y: number } | null = null\n\n  private handleDialogPointerDown(e: PointerEvent) {\n    this._backdropPress = { onMask: e.target === e.currentTarget, x: e.clientX, y: e.clientY }\n  }\n\n  private handleBackdropClick(e: MouseEvent) {\n    if (e.target !== (e.currentTarget as HTMLDialogElement)) return\n    if (this.noBackdropClose) return\n    // 拖拽进行中 pointer capture 使 click 落在 dialog 上，忽略以避免与手势竞争。\n    if (this._isDragging()) return\n    // detail 为 0 表示这次 click 不来自指针（键盘激活、程序化 .click()）：\n    // pointerdown 记录可能是上一次指针交互的残留，不能据此判定 backdrop 点击\n    //（对齐 image-preview 的既有守卫）。\n    if (e.detail === 0) return\n    const press = this._backdropPress\n    this._backdropPress = null\n    if (!press || !press.onMask) return\n    if (Math.hypot(e.clientX - press.x, e.clientY - press.y) > BACKDROP_TAP_DISTANCE) return\n    this._closeFromUser()\n  }\n\n  private emitOpenChange(open = this.open) {\n    dispatchOpenChangeEvent(this, open)\n  }\n\n  private _syncScrollLock(isOpen = this.open) {\n    this._scrollLock.sync(isOpen && !this.noScrollLock)\n  }\n\n  /*\n   * 整页让开只跟 open 与该属性的开关走，不跟拖拽走：拖动 panel 时页面停在原地。\n   * 手势要的是「panel 跟手」，页面若按同一增量跟着滑，drawer 相对视口的位置反而没变，\n   * 跟手感被抵消掉一半；退场后回到哪个深度由栈决定，与拖了多少无关。\n   *\n   * 分支条件带 pageShift：只看 open 的话，打开期间关掉该属性走的是 push()（内部按开关\n   * 直接返回），已经让开的页面没人收回。pop() 对没进过栈的宿主是无操作，所以这里\n   * 可以无条件调用。\n   */\n  private _syncPageShift() {\n    if (this.open && this.pageShift) this._pageShift.push()\n    else this._pageShift.pop()\n  }\n\n  override render() {\n    const showHeader = this._hasHeaderSlot || !!this.heading\n    const dialogLabel = this.ariaDialogLabel.trim()\n    const dialogLabelledBy = !dialogLabel && !this.headless && showHeader ? 'wui-drawer-heading' : nothing\n\n    // 拖拽 drag zone：仅在打开且 draggable 时渲染；胶囊 + 加宽命中条贴在 drawer 内缘。\n    // 胶囊是 drag zone 的**兄弟节点**而非后代：drag zone 要让开 header / footer（见 style.css），\n    // 胶囊作为后代会连带继承那份让位量，被一起推离 panel 边缘。两者都是 dialog 的直接子节点，\n    // 胶囊因此相对 dialog 定位、恒贴可抓取边缘，drag zone 则继续为端头上的 button 让位。\n    //\n    // 端头 drag edge 补上解耦留下的空档：胶囊贴回边缘后就不再落在 drag zone 的让开区里\n    // （bottom + header 实测胶囊带 [8,12]、drag zone 带 [60,80]），那一段若没有命中层，\n    // 胶囊就成了一条按不下去、悬停不亮的死装饰——R1 与 R3 在几何上本就不可同满足，\n    // 结构解耦只让两者不再互相位移，命中层必须另给。drag edge 只在上下 placement 渲染：\n    // 左右两条的胶囊本就落在 drag zone 内，多一个元素只会让 R5「左右几何不变」需要额外论证。\n    //\n    // 顺序要紧：胶囊排最后，两条 drag zone（边、区）都在它前面，hover / active / 确认态三条规则\n    // 因此靠通用兄弟选择器 `~` 挂上去。写成相邻兄弟 `+` 的话 drag edge 那条会静默失效。\n    const needsEdgeBand = this.placement === 'top' || this.placement === 'bottom'\n    const dragBar = this.draggable\n      ? html`\n          ${\n            needsEdgeBand\n              ? html`<div class=\"wui-drawer-drag-edge\" @pointerdown=${this._handleDragPointerDown}></div>`\n              : nothing\n          }\n          <div class=\"wui-drawer-drag-zone\" @pointerdown=${this._handleDragPointerDown}></div>\n          <div class=\"wui-drawer-drag-bar\"></div>\n        `\n      : nothing\n\n    // 保持同一个 dialog 实例，避免打开期间切换 headless 时脱离 top layer。\n    return html`\n      <dialog\n        aria-label=${dialogLabel || nothing}\n        aria-labelledby=${dialogLabelledBy}\n        @cancel=${this.handleCancel}\n        @close=${this.handleNativeClose}\n        @click=${this.handleBackdropClick}\n        @pointerdown=${this.handleDialogPointerDown}\n        @keydown=${this.handleKeydown}\n        @transitionend=${this.handleTransitionEnd}\n      >\n        ${\n          this.headless\n            ? html`<slot></slot>${dragBar}`\n            : html`\n                <div class=\"wui-drawer-body wui-glass\">\n                  <div\n                    class=\"wui-drawer-header\"\n                    id=\"wui-drawer-heading\"\n                    ?hidden=${!showHeader}\n                    @pointerdown=${this._handleSectionDragPointerDown}\n                  >\n                    <slot name=\"header\" @slotchange=${this.handleHeaderSlotChange}>\n                      ${this.heading ? html`<span class=\"wui-drawer-heading\">${this.heading}</span>` : nothing}\n                    </slot>\n                  </div>\n                  <div class=\"wui-drawer-content wui-scroll\">\n                    <slot></slot>\n                  </div>\n                  <div\n                    class=\"wui-drawer-footer\"\n                    ?hidden=${!this._hasFooterSlot}\n                    @pointerdown=${this._handleSectionDragPointerDown}\n                  >\n                    <slot name=\"footer\" @slotchange=${this.handleFooterSlotChange}></slot>\n                  </div>\n                </div>\n                ${\n                  this.closable\n                    ? html`\n                        <web-ui-button\n                          class=\"wui-drawer-close\"\n                          @click=${this._closeFromUser}\n                          aria-label=${resolveBuiltinLabel('close', this.ariaCloseLabel)}\n                          variant=\"secondary\"\n                          icon\n                          size=\"26\"\n                        >\n                          <web-ui-icon size=\"14\" .icon=${oouiClose}></web-ui-icon>\n                        </web-ui-button>\n                      `\n                    : nothing\n                }\n                ${dragBar}\n              `\n        }\n      </dialog>\n    `\n  }\n\n  declare readonly $events: {\n    'open-change': CustomEvent<{ open: boolean }>\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'web-ui-drawer': WebUiDrawer\n  }\n}\n"],"mappings":"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"}

package/dist/components/drawer/page-shift.js

@@ -0,0 +1,113 @@
+import { prefersReducedMotion } from "../../shared/theme/reduced-motion.js";
+import { definePlugin } from "@greypan/js-kit";
+// src/components/drawer/page-shift.ts
+const ENTER_DURATION_VARIABLE = "--wui-duration-drawer-enter";
+const EXIT_DURATION_VARIABLE = "--wui-duration-drawer-exit";
+const ENTER_DURATION_FALLBACK = 280;
+const EXIT_DURATION_FALLBACK = 240;
+const EASE_VARIABLE = "--wui-ease-enter";
+const EASE_FALLBACK = "cubic-bezier(0.23, 1, 0.32, 1)";
+const EASE_PATTERN = /^(linear|ease(-in|-out)?|step-(start|end))$|^(cubic-bezier|steps)\(/;
+const PAGE_SHIFT_ANIMATION_ID = "wui-drawer-page-shift";
+/** 第 1 层让开 16 个轴单位 a。 */
+const PAGE_SHIFT_BASE = 16;
+/** 每多打开一层，这一层的让开量减半。 */
+const PAGE_SHIFT_DECAY = .5;
+const stack = [];
+let takeover = null;
+function readDuration(host, property, fallback) {
+	const raw = getComputedStyle(host).getPropertyValue(property).trim();
+	const value = Number.parseFloat(raw);
+	if (!Number.isFinite(value)) return fallback;
+	return raw.endsWith("ms") ? value : value * 1e3;
+}
+function readEase(host) {
+	const raw = getComputedStyle(host).getPropertyValue(EASE_VARIABLE).trim();
+	return EASE_PATTERN.test(raw) ? raw : EASE_FALLBACK;
+}
+function restingTranslate() {
+	let x = 0;
+	let y = 0;
+	for (let depth = 0; depth < stack.length; depth += 1) {
+		const entry = stack[depth];
+		const shift = PAGE_SHIFT_BASE * PAGE_SHIFT_DECAY ** depth * entry.getSign();
+		if (entry.getAxis() === "x") x += shift;
+		else y += shift;
+	}
+	return `${x}vw ${y}vh`;
+}
+function indexOfHost(host) {
+	return stack.findIndex((entry) => entry.host === host);
+}
+function applyPage(host, motion) {
+	const root = document.documentElement;
+	const target = stack.length > 0 ? restingTranslate() : takeover?.neutral ?? "none";
+	if (stack.length > 0 && root.style.translate === target) return;
+	const previous = getComputedStyle(root).translate;
+	if (stack.length > 0) root.style.translate = target;
+	else if (takeover) {
+		root.style.translate = takeover.inline;
+		takeover = null;
+	}
+	for (const animation of root.getAnimations()) if (animation.id === PAGE_SHIFT_ANIMATION_ID) animation.cancel();
+	if (motion === "instant" || previous === target) return;
+	const duration = readDuration(host, motion === "enter" ? ENTER_DURATION_VARIABLE : EXIT_DURATION_VARIABLE, motion === "enter" ? ENTER_DURATION_FALLBACK : EXIT_DURATION_FALLBACK);
+	if (duration <= 0) return;
+	const animation = root.animate([{ translate: previous }, { translate: target }], {
+		duration,
+		easing: readEase(host)
+	});
+	animation.id = PAGE_SHIFT_ANIMATION_ID;
+}
+const definePageShift = () => definePlugin((ctx) => {
+	const detach = () => {
+		const host = ctx.getHost();
+		if (!host) return false;
+		const index = indexOfHost(host);
+		if (index < 0) return false;
+		stack.splice(index, 1);
+		return true;
+	};
+	return {
+		push() {
+			const host = ctx.getHost();
+			if (!host || !ctx.isEnabled() || prefersReducedMotion(host)) return;
+			const index = indexOfHost(host);
+			if (index >= 0) {
+				stack[index] = {
+					host,
+					getAxis: () => ctx.getAxis(),
+					getSign: () => ctx.getSign()
+				};
+				applyPage(host, "enter");
+				return;
+			}
+			if (stack.length === 0 && !takeover) {
+				const root = document.documentElement;
+				takeover = {
+					inline: root.style.translate,
+					neutral: getComputedStyle(root).translate
+				};
+			}
+			stack.push({
+				host,
+				getAxis: () => ctx.getAxis(),
+				getSign: () => ctx.getSign()
+			});
+			applyPage(host, "enter");
+		},
+		pop() {
+			const host = ctx.getHost();
+			if (!host || !detach()) return;
+			applyPage(host, "exit");
+		},
+		dispose() {
+			const host = ctx.getHost();
+			if (!host || !detach()) return;
+			applyPage(host, "instant");
+		}
+	};
+});
+export { definePageShift };
+
+//# sourceMappingURL=page-shift.js.map

package/dist/components/drawer/page-shift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-shift.js","names":[],"sources":["../../../src/components/drawer/page-shift.ts"],"sourcesContent":["/*\n * drawer 打开时整页让开（iOS push 式）。\n *\n * 「让开」的方向 = drawer 闭合方向的反向：右侧 drawer 从右进场并把页面往左推，视口\n * 右缘因此空出一条给 drawer，页面左缘同步滑出屏幕。轴向与符号都由 drawer 给出\n * （取自 `_dragAxis` / `_dragCloseSign`），两处共用同一张符号表，placement 加一挡不会分叉。\n *\n * 落点是 documentElement，这是选择而非实现细节：整页只有那一个盒子，消费方零配置。\n * 代价与实测结论都在 drawer 示例文档（`docs/drawer.md` / `docs/drawer.CN.md`）的\n * page-shift 小节里（fixed 内容跟着走、top layer 的 dialog 不受影响）。\n *\n * 写在独立属性 `translate` 而不是 `transform` 上：`transform` 让给 shake 的 WAAPI 关键帧，\n * 两者天然复合而非互相覆写（实测内联 `translate: -24px 0px` 叠加进行中的\n * `transform: translate(-5.97px, 0px)` 得到 -29.97px，纵向那条轴同样相加）。drawer 自己的\n * nested 层叠也是同一套独立属性。\n *\n * 让开量由内部公式给出，不暴露可调 token：1 个轴单位 a 在 left/right 上是 `1vw`、在\n * top/bottom 上是 `1vh`；按打开顺序，第 1 层让开 16a，之后每层减半（16a、8a、4a、2a……）。\n * 位移以 `vw` / `vh` 写进 documentElement，转屏或地址栏收起时由浏览器跟着重算，页面\n * 不必自己再跑一遍；关闭中间层后，剩余层按新的打开顺序重新分配系数。等比和收敛到 32a，\n * 不会超过。\n *\n * 静止态与动效分家：\n * - 静止态 = documentElement 的内联 translate，drawer 打开期间一直保留，因此重挂载、\n *   脚本读取都只看这一处；\n * - 动效 = WAAPI，起点取当前计算值、终点写死成同一个静止值，fill 用默认 `none`。\n *   动画期间关键帧压过内联（动画 origin 优先级更高），结束后内联接管且两者同值，\n *   所以不存在 JS→CSS 交接跳变。drawer 里那条「收尾不用 WAAPI」的理由（要从手指所在的\n *   当前值起步、并把 before-change style 交给 CSS 过渡）在这里不成立：本模块没有中途\n *   抓取，两个端点都由自己给出。\n * - 最后一层释放时终点用**接管前测得的计算值**而不是 `none`：消费方样式若给 html 写过\n *   translate，还原内联后算出来的就是那个值，动画终值必须与它一致，否则收尾瞬间会跳。\n *\n * 进行中的动画靠 id 认领并在每次同步前取消，模块因此不持有 Animation 引用；\n * 与 shake 的重新触发同一做法。\n *\n * 多层同时开启 page-shift（嵌套或同级）时逐层累加：每打开一层，页面在原来的方向上再让开\n * 这一层的量；关闭任意一层后剩余层重排，页面回落到按新顺序算出的和。\n *\n * reduce 下整套不生效，连静止位移也不写：drawer 自己的 CSS 在 reduce 下把 panel 的\n * transform/translate/scale 全部归零，页面单独滑出去会读成一个缺陷。\n */\n\nimport { definePlugin } from '@greypan/js-kit'\n\nimport { prefersReducedMotion } from '@/shared/theme/reduced-motion'\n\nconst ENTER_DURATION_VARIABLE = '--wui-duration-drawer-enter'\nconst EXIT_DURATION_VARIABLE = '--wui-duration-drawer-exit'\n// 与 drawer/style.css 里 `var(--wui-duration-drawer-*, <fallback>)` 的同一条兜底。\nconst ENTER_DURATION_FALLBACK = 280\nconst EXIT_DURATION_FALLBACK = 240\nconst EASE_VARIABLE = '--wui-ease-enter'\nconst EASE_FALLBACK = 'cubic-bezier(0.23, 1, 0.32, 1)'\n// 合法 easing 的形状：关键字，或 cubic-bezier() / steps() 函数式。\nconst EASE_PATTERN = /^(linear|ease(-in|-out)?|step-(start|end))$|^(cubic-bezier|steps)\\(/\n\nconst PAGE_SHIFT_ANIMATION_ID = 'wui-drawer-page-shift'\n\n/** 第 1 层让开 16 个轴单位 a。 */\nconst PAGE_SHIFT_BASE = 16\n/** 每多打开一层，这一层的让开量减半。 */\nconst PAGE_SHIFT_DECAY = 0.5\n\ntype PageShiftAxis = 'x' | 'y'\n/** `'enter'` 用进场时长，`'exit'` 用退场时长，`'instant'` 不动画（断连时页面归位）。 */\ntype PageShiftMotion = 'enter' | 'exit' | 'instant'\n\ninterface PageShiftEntry {\n  host: HTMLElement\n  getAxis: () => PageShiftAxis\n  getSign: () => number\n}\n\nconst stack: PageShiftEntry[] = []\n/*\n * 接管前的页面状态，只在栈由空变非空那一次采样：\n * - `inline` 是 html 上原有的内联值，最后一层释放时原样写回（空串即 removeProperty）；\n * - `neutral` 是当时的计算值，用作最后一层的动画终值。\n */\nlet takeover: { inline: string; neutral: string } | null = null\n\n/*\n * 时长 token 没有注册，computed style 给的是变量替换后的字面量（主题里是 `280ms`）。\n * 万一它被注册成 <time>，序列化为规范单位秒（`0.28s`），parseFloat 只取数字会丢单位，\n * 所以按后缀补一次换算：两种写法读出来是同一个毫秒数。\n */\nfunction readDuration(host: HTMLElement, property: string, fallback: number): number {\n  const raw = getComputedStyle(host).getPropertyValue(property).trim()\n  const value = Number.parseFloat(raw)\n  if (!Number.isFinite(value)) return fallback\n  return raw.endsWith('ms') ? value : value * 1000\n}\n\n/*\n * CSS 侧一条无效的 easing 声明会被直接忽略，WAAPI 却对非法 easing 抛 TypeError。\n * 这里只接受关键字与 cubic-bezier()/steps() 两种形状，其余退回与 style.css 相同的默认曲线。\n */\nfunction readEase(host: HTMLElement): string {\n  const raw = getComputedStyle(host).getPropertyValue(EASE_VARIABLE).trim()\n  return EASE_PATTERN.test(raw) ? raw : EASE_FALLBACK\n}\n\n/*\n * 总让开量：按打开顺序，第 n 层贡献 16a / 2^(n-1)，横轴累加到 vw、纵轴累加到 vh。\n * 关闭中间层后剩余层重新排名，系数随之重算；没有新的开合时页面不动。\n * 等比和收敛到 32a，单轴只取这个级数的一个子集，同样到不了 32a。\n */\nfunction restingTranslate(): string {\n  let x = 0\n  let y = 0\n  for (let depth = 0; depth < stack.length; depth += 1) {\n    const entry = stack[depth]\n    const shift = PAGE_SHIFT_BASE * PAGE_SHIFT_DECAY ** depth * entry.getSign()\n    if (entry.getAxis() === 'x') x += shift\n    else y += shift\n  }\n  return `${x}vw ${y}vh`\n}\n\nfunction indexOfHost(host: HTMLElement): number {\n  return stack.findIndex(entry => entry.host === host)\n}\n\nfunction applyPage(host: HTMLElement, motion: PageShiftMotion) {\n  const root = document.documentElement\n  const target = stack.length > 0 ? restingTranslate() : (takeover?.neutral ?? 'none')\n  /*\n   * 同一层重复 push 的落点与内联值相同：此时不重启动画，否则会从当前值再跑一遍完整时长。\n   * 内联值是视口单位，视口变化时浏览器自己重算，所以这里比较的仍是「公式是否变了」。\n   */\n  if (stack.length > 0 && root.style.translate === target) return\n  // 起点读当前计算值：上一段动画还在跑、或重挂载时页面已在位移位，都不能跳。\n  const previous = getComputedStyle(root).translate\n\n  if (stack.length > 0) root.style.translate = target\n  else if (takeover) {\n    root.style.translate = takeover.inline\n    takeover = null\n  }\n\n  for (const animation of root.getAnimations()) {\n    if (animation.id === PAGE_SHIFT_ANIMATION_ID) animation.cancel()\n  }\n  if (motion === 'instant' || previous === target) return\n\n  const duration = readDuration(\n    host,\n    motion === 'enter' ? ENTER_DURATION_VARIABLE : EXIT_DURATION_VARIABLE,\n    motion === 'enter' ? ENTER_DURATION_FALLBACK : EXIT_DURATION_FALLBACK\n  )\n  if (duration <= 0) return\n\n  const animation = root.animate([{ translate: previous }, { translate: target }], { duration, easing: readEase(host) })\n  animation.id = PAGE_SHIFT_ANIMATION_ID\n}\n\nexport interface PageShiftOptions {\n  /** 读时长、缓动与 reduce 档位的那个元素（drawer 宿主）。 */\n  getHost(): HTMLElement | null\n  /** 消费方是否开启了整页让开。关闭时 push 直接跳过，pop 仍会把已登记的一层摘掉。 */\n  isEnabled(): boolean\n  getAxis(): PageShiftAxis\n  getSign(): number\n}\n\nexport interface PageShiftApi {\n  /** 进入开启态：把本层计入总让开量并播这一段动画。同一宿主重复调用是幂等的。 */\n  push(): void\n  /** 退出开启态：摘掉本层，页面回到剩余层之和或原位。未登记时不动页面。 */\n  pop(): void\n  /** 断连：摘掉本层并立即归位，不补一段退场动画。 */\n  dispose(): void\n}\n\nexport const definePageShift = () =>\n  definePlugin<PageShiftApi, PageShiftOptions>(ctx => {\n    const detach = (): boolean => {\n      const host = ctx.getHost()\n      if (!host) return false\n      const index = indexOfHost(host)\n      if (index < 0) return false\n      stack.splice(index, 1)\n      return true\n    }\n\n    return {\n      push() {\n        const host = ctx.getHost()\n        if (!host || !ctx.isEnabled() || prefersReducedMotion(host)) return\n        // 幂等：重挂载对账与 updated() 的 open 分支可能对同一宿主各调一次。\n        // 已在栈里时原位更新，保留它原有的排名——重新追加会把它顶到最后一层、拿走别人的系数。\n        const index = indexOfHost(host)\n        if (index >= 0) {\n          stack[index] = { host, getAxis: () => ctx.getAxis(), getSign: () => ctx.getSign() }\n          applyPage(host, 'enter')\n          return\n        }\n        if (stack.length === 0 && !takeover) {\n          const root = document.documentElement\n          takeover = { inline: root.style.translate, neutral: getComputedStyle(root).translate }\n        }\n        stack.push({ host, getAxis: () => ctx.getAxis(), getSign: () => ctx.getSign() })\n        applyPage(host, 'enter')\n      },\n\n      pop() {\n        const host = ctx.getHost()\n        if (!host || !detach()) return\n        applyPage(host, 'exit')\n      },\n\n      dispose() {\n        const host = ctx.getHost()\n        if (!host || !detach()) return\n        applyPage(host, 'instant')\n      }\n    }\n  })\n"],"mappings":"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"}

package/dist/components/grouped-text/grouping.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 「组块」的切分：决定组间间隙落在原文的哪些位置，不改变文本本身。
+ *
+ * 切分结果首尾相接、拼回去恰好等于原串——组与组之间不含任何补位字符。这不是洁癖：复制路径读的是
+ * 文本节点的 data，分隔符一旦进了文本节点，复制、页内查找、双击选词三件事同时坏掉。间隙因此只能
+ * 是布局（挂在每组末位簇自己的字距上），不能是字符。实测边界见
+ * docs/research/web-ui-grouped-text-261102.md。
+ *
+ * 切点一律落在字素簇边界上，与 `web-ui-middle-ellipsis` 同一个口径：按 UTF-16 下标切会把代理对与
+ * ZWJ 序列从中间劈开，屏幕上出现半个 emoji 比「这一组少一位」严重得多。
+ */
+/** 预设组形。 */
+export type GroupedTextPreset = 'card' | 'phone' | 'amount';
+/** 组形：预设名，或逐组的字素簇数（如 `[4, 4, 4, 4]`）。 */
+export type GroupedTextGroups = GroupedTextPreset | readonly number[];
+/**
+ * 组形的**写入**形态：预设名与位数表都落到 `string`，逐组位数保持 `readonly number[]`。
+ *
+ * 它比 `GroupedTextGroups` 宽一档，是因为 attribute 与 property 两条通道必须给出同一个组形：Vue 这类
+ * 框架发现 `'groups' in el` 成立就直接赋 property，Lit 的 `fromAttribute` 转换器一次都不会跑。字符串
+ * 只走 attribute 那条路的话，模板里写 `groups="4,4,4,4"` 传进来的就是原样字符串，位数表读不出来。
+ * 收到的值统一由 `resolveGroups` 收成 `GroupedTextGroups`。
+ */
+export type GroupedTextGroupsInput = string | readonly number[];
+//# sourceMappingURL=grouping.d.ts.map

package/dist/components/grouped-text/grouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouping.d.ts","names":[],"sources":["../../../src/components/grouped-text/grouping.ts"],"mappings":";;;;;;;;;;;;YAeY;;YAGA,oBAAoB;;;;;;;;;YAUpB"}