@greypan/web-ui 10.2.1 → 11.1.0

package/dist/components/editable-text/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/editable-text/index.ts"],"sourcesContent":["import { html, LitElement, unsafeCSS } from 'lit'\nimport { customElement, property, query, state } from 'lit/decorators.js'\nimport { classMap } from 'lit/directives/class-map.js'\nimport { ifDefined } from 'lit/directives/if-defined.js'\n\nimport { FormAssociated, defineFormAssociation, FormAssociationController } from '@/shared/form-association'\nimport { createFieldId } from '@/shared/form-association/field-id'\n\nimport style from './style.css?inline'\n\n/** 空值且无 placeholder 时占位，保留一个行盒，避免宿主退化成 0 高度、无法点击进入编辑。 */\nconst BLANK_GLYPH = '\\u200B'\n\n/** 行/字符落点二分的容差（px），吸收次像素与舍入差异。 */\nconst CARET_TOLERANCE = 1\n\n/**\n * 取文本层承载文案的 Text 节点。\n *\n * 绑定表达式位于元素首个位置时，Lit 会在它前面留一个注释标记节点，因此不能用\n * `firstChild`：那会拿到没有布局的注释，Range 量不到任何矩形。\n */\nfunction textNodeOf(layer: HTMLElement): Text | null {\n  for (const child of layer.childNodes) {\n    if (child instanceof Text) return child\n  }\n  return null\n}\n\n/**\n * 把视口坐标映射为文本层的字符偏移。\n *\n * `document.caretPositionFromPoint` 不进入 shadow DOM（对 shadow 内容返回 shadow host\n * 之外的节点），因此在文本层上用 Range 空矩形二分：先按 y 选行，再在行内按 x 选字符。\n * 文本层与编辑层同盒同排版，偏移与 textarea 的 selectionStart 一一对应。\n */\nfunction caretOffsetFromPoint(textLayer: HTMLElement, x: number, y: number): number {\n  const node = textNodeOf(textLayer)\n  if (!node) return 0\n  const length = node.data.length\n  const range = document.createRange()\n  const rectAt = (offset: number): DOMRect => {\n    range.setStart(node, offset)\n    range.setEnd(node, offset)\n    return range.getBoundingClientRect()\n  }\n\n  // 同一行的盒可能被拆成多个 client rect；按 top 去重得到行列表，取与 y 最近的一行，\n  // 距离相等时取更靠下的一行（与浏览器在行间的落点行为一致）。\n  const lines: DOMRect[] = []\n  for (const rect of textLayer.getClientRects()) {\n    if (!lines.some(line => Math.abs(line.top - rect.top) <= CARET_TOLERANCE)) lines.push(rect)\n  }\n  if (lines.length === 0) return length\n  let line = lines[0]\n  let nearest = Infinity\n  for (const candidate of lines) {\n    const distance = Math.abs((candidate.top + candidate.bottom) / 2 - y)\n    if (distance <= nearest) {\n      nearest = distance\n      line = candidate\n    }\n  }\n\n  // 行首：caret top 首次落入本行的最小偏移\n  let lo = 0\n  let hi = length\n  while (lo < hi) {\n    const mid = (lo + hi) >> 1\n    if (rectAt(mid).top >= line.top - CARET_TOLERANCE) hi = mid\n    else lo = mid + 1\n  }\n  const lineStart = lo\n  // 行尾：caret top 仍落在本行的最大偏移\n  lo = lineStart\n  hi = length\n  while (lo < hi) {\n    const mid = (lo + hi + 1) >> 1\n    if (rectAt(mid).top <= line.top + CARET_TOLERANCE) lo = mid\n    else hi = mid - 1\n  }\n  const lineEnd = Math.max(lo, lineStart)\n  // 行内：caret left 不超过 x 的最大偏移\n  lo = lineStart\n  hi = lineEnd\n  while (lo < hi) {\n    const mid = (lo + hi + 1) >> 1\n    if (rectAt(mid).left <= x + CARET_TOLERANCE) lo = mid\n    else hi = mid - 1\n  }\n  return lo\n}\n\n@customElement('web-ui-editable-text')\nexport class WebUiEditableText extends FormAssociated(LitElement) {\n  static override styles = [unsafeCSS(style)]\n\n  @property({ type: String, reflect: true }) name = ''\n  @property({ type: String, reflect: true }) placeholder = ''\n  @property({ type: Boolean, reflect: true }) disabled = false\n  @property({ type: Boolean, reflect: true }) readonly = false\n\n  /**\n   * 卸载时按提交语义结束编辑，默认 false。\n   *\n   * 跨引擎实测（Chromium 与 WebKit 各一轮）结论**不一致**，这是本属性的主要价值来源：\n   *\n   * - Chromium：移除正在编辑的组件会向编辑层派发 `blur`，默认行为下 `change` 已照常派发\n   *   一次，草稿不丢。blur 与 change 同步排在 `disconnectedCallback` 之后（后者在\n   *   disconnected 步骤内跑完），卸载因此没拿到一条「排在该消费方状态更新之前」的提交来源。\n   * - WebKit（Safari / iOS）：移除**不派发 blur**，默认路径什么都不提交，草稿随组件一起丢弃。\n   *   这里 blur 兜底不存在，只有显式开启本属性才能保住草稿。\n   * - Gecko（Firefox）**未验证**：实测所用机器上没有任何 Firefox 能启动，这里不做断言。把它当作\n   *   未知，而不是默认与上面两者之一相同。\n   *\n   * 所以在 Safari 上这不是可选优化而是必需的：默认值 `false` 对 Safari 用户等于没有兜底，\n   * 消费方若依赖「行被回收时草稿不丢」，在 Safari 上必须显式开启本属性。\n   *\n   * 开启后由 `disconnectedCallback` 复用 `_commitEditing`，与 `Enter`／`blur` 是同一份实现，\n   * 卸载不是第三条独立的提交语义。副作用与 `blur` 提交一致：草稿成为新值、退出编辑、\n   * 派发一次 `change`（冒泡且组合）。两处与 `blur` 刻意不同：\n   *\n   * 1. 提交判据——`Enter` 与 `blur` 由用户动作触发，一律算提交意图；卸载没有这种意图，\n   *    因此只在草稿与进入编辑时的值确实不同时才提交，不产生空提交。\n   * 2. 禁用与只读态——`disabled` / `readonly` 时与 `_onBlur` 一致：不派发提交事件。两者对「已有\n   *    草稿」的后果不同，必须分开说：`disabled` 下草稿保留在组件上；`readonly` 下草稿是真的\n   *    丢掉——`readonly` 阻止不了先前的输入，而卸载时不会再有 blur 兜底（WebKit 上连 blur\n   *    都没有）。可达路径是「可编辑态进入 → 起草稿 → 期间翻 readonly → 卸载」。这里不按取消\n   *    处理：cancel 的契约是恢复 `_editBase`，而卸载既没有焦点要交还也没有宿主接收结果，\n   *    改成 cancel 还会与「与 `_onBlur` 一致」这条公开承诺相悖。用户看到的是「我打的字没了」，\n   *    既没有 change 也没有 cancel。\n   *\n   * 派发发生在卸载回调内，`change` 沿组合路径向上派发，因此挂在组件自身或任一祖先上的监听\n   * 都会执行，**包括已经随宿主一起被卸载的祖先**——派发不要求祖先仍在文档中。这正是虚拟化\n   * 场景需要的：消费方的监听器往往就挂在被回收的那一行上。因此监听器不能假定组件此刻仍在\n   * 文档里；需要把结果交给宿主树之外的状态时，用 `queueMicrotask` 之类的显式转交。\n   *\n   * 祖先上的 `display: none` 不是卸载：组件仍在文档中、不派发任何事件（两引擎一致），那种\n   * 场合需要消费方主动结束编辑。\n   */\n  @property({ type: Boolean, reflect: true, attribute: 'commit-on-unmount' }) commitOnUnmount = false\n\n  @property({ type: String, attribute: 'aria-label' }) override ariaLabel: string | null = null\n\n  @state() private _value = ''\n\n  /**\n   * `value` attribute 承载 form reset 的初值，不随当前值反射；property 暴露当前值，\n   * 与原生 input 的 value / defaultValue 关系一致。\n   */\n  @property({ type: String })\n  get value(): string {\n    return this._value\n  }\n\n  set value(v: string) {\n    const old = this._value\n    this._value = v\n    this._formAssociation.sync()\n    this.requestUpdate('value', old)\n  }\n\n  @query('.editor') private _editor?: HTMLTextAreaElement\n  @query('.text') private _textLayer?: HTMLElement\n\n  private _editing = false\n  private _editBase = ''\n  private _pendingCaret: number | null = null\n  private _refocusing = false\n  private _resizeObserver: ResizeObserver | null = null\n  private readonly _fieldId = createFieldId('web-ui-editable-text')\n\n  private get _isDisabled(): boolean {\n    return this.disabled || this._formAssociation.isFormDisabled()\n  }\n\n  private readonly _formAssociation = defineFormAssociation<string>({\n    host: this,\n    getState: () => this._value,\n    setState: value => {\n      this.value = value\n    },\n    getFormValue: () => this._value,\n    getFormState: () => this._value,\n    restoreState: state => {\n      if (typeof state === 'string') this.value = state\n    }\n  }).make()\n\n  private readonly _formAssociationController = new FormAssociationController(this, this._formAssociation)\n\n  constructor() {\n    super()\n    // focus 不冒泡：宿主监听只在焦点从组件外进入时触发，shadow 内聚焦不会误触\n    this.addEventListener('focus', this._onHostFocus)\n  }\n\n  override disconnectedCallback() {\n    super.disconnectedCallback()\n    /*\n     * 卸载没有用户动作作为提交意图（`Enter` / `blur` 都有），所以判据是草稿与进入编辑时的\n     * 值是否不同，而不是「是否提交过」——Escape 会把值恢复成 `_editBase`，但那是取消，与\n     * 本次卸载无关；一个只聚焦了没打字的会话也不该在消失时凭空产生一次 change。\n     *\n     * `_isDisabled` 与 `readonly` 两道守卫都与 `_onBlur` 对称：两者都不派发提交事件。`disabled`\n     * 必须显式判——`disabled = true` 与 `remove()` 在同一任务里执行时 Lit 更新是微任务，\n     * `updated()` 还没跑到（禁用态退出编辑那条分支尚未执行），此时组件仍在编辑态，不判就会\n     * 派发一条 blur 路径明确拒绝的 change。`readonly` 不能靠「草稿恒等于基线」兜住：可编辑态\n     * 进入并起草稿之后属性才翻成 readonly 的会话，基线仍是进入编辑时的旧值，两条判据都成立\n     * 却不该提交（草稿在这次卸载中丢失，理由见 property 的 JSDoc）。\n     */\n    if (\n      this.commitOnUnmount &&\n      this._editing &&\n      !this._isDisabled &&\n      !this.readonly &&\n      this._value !== this._editBase\n    ) {\n      this._commitEditing(false)\n    }\n    this._releaseEditingKeys()\n    this._teardownAutosize()\n  }\n\n  override connectedCallback() {\n    super.connectedCallback()\n    /*\n     * autosize 的 ResizeObserver 在 disconnectedCallback 被拆掉，搭建若只放在\n     * firstUpdated（一生一次），元素断开再重连后 RO 永久丢失、autosize 静默失效。\n     * connectedCallback 每次连接都跑：_setupAutosize 自带 teardown，重复进入无副作用。\n     * 首连接时渲染尚未发生（_editor 为 null），_autosizeEditor 与 RO 回调都有判空守卫。\n     */\n    this._setupAutosize()\n    // 同类缺口：编辑态被断开时 _releaseEditingKeys 撤了 window 监听，重连后 _editing\n    // 仍为 true（blur 取消未必先于断开到达），此时补领，避免重连后按键失灵。\n    if (this._editing) this._claimEditingKeys()\n  }\n\n  override updated() {\n    // disabled 时移出 tab 序列；编辑态由 editing attribute 表达，二者互斥\n    if (this._isDisabled) this.removeAttribute('tabindex')\n    else this.setAttribute('tabindex', '0')\n    // 禁用态生效时（属性或 fieldset）退出编辑：值保持当前草稿，不派发提交事件\n    if (this._editing && this._isDisabled) this._exitEditing()\n    this._autosizeEditor()\n  }\n\n  private _onHostFocus() {\n    if (this._refocusing) {\n      this._refocusing = false\n      return\n    }\n    this._enterEditing()\n  }\n\n  /**\n   * pointerdown 时文本层仍是命中目标，此时记录落点；浏览器随后的默认聚焦会触发\n   * host focus 进入编辑，偏移在那里应用到 textarea。\n   */\n  private _onPointerDown(e: PointerEvent) {\n    if (this._isDisabled || this._editing || !this._textLayer) return\n    this._pendingCaret = caretOffsetFromPoint(this._textLayer, e.clientX, e.clientY)\n  }\n\n  /** mousedown 默认聚焦被拦截等场景由 click 兜底进入编辑。 */\n  private _onClick() {\n    if (this._isDisabled || this._editing) return\n    this._enterEditing()\n  }\n\n  /**\n   * 公共 API：进入编辑态并全选内容；已在编辑态时只重新全选。\n   *\n   * `disabled` 时不进入编辑，与 `focus()` 一致。\n   */\n  select() {\n    if (this._isDisabled) return\n    if (!this._editing) this._enterEditing()\n    const editor = this._editor\n    // 全选：末端显式取当前文本长度，覆盖 _enterEditing 落下的光标位置\n    editor?.setSelectionRange(0, editor.value.length)\n  }\n\n  private _enterEditing() {\n    if (this._isDisabled || this._editing) return\n    this._editing = true\n    this._editBase = this._value\n    this.toggleAttribute('editing', true)\n    this._claimEditingKeys()\n    const editor = this._editor\n    if (!editor) return\n    editor.focus()\n    // Tab / 编程式聚焦光标到末尾；指针落点用 pointerdown 记下的偏移\n    const offset = this._pendingCaret ?? this._value.length\n    this._pendingCaret = null\n    const clamped = Math.max(0, Math.min(offset, editor.value.length))\n    editor.setSelectionRange(clamped, clamped)\n  }\n\n  private _exitEditing() {\n    if (!this._editing) return\n    this._editing = false\n    this._releaseEditingKeys()\n    this.toggleAttribute('editing', false)\n  }\n\n  private _onInput() {\n    // 原生 input 已 composed 冒泡出 shadow root 且 target 重定向到宿主，无需补发\n    const editor = this._editor\n    if (this._isDisabled || this.readonly) {\n      if (editor && editor.value !== this._value) editor.value = this._value\n      return\n    }\n    this._value = editor?.value ?? ''\n    this._formAssociation.sync()\n    this._autosizeEditor()\n  }\n\n  /**\n   * blur 提交：与 Enter 同一条提交路径，草稿成为新值并派发 change。\n   *\n   * 不交还焦点：焦点已被用户移走，抢回宿主会吞掉消费者的目标焦点。\n   */\n  private _onBlur() {\n    if (!this._editing || this._isDisabled) return\n    if (this.readonly) {\n      this._exitEditing()\n      return\n    }\n    this._commitEditing(false)\n  }\n\n  /**\n   * 提交：草稿成为新值、退出编辑，并恰好派发一次 change。Enter 与 blur 同走这一条路。\n   *\n   * `returnFocus` 区分两种来路：Enter 主动结束时把焦点交还宿主（标记防重入编辑）；\n   * blur 是被动失焦，焦点已被用户移走，再抢回宿主会吞掉消费者的目标焦点。\n   * 先退出编辑再动焦点：退出时 textarea 隐藏触发的 blur 看到 _editing 已为 false，\n   * 不会把这次提交误判成又一次 blur 提交。\n   */\n  private _commitEditing(returnFocus: boolean) {\n    if (!this._editing) return\n    this._exitEditing()\n    if (returnFocus) this._returnFocusToHost()\n    this.dispatchEvent(new Event('change', { bubbles: true, composed: true }))\n  }\n\n  /**\n   * 取消：恢复进入编辑时的值并派发 cancel。仅 Escape 走这一条路径。\n   *\n   * 调用方（Escape 分支）随后才交还焦点：本方法先摘除编辑态，焦点迁移触发的 blur\n   * 到达时 `_editing` 已为 false 而早退，不会把取消误判成 blur 提交。\n   */\n  private _cancelEditing() {\n    if (!this._editing) return\n    this._value = this._editBase\n    this._formAssociation.sync()\n    this._exitEditing()\n    /*\n     * 重入守卫先于 dispatch 置位：cancel 同步派发，消费者可能在监听器里调\n     * el.focus()——那是一次真实的宿主 focus，没有守卫就会重新进入编辑，随后一次\n     * blur 便把恢复后的原值当成新草稿提交，用户什么都没改却收到 change。守卫在此\n     * 置位后即被该次 focus 消费，与取消后由组件自己交还焦点走同一条早退路径。\n     */\n    this._refocusing = true\n    /*\n     * cancel 与原生 <dialog> 的 cancel 同名，而 dialog 的关闭管线就监听这个事件名。\n     * 组件被消费方投映进浮层 shadow（drawer/dialog 标题）时，任何冒泡的 cancel——\n     * composed 与否都一样，slot 都会把事件带进 shadow 树——都会被那个 dialog 当成\n     * 一次关闭请求：issue #159 的实测症状是 drawer 标题聚焦编辑时按 Escape，或点到\n     * 抽屉别处触发 blur，抽屉跟着编辑一起关。因此只在宿主上派发，不冒泡不组合；\n     * 监听挂在组件本身即可（vue @cancel、React addEventListener 均不受影响）。\n     * 手法同 checkbox/radio 受管时的事件策略（见各自 handleClick 注释）。\n     */\n    this.dispatchEvent(new Event('cancel', { bubbles: false, composed: false }))\n  }\n\n  /**\n   * 焦点交还宿主：先标记再聚焦，宿主 focus 到达时标记已消费，不会再次进入编辑；\n   * 标记在微任务里清掉，此后的聚焦照常进入编辑。\n   */\n  private _returnFocusToHost() {\n    this._refocusing = true\n    this.focus()\n    queueMicrotask(() => {\n      this._refocusing = false\n    })\n  }\n\n  /**\n   * 编辑态按键归属：Enter 提交、Escape 取消。\n   *\n   * 监听挂在 window 捕获阶段而不是 shadow 内的 textarea 上：消费方（浮层仲裁者）在\n   * document 捕获阶段收 Escape，组件若只在 textarea 上处理，按键先被仲裁者收走，\n   * 于是一次 Escape 会同时取消编辑和关闭外层浮层。window 在 document 上游，\n   * stopPropagation 只有挂在这里才拦得住仲裁者。\n   */\n  private _claimEditingKeys() {\n    window.addEventListener('keydown', this._onEditingKeydown, true)\n  }\n\n  private _releaseEditingKeys() {\n    window.removeEventListener('keydown', this._onEditingKeydown, true)\n  }\n\n  private readonly _onEditingKeydown = (e: KeyboardEvent) => {\n    // 输入法组合期间的 Enter/Escape 属于组合会话，交给 IME\n    if (e.isComposing) return\n    if (!e.composedPath().includes(this)) return\n    if (e.key === 'Escape') {\n      // 按键本身也被编辑层消费：外层浮层不应收到同一次 Escape\n      e.preventDefault()\n      e.stopPropagation()\n      // 先取消（内部摘除编辑态）再交还焦点：focus 触发的 blur 看到 _editing 已为\n      // false 而早退，不会把这次取消误判成 blur 提交\n      this._cancelEditing()\n      this._returnFocusToHost()\n      return\n    }\n    if (e.key === 'Enter') {\n      /*\n       * Enter 无论是否只读都属于编辑层，消费策略与 Escape 对称：preventDefault\n       * 压掉默认行为，stopPropagation 阻止外层表单隐式提交或浮层监听收到按键。\n       * 只读态只是没有草稿可提交，因此消费后直接返回，不退出编辑、不派发 change。\n       */\n      e.preventDefault()\n      e.stopPropagation()\n      if (this.readonly) return\n      /*\n       * 可编辑态的 Enter 随后提交草稿；外层表单的隐式提交与浮层监听不应收到\n       * 同一次按键——正如 Escape 属于取消。\n       */\n      this._commitEditing(true)\n    }\n  }\n\n  private _setupAutosize() {\n    this._teardownAutosize()\n    // jsdom 等无 ResizeObserver 的环境退化为按渲染 autosize，够用且不抛错\n    if (typeof ResizeObserver === 'undefined') {\n      this._autosizeEditor()\n      return\n    }\n    this._resizeObserver = new ResizeObserver(() => this._autosizeEditor())\n    this._resizeObserver.observe(this)\n    this._autosizeEditor()\n  }\n\n  private _teardownAutosize() {\n    this._resizeObserver?.disconnect()\n    this._resizeObserver = null\n    this._editor?.style.removeProperty('height')\n  }\n\n  /**\n   * 编辑层高度始终跟随自身内容，不依赖文本层折出的行盒。\n   *\n   * 编辑层绝对定位并用 top/bottom 撑高，`height: auto` 量到的是包含块高度而不是内容高；\n   * 先归零再读 scrollHeight，拿到的才是自身内容的高度（含 1px 内边距）。\n   * 观察宿主而非编辑层：编辑层在文档流外，改它的高度不会反过来改动宿主尺寸。\n   */\n  private _autosizeEditor() {\n    const editor = this._editor\n    if (!editor) return\n    const previous = editor.style.height\n    editor.style.height = '0px'\n    const height = editor.scrollHeight\n    editor.style.height = height > 0 ? `${height}px` : previous\n  }\n\n  private get _displayText(): string {\n    if (this._value !== '') return this._value\n    if (this.placeholder !== '') return this.placeholder\n    return BLANK_GLYPH\n  }\n\n  override render() {\n    return html`\n      <div class=\"layers\" @pointerdown=${this._onPointerDown} @click=${this._onClick}>\n        <span class=${classMap({ text: true, placeholder: this._value === '' })}>${this._displayText}</span>\n        <textarea\n          id=${this._fieldId}\n          class=\"editor\"\n          .value=${this._value}\n          .placeholder=${this.placeholder}\n          ?disabled=${this._isDisabled}\n          ?readonly=${this.readonly}\n          aria-label=${ifDefined(this.ariaLabel)}\n          @input=${this._onInput}\n          @blur=${this._onBlur}\n        ></textarea>\n      </div>\n    `\n  }\n\n  declare readonly $events: {\n    input: Event\n    change: Event\n    cancel: Event\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'web-ui-editable-text': WebUiEditableText\n  }\n}\n"],"mappings":";;;;;;;;;AAWA,IAAM,IAAc,KAGd,IAAkB;AAQxB,SAAS,EAAW,GAAiC;CACnD,KAAK,IAAM,KAAS,EAAM,YACxB,IAAI,aAAiB,MAAM,OAAO;CAEpC,OAAO;AACT;AASA,SAAS,EAAqB,GAAwB,GAAW,GAAmB;CAClF,IAAM,IAAO,EAAW,CAAS;CACjC,IAAI,CAAC,GAAM,OAAO;CAClB,IAAM,IAAS,EAAK,KAAK,QACnB,IAAQ,SAAS,YAAY,GAC7B,KAAU,OACd,EAAM,SAAS,GAAM,CAAM,GAC3B,EAAM,OAAO,GAAM,CAAM,GAClB,EAAM,sBAAsB,IAK/B,IAAmB,CAAC;CAC1B,KAAK,IAAM,KAAQ,EAAU,eAAe,GAC1C,AAAK,EAAM,MAAK,MAAQ,KAAK,IAAI,EAAK,MAAM,EAAK,GAAG,KAAK,CAAe,KAAG,EAAM,KAAK,CAAI;CAE5F,IAAI,EAAM,WAAW,GAAG,OAAO;CAC/B,IAAI,IAAO,EAAM,IACb,IAAU;CACd,KAAK,IAAM,KAAa,GAAO;EAC7B,IAAM,IAAW,KAAK,KAAK,EAAU,MAAM,EAAU,UAAU,IAAI,CAAC;EACpE,AAAI,KAAY,MACd,IAAU,GACV,IAAO;CAEX;CAGA,IAAI,IAAK,GACL,IAAK;CACT,OAAO,IAAK,IAAI;EACd,IAAM,IAAO,IAAK,KAAO;EACzB,AAAI,EAAO,CAAG,CAAC,CAAC,OAAO,EAAK,MAAM,IAAiB,IAAK,IACnD,IAAK,IAAM;CAClB;CACA,IAAM,IAAY;CAIlB,KAFA,IAAK,GACL,IAAK,GACE,IAAK,IAAI;EACd,IAAM,IAAO,IAAK,IAAK,KAAM;EAC7B,AAAI,EAAO,CAAG,CAAC,CAAC,OAAO,EAAK,MAAM,IAAiB,IAAK,IACnD,IAAK,IAAM;CAClB;CACA,IAAM,IAAU,KAAK,IAAI,GAAI,CAAS;CAItC,KAFA,IAAK,GACL,IAAK,GACE,IAAK,IAAI;EACd,IAAM,IAAO,IAAK,IAAK,KAAM;EAC7B,AAAI,EAAO,CAAG,CAAC,CAAC,QAAQ,IAAI,IAAiB,IAAK,IAC7C,IAAK,IAAM;CAClB;CACA,OAAO;AACT;AAGO,IAAM,IAAN,cAAgC,EAAe,CAAU,CAAC,CAAC;;EACvC,KAAA,SAAA,CAAC,EAAU,CAAK,CAAC;;CAuD1C,IACI,QAAgB;EAClB,OAAO,KAAK;CACd;CAEA,IAAI,MAAM,GAAW;EACnB,IAAM,IAAM,KAAK;EAGjB,AAFA,KAAK,SAAS,GACd,KAAK,iBAAiB,KAAK,GAC3B,KAAK,cAAc,SAAS,CAAG;CACjC;CAYA,IAAY,cAAuB;EACjC,OAAO,KAAK,YAAY,KAAK,iBAAiB,eAAe;CAC/D;CAiBA,cAAc;EAGZ,AAFA,MAAM,GA/F0C,KAAA,OAAA,IACO,KAAA,cAAA,IACF,KAAA,WAAA,IACA,KAAA,WAAA,IAwCuC,KAAA,kBAAA,IAEL,KAAA,YAAA,MAE/D,KAAA,SAAA,IAqBP,KAAA,WAAA,IACC,KAAA,YAAA,IACmB,KAAA,gBAAA,MACjB,KAAA,cAAA,IAC2B,KAAA,kBAAA,MACrB,KAAA,WAAA,EAAc,sBAAsB,GAM5B,KAAA,mBAAA,EAA8B;GAChE,MAAM;GACN,gBAAgB,KAAK;GACrB,WAAU,MAAS;IACjB,KAAK,QAAQ;GACf;GACA,oBAAoB,KAAK;GACzB,oBAAoB,KAAK;GACzB,eAAc,MAAS;IACrB,AAAI,OAAO,KAAU,aAAU,KAAK,QAAQ;GAC9C;EACF,CAAC,CAAC,CAAC,KAAK,GAEsC,KAAA,6BAAA,IAAI,EAA0B,MAAM,KAAK,gBAAgB,GAwNjE,KAAA,qBAAA,MAAqB;GAErD,OAAE,eACD,EAAE,aAAa,CAAC,CAAC,SAAS,IAAI,GACnC;QAAI,EAAE,QAAQ,UAAU;KAOtB,AALA,EAAE,eAAe,GACjB,EAAE,gBAAgB,GAGlB,KAAK,eAAe,GACpB,KAAK,mBAAmB;KACxB;IACF;IACA,IAAI,EAAE,QAAQ,SAAS;KAQrB,IAFA,EAAE,eAAe,GACjB,EAAE,gBAAgB,GACd,KAAK,UAAU;KAKnB,KAAK,eAAe,EAAI;IAC1B;GAfA;EAgBF,GAhPE,KAAK,iBAAiB,SAAS,KAAK,YAAY;CAClD;CAEA,uBAAgC;EAwB9B,AAvBA,MAAM,qBAAqB,GAczB,KAAK,mBACL,KAAK,YACL,CAAC,KAAK,eACN,CAAC,KAAK,YACN,KAAK,WAAW,KAAK,aAErB,KAAK,eAAe,EAAK,GAE3B,KAAK,oBAAoB,GACzB,KAAK,kBAAkB;CACzB;CAEA,oBAA6B;EAW3B,AAVA,MAAM,kBAAkB,GAOxB,KAAK,eAAe,GAGhB,KAAK,YAAU,KAAK,kBAAkB;CAC5C;CAEA,UAAmB;EAMjB,AAJI,KAAK,cAAa,KAAK,gBAAgB,UAAU,IAChD,KAAK,aAAa,YAAY,GAAG,GAElC,KAAK,YAAY,KAAK,eAAa,KAAK,aAAa,GACzD,KAAK,gBAAgB;CACvB;CAEA,eAAuB;EACrB,IAAI,KAAK,aAAa;GACpB,KAAK,cAAc;GACnB;EACF;EACA,KAAK,cAAc;CACrB;CAMA,eAAuB,GAAiB;EAClC,KAAK,eAAe,KAAK,YAAY,CAAC,KAAK,eAC/C,KAAK,gBAAgB,EAAqB,KAAK,YAAY,EAAE,SAAS,EAAE,OAAO;CACjF;CAGA,WAAmB;EACb,KAAK,eAAe,KAAK,YAC7B,KAAK,cAAc;CACrB;CAOA,SAAS;EACP,IAAI,KAAK,aAAa;EACtB,AAAK,KAAK,YAAU,KAAK,cAAc;EACvC,IAAM,IAAS,KAAK;EAEpB,GAAQ,kBAAkB,GAAG,EAAO,MAAM,MAAM;CAClD;CAEA,gBAAwB;EACtB,IAAI,KAAK,eAAe,KAAK,UAAU;EAIvC,AAHA,KAAK,WAAW,IAChB,KAAK,YAAY,KAAK,QACtB,KAAK,gBAAgB,WAAW,EAAI,GACpC,KAAK,kBAAkB;EACvB,IAAM,IAAS,KAAK;EACpB,IAAI,CAAC,GAAQ;EACb,EAAO,MAAM;EAEb,IAAM,IAAS,KAAK,iBAAiB,KAAK,OAAO;EACjD,KAAK,gBAAgB;EACrB,IAAM,IAAU,KAAK,IAAI,GAAG,KAAK,IAAI,GAAQ,EAAO,MAAM,MAAM,CAAC;EACjE,EAAO,kBAAkB,GAAS,CAAO;CAC3C;CAEA,eAAuB;EAChB,KAAK,aACV,KAAK,WAAW,IAChB,KAAK,oBAAoB,GACzB,KAAK,gBAAgB,WAAW,EAAK;CACvC;CAEA,WAAmB;EAEjB,IAAM,IAAS,KAAK;EACpB,IAAI,KAAK,eAAe,KAAK,UAAU;GACrC,AAAI,KAAU,EAAO,UAAU,KAAK,WAAQ,EAAO,QAAQ,KAAK;GAChE;EACF;EAGA,AAFA,KAAK,SAAS,GAAQ,SAAS,IAC/B,KAAK,iBAAiB,KAAK,GAC3B,KAAK,gBAAgB;CACvB;CAOA,UAAkB;EACZ,IAAC,KAAK,YAAY,MAAK,aAC3B;OAAI,KAAK,UAAU;IACjB,KAAK,aAAa;IAClB;GACF;GACA,KAAK,eAAe,EAAK;EADzB;CAEF;CAUA,eAAuB,GAAsB;EACtC,KAAK,aACV,KAAK,aAAa,GACd,KAAa,KAAK,mBAAmB,GACzC,KAAK,cAAc,IAAI,MAAM,UAAU;GAAE,SAAS;GAAM,UAAU;EAAK,CAAC,CAAC;CAC3E;CAQA,iBAAyB;EAClB,KAAK,aACV,KAAK,SAAS,KAAK,WACnB,KAAK,iBAAiB,KAAK,GAC3B,KAAK,aAAa,GAOlB,KAAK,cAAc,IAUnB,KAAK,cAAc,IAAI,MAAM,UAAU;GAAE,SAAS;GAAO,UAAU;EAAM,CAAC,CAAC;CAC7E;CAMA,qBAA6B;EAG3B,AAFA,KAAK,cAAc,IACnB,KAAK,MAAM,GACX,qBAAqB;GACnB,KAAK,cAAc;EACrB,CAAC;CACH;CAUA,oBAA4B;EAC1B,OAAO,iBAAiB,WAAW,KAAK,mBAAmB,EAAI;CACjE;CAEA,sBAA8B;EAC5B,OAAO,oBAAoB,WAAW,KAAK,mBAAmB,EAAI;CACpE;CAiCA,iBAAyB;EAGvB,IAFA,KAAK,kBAAkB,GAEnB,OAAO,iBAAmB,KAAa;GACzC,KAAK,gBAAgB;GACrB;EACF;EAGA,AAFA,KAAK,kBAAkB,IAAI,qBAAqB,KAAK,gBAAgB,CAAC,GACtE,KAAK,gBAAgB,QAAQ,IAAI,GACjC,KAAK,gBAAgB;CACvB;CAEA,oBAA4B;EAG1B,AAFA,KAAK,iBAAiB,WAAW,GACjC,KAAK,kBAAkB,MACvB,KAAK,SAAS,MAAM,eAAe,QAAQ;CAC7C;CASA,kBAA0B;EACxB,IAAM,IAAS,KAAK;EACpB,IAAI,CAAC,GAAQ;EACb,IAAM,IAAW,EAAO,MAAM;EAC9B,EAAO,MAAM,SAAS;EACtB,IAAM,IAAS,EAAO;EACtB,EAAO,MAAM,SAAS,IAAS,IAAI,GAAG,EAAO,MAAM;CACrD;CAEA,IAAY,eAAuB;EAGjC,OAFI,KAAK,WAAW,KAChB,KAAK,gBAAgB,KAClB,IAD6B,KAAK,cADV,KAAK;CAGtC;CAEA,SAAkB;EAChB,OAAO,CAAI;yCAC0B,KAAK,eAAe,UAAU,KAAK,SAAS;sBAC/D,EAAS;GAAE,MAAM;GAAM,aAAa,KAAK,WAAW;EAAG,CAAC,EAAE,GAAG,KAAK,aAAa;;eAEtF,KAAK,SAAS;;mBAEV,KAAK,OAAO;yBACN,KAAK,YAAY;sBACpB,KAAK,YAAY;sBACjB,KAAK,SAAS;uBACb,EAAU,KAAK,SAAS,EAAE;mBAC9B,KAAK,SAAS;kBACf,KAAK,QAAQ;;;;CAI7B;AAOF;AAnZG,EAAA,CAAA,EAAS;CAAE,MAAM;CAAQ,SAAS;AAAK,CAAC,CAAA,GAAA,EAAA,WAAA,QAAA,KAAA,CAAA,GACxC,EAAA,CAAA,EAAS;CAAE,MAAM;CAAQ,SAAS;AAAK,CAAC,CAAA,GAAA,EAAA,WAAA,eAAA,KAAA,CAAA,GACxC,EAAA,CAAA,EAAS;CAAE,MAAM;CAAS,SAAS;AAAK,CAAC,CAAA,GAAA,EAAA,WAAA,YAAA,KAAA,CAAA,GACzC,EAAA,CAAA,EAAS;CAAE,MAAM;CAAS,SAAS;AAAK,CAAC,CAAA,GAAA,EAAA,WAAA,YAAA,KAAA,CAAA,GAwCzC,EAAA,CAAA,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,WAAW;AAAoB,CAAC,CAAA,GAAA,EAAA,WAAA,mBAAA,KAAA,CAAA,GAEzE,EAAA,CAAA,EAAS;CAAE,MAAM;CAAQ,WAAW;AAAa,CAAC,CAAA,GAAA,EAAA,WAAA,aAAA,KAAA,CAAA,GAElD,EAAA,CAAA,EAAM,CAAA,GAAA,EAAA,WAAA,UAAA,KAAA,CAAA,GAMN,EAAA,CAAA,EAAS,EAAE,MAAM,OAAO,CAAC,CAAA,GAAA,EAAA,WAAA,SAAA,IAAA,GAYzB,EAAA,CAAA,EAAM,SAAS,CAAA,GAAA,EAAA,WAAA,WAAA,KAAA,CAAA,GACf,EAAA,CAAA,EAAM,OAAO,CAAA,GAAA,EAAA,WAAA,cAAA,KAAA,CAAA,GAtEf,IAAA,EAAA,CAAA,EAAc,sBAAsB,CAAA,GAAA,CAAA"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/editable-text/index.ts"],"sourcesContent":["import { html, LitElement, unsafeCSS } from 'lit'\nimport { customElement, property, query, state } from 'lit/decorators.js'\nimport { classMap } from 'lit/directives/class-map.js'\nimport { ifDefined } from 'lit/directives/if-defined.js'\n\nimport { FormAssociated, defineFormAssociation, FormAssociationController } from '@/shared/form-association'\nimport { createFieldId } from '@/shared/form-association/field-id'\n\nimport style from './style.css?inline'\n\n/** 空值且无 placeholder 时保留可点击行盒。 */\nconst BLANK_GLYPH = '\\u200B'\n\n/** 行/字符落点二分的容差（px），吸收次像素与舍入差异。 */\nconst CARET_TOLERANCE = 1\n\n/**\n * 取文本层承载文案的 Text 节点。\n *\n * 绑定表达式位于元素首个位置时，Lit 会在它前面留一个注释标记节点，因此不能用\n * `firstChild`：那会拿到没有布局的注释，Range 量不到任何矩形。\n */\nfunction textNodeOf(layer: HTMLElement): Text | null {\n  for (const child of layer.childNodes) {\n    if (child instanceof Text) return child\n  }\n  return null\n}\n\n/**\n * 把视口坐标映射为文本层的字符偏移。\n *\n * `document.caretPositionFromPoint` 不进入 shadow DOM（对 shadow 内容返回 shadow host\n * 之外的节点），因此在文本层上用 Range 空矩形二分：先按 y 选行，再在行内按 x 选字符。\n * 文本层与编辑层同盒同排版，偏移与 textarea 的 selectionStart 一一对应。\n */\nfunction caretOffsetFromPoint(textLayer: HTMLElement, x: number, y: number): number {\n  const node = textNodeOf(textLayer)\n  if (!node) return 0\n  const length = node.data.length\n  const range = document.createRange()\n  const rectAt = (offset: number): DOMRect => {\n    range.setStart(node, offset)\n    range.setEnd(node, offset)\n    return range.getBoundingClientRect()\n  }\n\n  // 同一行的盒可能被拆成多个 client rect；按 top 去重得到行列表，取与 y 最近的一行，\n  // 距离相等时取更靠下的一行（与浏览器在行间的落点行为一致）。\n  const lines: DOMRect[] = []\n  for (const rect of textLayer.getClientRects()) {\n    if (!lines.some(line => Math.abs(line.top - rect.top) <= CARET_TOLERANCE)) lines.push(rect)\n  }\n  if (lines.length === 0) return length\n  let line = lines[0]\n  let nearest = Infinity\n  for (const candidate of lines) {\n    const distance = Math.abs((candidate.top + candidate.bottom) / 2 - y)\n    if (distance <= nearest) {\n      nearest = distance\n      line = candidate\n    }\n  }\n\n  // 行首：caret top 首次落入本行的最小偏移\n  let lo = 0\n  let hi = length\n  while (lo < hi) {\n    const mid = (lo + hi) >> 1\n    if (rectAt(mid).top >= line.top - CARET_TOLERANCE) hi = mid\n    else lo = mid + 1\n  }\n  const lineStart = lo\n  // 行尾：caret top 仍落在本行的最大偏移\n  lo = lineStart\n  hi = length\n  while (lo < hi) {\n    const mid = (lo + hi + 1) >> 1\n    if (rectAt(mid).top <= line.top + CARET_TOLERANCE) lo = mid\n    else hi = mid - 1\n  }\n  const lineEnd = Math.max(lo, lineStart)\n  // 行内：caret left 不超过 x 的最大偏移\n  lo = lineStart\n  hi = lineEnd\n  while (lo < hi) {\n    const mid = (lo + hi + 1) >> 1\n    if (rectAt(mid).left <= x + CARET_TOLERANCE) lo = mid\n    else hi = mid - 1\n  }\n  return lo\n}\n\n@customElement('web-ui-editable-text')\nexport class WebUiEditableText extends FormAssociated(LitElement) {\n  static override styles = [unsafeCSS(style)]\n\n  @property({ type: String, reflect: true }) name = ''\n  @property({ type: String, reflect: true }) placeholder = ''\n  @property({ type: Boolean, reflect: true }) disabled = false\n  @property({ type: Boolean, reflect: true }) readonly = false\n\n  /**\n   * 卸载时按提交语义结束编辑，默认 false。\n   *\n   * 跨引擎实测（Chromium 与 WebKit 各一轮）结论**不一致**，这是本属性的主要价值来源：\n   *\n   * - Chromium：移除正在编辑的组件会向编辑层派发 `blur`，默认行为下 `change` 已照常派发\n   *   一次，草稿不丢。blur 与 change 同步排在 `disconnectedCallback` 之后（后者在\n   *   disconnected 步骤内跑完），卸载因此没拿到一条「排在该消费方状态更新之前」的提交来源。\n   * - WebKit（Safari / iOS）：移除**不派发 blur**，默认路径什么都不提交，草稿随组件一起丢弃。\n   *   这里 blur 兜底不存在，只有显式开启本属性才能保住草稿。\n   * - Gecko（Firefox）**未验证**：实测所用机器上没有任何 Firefox 能启动，这里不做断言。把它当作\n   *   未知，而不是默认与上面两者之一相同。\n   *\n   * 所以在 Safari 上这不是可选优化而是必需的：默认值 `false` 对 Safari 用户等于没有兜底，\n   * 消费方若依赖「行被回收时草稿不丢」，在 Safari 上必须显式开启本属性。\n   *\n   * 开启后由 `disconnectedCallback` 复用 `_commitEditing`，与 `Enter`／`blur` 是同一份实现，\n   * 卸载不是第三条独立的提交语义。副作用与 `blur` 提交一致：草稿成为新值、退出编辑、\n   * 派发一次 `change`（冒泡且组合）。两处与 `blur` 刻意不同：\n   *\n   * 1. 提交判据——`Enter` 与 `blur` 由用户动作触发，一律算提交意图；卸载没有这种意图，\n   *    因此只在草稿与进入编辑时的值确实不同时才提交，不产生空提交。\n   * 2. 禁用与只读态——`disabled` / `readonly` 时与 `_onBlur` 一致：不派发提交事件。两者对「已有\n   *    草稿」的后果不同，必须分开说：`disabled` 下草稿保留在组件上；`readonly` 下草稿是真的\n   *    丢掉——`readonly` 阻止不了先前的输入，而卸载时不会再有 blur 兜底（WebKit 上连 blur\n   *    都没有）。可达路径是「可编辑态进入 → 起草稿 → 期间翻 readonly → 卸载」。这里不按取消\n   *    处理：cancel 的契约是恢复 `_editBase`，而卸载既没有焦点要交还也没有宿主接收结果，\n   *    改成 cancel 还会与「与 `_onBlur` 一致」这条公开承诺相悖。用户看到的是「我打的字没了」，\n   *    既没有 change 也没有 cancel。\n   *\n   * 派发发生在卸载回调内，`change` 沿组合路径向上派发，因此挂在组件自身或任一祖先上的监听\n   * 都会执行，**包括已经随宿主一起被卸载的祖先**——派发不要求祖先仍在文档中。这正是虚拟化\n   * 场景需要的：消费方的监听器往往就挂在被回收的那一行上。因此监听器不能假定组件此刻仍在\n   * 文档里；需要把结果交给宿主树之外的状态时，用 `queueMicrotask` 之类的显式转交。\n   *\n   * 祖先上的 `display: none` 不是卸载：组件仍在文档中、不派发任何事件（两引擎一致），那种\n   * 场合需要消费方主动结束编辑。\n   */\n  @property({ type: Boolean, reflect: true, attribute: 'commit-on-unmount' }) commitOnUnmount = false\n\n  @property({ type: String, attribute: 'aria-label' }) override ariaLabel: string | null = null\n\n  @state() private _value = ''\n\n  /**\n   * `value` attribute 承载 form reset 的初值，不随当前值反射；property 暴露当前值，\n   * 与原生 input 的 value / defaultValue 关系一致。\n   */\n  @property({ type: String })\n  get value(): string {\n    return this._value\n  }\n\n  set value(v: string) {\n    const old = this._value\n    this._value = v\n    this._formAssociation.sync()\n    this.requestUpdate('value', old)\n  }\n\n  @query('.editor') private _editor?: HTMLTextAreaElement\n  @query('.text') private _textLayer?: HTMLElement\n\n  private _editing = false\n  private _editBase = ''\n  private _pendingCaret: number | null = null\n  private _refocusing = false\n  private _resizeObserver: ResizeObserver | null = null\n  private readonly _fieldId = createFieldId('web-ui-editable-text')\n\n  private get _isDisabled(): boolean {\n    return this.disabled || this._formAssociation.isFormDisabled()\n  }\n\n  private readonly _formAssociation = defineFormAssociation<string>({\n    host: this,\n    getState: () => this._value,\n    setState: value => {\n      this.value = value\n    },\n    getFormValue: () => this._value,\n    getFormState: () => this._value,\n    restoreState: state => {\n      if (typeof state === 'string') this.value = state\n    }\n  }).make()\n\n  private readonly _formAssociationController = new FormAssociationController(this, this._formAssociation)\n\n  constructor() {\n    super()\n    // focus 不冒泡：宿主监听只在焦点从组件外进入时触发，shadow 内聚焦不会误触\n    this.addEventListener('focus', this._onHostFocus)\n  }\n\n  override disconnectedCallback() {\n    super.disconnectedCallback()\n    /*\n     * 卸载没有用户动作作为提交意图（`Enter` / `blur` 都有），所以判据是草稿与进入编辑时的\n     * 值是否不同，而不是「是否提交过」——Escape 会把值恢复成 `_editBase`，但那是取消，与\n     * 本次卸载无关；一个只聚焦了没打字的会话也不该在消失时凭空产生一次 change。\n     *\n     * `_isDisabled` 与 `readonly` 两道守卫都与 `_onBlur` 对称：两者都不派发提交事件。`disabled`\n     * 必须显式判——`disabled = true` 与 `remove()` 在同一任务里执行时 Lit 更新是微任务，\n     * `updated()` 还没跑到（禁用态退出编辑那条分支尚未执行），此时组件仍在编辑态，不判就会\n     * 派发一条 blur 路径明确拒绝的 change。`readonly` 不能靠「草稿恒等于基线」兜住：可编辑态\n     * 进入并起草稿之后属性才翻成 readonly 的会话，基线仍是进入编辑时的旧值，两条判据都成立\n     * 却不该提交（草稿在这次卸载中丢失，理由见 property 的 JSDoc）。\n     */\n    if (\n      this.commitOnUnmount &&\n      this._editing &&\n      !this._isDisabled &&\n      !this.readonly &&\n      this._value !== this._editBase\n    ) {\n      this._commitEditing(false)\n    }\n    this._releaseEditingKeys()\n    this._teardownAutosize()\n  }\n\n  override connectedCallback() {\n    super.connectedCallback()\n    /*\n     * autosize 的 ResizeObserver 在 disconnectedCallback 被拆掉，搭建若只放在\n     * firstUpdated（一生一次），元素断开再重连后 RO 永久丢失、autosize 静默失效。\n     * connectedCallback 每次连接都跑：_setupAutosize 自带 teardown，重复进入无副作用。\n     * 首连接时渲染尚未发生（_editor 为 null），_autosizeEditor 与 RO 回调都有判空守卫。\n     */\n    this._setupAutosize()\n    // 同类缺口：编辑态被断开时 _releaseEditingKeys 撤了 window 监听，重连后 _editing\n    // 仍为 true（blur 取消未必先于断开到达），此时补领，避免重连后按键失灵。\n    if (this._editing) this._claimEditingKeys()\n  }\n\n  override updated() {\n    // disabled 时移出 tab 序列；编辑态由 editing attribute 表达，二者互斥\n    if (this._isDisabled) this.removeAttribute('tabindex')\n    else this.setAttribute('tabindex', '0')\n    // 禁用态生效时（属性或 fieldset）退出编辑：值保持当前草稿，不派发提交事件\n    if (this._editing && this._isDisabled) this._exitEditing()\n    this._autosizeEditor()\n  }\n\n  private _onHostFocus() {\n    if (this._refocusing) {\n      this._refocusing = false\n      return\n    }\n    this._enterEditing()\n  }\n\n  /**\n   * pointerdown 时文本层仍是命中目标，此时记录落点；浏览器随后的默认聚焦会触发\n   * host focus 进入编辑，偏移在那里应用到 textarea。\n   */\n  private _onPointerDown(e: PointerEvent) {\n    if (this._isDisabled || this._editing || !this._textLayer) return\n    this._pendingCaret = caretOffsetFromPoint(this._textLayer, e.clientX, e.clientY)\n  }\n\n  /** mousedown 默认聚焦被拦截等场景由 click 兜底进入编辑。 */\n  private _onClick() {\n    if (this._isDisabled || this._editing) return\n    this._enterEditing()\n  }\n\n  /**\n   * 公共 API：进入编辑态并全选内容；已在编辑态时只重新全选。\n   *\n   * `disabled` 时不进入编辑，与 `focus()` 一致。\n   */\n  select() {\n    if (this._isDisabled) return\n    if (!this._editing) this._enterEditing()\n    const editor = this._editor\n    // 全选：末端显式取当前文本长度，覆盖 _enterEditing 落下的光标位置\n    editor?.setSelectionRange(0, editor.value.length)\n  }\n\n  private _enterEditing() {\n    if (this._isDisabled || this._editing) return\n    this._editing = true\n    this._editBase = this._value\n    this.toggleAttribute('editing', true)\n    this._claimEditingKeys()\n    const editor = this._editor\n    if (!editor) return\n    editor.focus()\n    // Tab / 编程式聚焦光标到末尾；指针落点用 pointerdown 记下的偏移\n    const offset = this._pendingCaret ?? this._value.length\n    this._pendingCaret = null\n    const clamped = Math.max(0, Math.min(offset, editor.value.length))\n    editor.setSelectionRange(clamped, clamped)\n  }\n\n  private _exitEditing() {\n    if (!this._editing) return\n    this._editing = false\n    this._releaseEditingKeys()\n    this.toggleAttribute('editing', false)\n  }\n\n  private _onInput() {\n    // 原生 input 已 composed 冒泡出 shadow root 且 target 重定向到宿主，无需补发\n    const editor = this._editor\n    if (this._isDisabled || this.readonly) {\n      if (editor && editor.value !== this._value) editor.value = this._value\n      return\n    }\n    this._value = editor?.value ?? ''\n    this._formAssociation.sync()\n    this._autosizeEditor()\n  }\n\n  /**\n   * blur 提交：与 Enter 同一条提交路径，草稿成为新值并派发 change。\n   *\n   * 不交还焦点：焦点已被用户移走，抢回宿主会吞掉消费者的目标焦点。\n   */\n  private _onBlur() {\n    if (!this._editing || this._isDisabled) return\n    if (this.readonly) {\n      this._exitEditing()\n      return\n    }\n    this._commitEditing(false)\n  }\n\n  /**\n   * 提交：草稿成为新值、退出编辑，并恰好派发一次 change。Enter 与 blur 同走这一条路。\n   *\n   * `returnFocus` 区分两种来路：Enter 主动结束时把焦点交还宿主（标记防重入编辑）；\n   * blur 是被动失焦，焦点已被用户移走，再抢回宿主会吞掉消费者的目标焦点。\n   * 先退出编辑再动焦点：退出时 textarea 隐藏触发的 blur 看到 _editing 已为 false，\n   * 不会把这次提交误判成又一次 blur 提交。\n   */\n  private _commitEditing(returnFocus: boolean) {\n    if (!this._editing) return\n    this._exitEditing()\n    if (returnFocus) this._returnFocusToHost()\n    this.dispatchEvent(new Event('change', { bubbles: true, composed: true }))\n  }\n\n  /**\n   * 取消：恢复进入编辑时的值并派发 cancel。仅 Escape 走这一条路径。\n   *\n   * 调用方（Escape 分支）随后才交还焦点：本方法先摘除编辑态，焦点迁移触发的 blur\n   * 到达时 `_editing` 已为 false 而早退，不会把取消误判成 blur 提交。\n   */\n  private _cancelEditing() {\n    if (!this._editing) return\n    this._value = this._editBase\n    this._formAssociation.sync()\n    this._exitEditing()\n    /*\n     * 重入守卫先于 dispatch 置位：cancel 同步派发，消费者可能在监听器里调\n     * el.focus()——那是一次真实的宿主 focus，没有守卫就会重新进入编辑，随后一次\n     * blur 便把恢复后的原值当成新草稿提交，用户什么都没改却收到 change。守卫在此\n     * 置位后即被该次 focus 消费，与取消后由组件自己交还焦点走同一条早退路径。\n     */\n    this._refocusing = true\n    /*\n     * cancel 与原生 <dialog> 的 cancel 同名，而 dialog 的关闭管线就监听这个事件名。\n     * 组件被消费方投映进 overlay shadow（drawer/dialog 标题）时，任何冒泡的 cancel——\n     * composed 与否都一样，slot 都会把事件带进 shadow 树——都会被那个 dialog 当成\n     * 一次关闭请求：issue #159 的实测症状是 drawer 标题聚焦编辑时按 Escape，或点到\n     * drawer 别处触发 blur，drawer 跟着编辑一起关。因此只在宿主上派发，不冒泡不组合；\n     * 监听挂在组件本身即可（vue @cancel、React addEventListener 均不受影响）。\n     * 手法同 checkbox/radio 受管时的事件策略（见各自 handleClick 注释）。\n     */\n    this.dispatchEvent(new Event('cancel', { bubbles: false, composed: false }))\n  }\n\n  /**\n   * 焦点交还宿主：先标记再聚焦，宿主 focus 到达时标记已消费，不会再次进入编辑；\n   * 标记在微任务里清掉，此后的聚焦照常进入编辑。\n   */\n  private _returnFocusToHost() {\n    this._refocusing = true\n    this.focus()\n    queueMicrotask(() => {\n      this._refocusing = false\n    })\n  }\n\n  /**\n   * 编辑态按键归属：Enter 提交、Escape 取消。\n   *\n   * 监听挂在 window 捕获阶段而不是 shadow 内的 textarea 上：消费方（overlay 仲裁者）在\n   * document 捕获阶段收 Escape，组件若只在 textarea 上处理，按键先被仲裁者收走，\n   * 于是一次 Escape 会同时取消编辑和关闭外层 overlay。window 在 document 上游，\n   * stopPropagation 只有挂在这里才拦得住仲裁者。\n   */\n  private _claimEditingKeys() {\n    window.addEventListener('keydown', this._onEditingKeydown, true)\n  }\n\n  private _releaseEditingKeys() {\n    window.removeEventListener('keydown', this._onEditingKeydown, true)\n  }\n\n  private readonly _onEditingKeydown = (e: KeyboardEvent) => {\n    // 输入法组合期间的 Enter/Escape 属于组合会话，交给 IME\n    if (e.isComposing) return\n    if (!e.composedPath().includes(this)) return\n    if (e.key === 'Escape') {\n      // 按键本身也被编辑层消费：外层 overlay 不应收到同一次 Escape\n      e.preventDefault()\n      e.stopPropagation()\n      // 先取消（内部摘除编辑态）再交还焦点：focus 触发的 blur 看到 _editing 已为\n      // false 而早退，不会把这次取消误判成 blur 提交\n      this._cancelEditing()\n      this._returnFocusToHost()\n      return\n    }\n    if (e.key === 'Enter') {\n      /*\n       * Enter 无论是否只读都属于编辑层，消费策略与 Escape 对称：preventDefault\n       * 压掉默认行为，stopPropagation 阻止外层表单隐式提交或 overlay 监听收到按键。\n       * 只读态只是没有草稿可提交，因此消费后直接返回，不退出编辑、不派发 change。\n       */\n      e.preventDefault()\n      e.stopPropagation()\n      if (this.readonly) return\n      /*\n       * 可编辑态的 Enter 随后提交草稿；外层表单的隐式提交与 overlay 监听不应收到\n       * 同一次按键——正如 Escape 属于取消。\n       */\n      this._commitEditing(true)\n    }\n  }\n\n  private _setupAutosize() {\n    this._teardownAutosize()\n    // jsdom 等无 ResizeObserver 的环境退化为按渲染 autosize，够用且不抛错\n    if (typeof ResizeObserver === 'undefined') {\n      this._autosizeEditor()\n      return\n    }\n    this._resizeObserver = new ResizeObserver(() => this._autosizeEditor())\n    this._resizeObserver.observe(this)\n    this._autosizeEditor()\n  }\n\n  private _teardownAutosize() {\n    this._resizeObserver?.disconnect()\n    this._resizeObserver = null\n    this._editor?.style.removeProperty('height')\n  }\n\n  /**\n   * 编辑层高度始终跟随自身内容，不依赖文本层折出的行盒。\n   *\n   * 编辑层绝对定位并用 top/bottom 撑高，`height: auto` 量到的是包含块高度而不是内容高；\n   * 先归零再读 scrollHeight，拿到的才是自身内容的高度（含 1px 内边距）。\n   * 观察宿主而非编辑层：编辑层在文档流外，改它的高度不会反过来改动宿主尺寸。\n   */\n  private _autosizeEditor() {\n    const editor = this._editor\n    if (!editor) return\n    const previous = editor.style.height\n    editor.style.height = '0px'\n    const height = editor.scrollHeight\n    editor.style.height = height > 0 ? `${height}px` : previous\n  }\n\n  private get _displayText(): string {\n    if (this._value !== '') return this._value\n    if (this.placeholder !== '') return this.placeholder\n    return BLANK_GLYPH\n  }\n\n  override render() {\n    return html`\n      <div class=\"layers\" @pointerdown=${this._onPointerDown} @click=${this._onClick}>\n        <span\n          class=${classMap({\n            text: true,\n            placeholder: this._value === '',\n            'trailing-newline': this._value.endsWith('\\n')\n          })}\n          >${this._displayText}</span\n        >\n        <textarea\n          id=${this._fieldId}\n          class=\"editor\"\n          .value=${this._value}\n          .placeholder=${this.placeholder}\n          ?disabled=${this._isDisabled}\n          ?readonly=${this.readonly}\n          aria-label=${ifDefined(this.ariaLabel)}\n          @input=${this._onInput}\n          @blur=${this._onBlur}\n        ></textarea>\n      </div>\n    `\n  }\n\n  declare readonly $events: {\n    input: Event\n    change: Event\n    cancel: Event\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'web-ui-editable-text': WebUiEditableText\n  }\n}\n"],"mappings":"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"}

package/dist/components/editable-text/style.js

@@ -1,5 +1,5 @@
 //#region src/components/editable-text/style.css?inline
-var e = "*,:before,:after{box-sizing:border-box}:host{display:inline-block}.layers{display:block;position:relative}.text,.editor{overflow-wrap:var(--wui-editable-text-overflow-wrap,anywhere);white-space:var(--wui-editable-text-white-space,pre-wrap)}.text{display:inline}.placeholder{color:var(--wui-color-text-secondary,#6a6a6a)}.editor{resize:none;font:inherit;line-height:inherit;color:inherit;text-align:inherit;text-transform:inherit;letter-spacing:inherit;word-break:inherit;appearance:none;visibility:hidden;caret-color:var(--wui-color-accent,#08f);background:0 0;border:0;outline:none;margin:0;padding:1px;position:absolute;inset:-1px;overflow:hidden}.editor::placeholder{color:var(--wui-color-text-secondary,#6a6a6a)}:host([editing]) .editor{visibility:visible;min-width:1ch}:host([editing]) .text{visibility:hidden}:host([disabled]){cursor:not-allowed}";
+var e = "*,:before,:after{box-sizing:border-box}:host{display:inline-block}.layers{display:block;position:relative}.text,.editor{overflow-wrap:var(--wui-editable-text-overflow-wrap,anywhere);white-space:var(--wui-editable-text-white-space,pre-wrap)}.text{display:inline}.text.trailing-newline:after{content:\"\";width:0;display:inline-block}.placeholder{color:var(--wui-color-text-secondary,#6a6a6a)}.editor{resize:none;font:inherit;line-height:inherit;color:inherit;text-align:inherit;text-transform:inherit;letter-spacing:inherit;word-break:inherit;appearance:none;visibility:hidden;caret-color:var(--wui-color-accent,#0071e3);background:0 0;border:0;outline:none;margin:0;padding:1px;position:absolute;inset:-1px;overflow:hidden}.editor::placeholder{color:var(--wui-color-text-secondary,#6a6a6a)}:host([editing]) .editor{visibility:visible;min-width:1ch}:host([editing]) .text{visibility:hidden}:host([disabled]){cursor:not-allowed}";
 //#endregion
 export { e as default };
 

package/dist/components/editable-text/style.js.map

@@ -1 +1 @@
-{"version":3,"file":"style.js","names":[],"sources":["../../../src/components/editable-text/style.css?inline"],"sourcesContent":["*,\n*::before,\n*::after {\n  box-sizing: border-box;\n}\n\n/* 组件对外表现为同级 span：行内级盒子，排版与颜色全部继承外部上下文。\n   :host 只设 display（ADR-0005），其余样式在 shadow root 内。 */\n:host {\n  display: inline-block;\n}\n\n/* 文本层与编辑层共用的排版盒：编辑层 absolute 定位覆盖它，切换只改可见性，\n  因此文字态与编辑态逐像素同盒。 */\n.layers {\n  position: relative;\n  display: block;\n}\n\n.text,\n.editor {\n  /* 长无空格串两层都必须能断：文本层若只继承宿主默认的 normal，长字母数字串不\n     截断、直接溢出宿主盒（文字态），而编辑层在盒内裁剪（编辑态），两层断行\n     不一致。默认 anywhere：仅在单词放不下时断，且参与 min-content 计算，收缩\n     上下文（flex 项 min-width:0）里长串也不会撑爆宿主；两层取同一变量，外部\n     覆盖时仍保持一致。 */\n  overflow-wrap: var(--wui-editable-text-overflow-wrap, anywhere);\n\n  /* 多行编辑要求换行符成行，但 pre-wrap 只能落在文本层上：模板里元素之间的空白\n     文本节点若被 pre-wrap 保留，会各自生成幻影行盒，把文本层顶偏、盒高翻倍，\n     文字态与编辑态随之不再同盒。这里保持 .layers 为默认 normal 让空白折叠，\n     两层取同一变量，外部覆盖（如 nowrap）时仍保持一致。 */\n  white-space: var(--wui-editable-text-white-space, pre-wrap);\n}\n\n.text {\n  display: inline;\n}\n\n.placeholder {\n  color: var(--wui-color-text-secondary, #6a6a6a);\n}\n\n/* 原生控件 reset：不贡献尺寸、无边框背景描边、不可手拖改变大小 */\n.editor {\n  resize: none;\n\n  position: absolute;\n\n  /* 四边各外扩 1px，再用 1px 内边距把文本起点与换行宽度拉回内容盒。\n     两层必须同盒，但盒的边界同时也是原生控件的裁剪边界：文本层的字形会按\n     边距溢出内容盒半个像素左右，紧凑行高下 textarea 内部内容也会比内容盒高\n     出 1px。裁剪盒若与内容盒重合，这些墨色只存在于文字态，编辑态被裁掉或顶偏，\n     两态逐像素比对就对不上；外扩 1px 后编辑层的裁剪盒覆盖文本层的墨色范围。 */\n  inset: -1px;\n\n  overflow: hidden;\n\n  margin: 0;\n  padding: 1px;\n  border: 0;\n\n  /* 原生控件不继承排版：显式继承让编辑层与文本层共用同一套字体度量 */\n  font: inherit;\n  line-height: inherit;\n  color: inherit;\n  text-align: inherit;\n  text-transform: inherit;\n  letter-spacing: inherit;\n  word-break: inherit;\n\n  appearance: none;\n  visibility: hidden;\n  background: transparent;\n  outline: none;\n\n  /* 光标颜色组件级默认：跟随共享语义 token，消费方在宿主或任意祖先上设\n     --wui-color-accent 即可覆盖（自定义属性穿透 shadow 边界继承）；\n     此前只有 interweave 页面级设置，demo 等消费方拿到的是浏览器默认黑。 */\n  caret-color: var(--wui-color-accent, #08f);\n\n  &::placeholder {\n    color: var(--wui-color-text-secondary, #6a6a6a);\n  }\n}\n\n/* 可见性切换：文字态隐藏编辑层、编辑态显露；盒模型、滚动与换行不随之变化 */\n:host([editing]) .editor {\n  /* 空内容时宿主可能被收缩到 0 宽：行内级盒子配上零宽占位符，收缩上下文（flex 项\n     min-width:0、表格单元格等）里就量不到宽度，编辑层随之没有可绘制光标的地盘，\n     清空全部内容后光标消失。留一个字符宽，保证空草稿下光标仍然可见。\n     规则落在 shadow 内：宿主上的 min-width 属于外层文档样式，会盖过 :host 声明。 */\n  min-width: 1ch;\n  visibility: visible;\n}\n\n/* 编辑态隐藏文本层：两层同盒同排版，若同时可见会把同一份文字画两遍，\n   抗锯齿边缘的墨色会加重，破坏文字态/编辑态的逐像素一致。 */\n:host([editing]) .text {\n  visibility: hidden;\n}\n\n:host([disabled]) {\n  cursor: not-allowed;\n}\n"],"mappings":""}
+{"version":3,"file":"style.js","names":[],"sources":["../../../src/components/editable-text/style.css?inline"],"sourcesContent":["*,\n*::before,\n*::after {\n  box-sizing: border-box;\n}\n\n/* 组件对外表现为同级 span：行内级盒子，排版与颜色全部继承外部上下文。\n   :host 只设 display（ADR-0005），其余样式在 shadow root 内。 */\n:host {\n  display: inline-block;\n}\n\n/* 文本层与编辑层共用的排版盒：编辑层 absolute 定位覆盖它，切换只改可见性，\n  因此文字态与编辑态逐像素同盒。 */\n.layers {\n  position: relative;\n  display: block;\n}\n\n.text,\n.editor {\n  /* 长无空格串两层都必须能断：文本层若只继承宿主默认的 normal，长字母数字串不\n     截断、直接溢出宿主盒（文字态），而编辑层在盒内裁剪（编辑态），两层断行\n     不一致。默认 anywhere：仅在单词放不下时断，且参与 min-content 计算，收缩\n     上下文（flex 项 min-width:0）里长串也不会撑爆宿主；两层取同一变量，外部\n     覆盖时仍保持一致。 */\n  overflow-wrap: var(--wui-editable-text-overflow-wrap, anywhere);\n\n  /* 多行编辑要求换行符成行，但 pre-wrap 只能落在文本层上：模板里元素之间的空白\n     文本节点若被 pre-wrap 保留，会各自生成幻影行盒，把文本层顶偏、盒高翻倍，\n     文字态与编辑态随之不再同盒。这里保持 .layers 为默认 normal 让空白 collapse，\n     两层取同一变量，外部覆盖（如 nowrap）时仍保持一致。 */\n  white-space: var(--wui-editable-text-white-space, pre-wrap);\n}\n\n.text {\n  display: inline;\n}\n\n/* pre-wrap 不为文本节点末尾的换行留下行盒；空的零宽行内块触发末行排版，\n   不向文本节点添加字符，因此选择、复制与 value 保持一致。 */\n.text.trailing-newline::after {\n  content: '';\n  display: inline-block;\n  width: 0;\n}\n\n.placeholder {\n  color: var(--wui-color-text-secondary, #6a6a6a);\n}\n\n/* 原生控件 reset：不贡献尺寸、无边框背景描边、不可手拖改变大小 */\n.editor {\n  resize: none;\n\n  position: absolute;\n\n  /* 四边各外扩 1px，再用 1px 内边距把文本起点与换行宽度拉回内容盒。\n     两层必须同盒，但盒的边界同时也是原生控件的裁剪边界：文本层的字形会按\n     边距溢出内容盒半个像素左右，紧凑行高下 textarea 内部内容也会比内容盒高\n     出 1px。裁剪盒若与内容盒重合，这些墨色只存在于文字态，编辑态被裁掉或顶偏，\n     两态逐像素比对就对不上；外扩 1px 后编辑层的裁剪盒覆盖文本层的墨色范围。 */\n  inset: -1px;\n\n  overflow: hidden;\n\n  margin: 0;\n  padding: 1px;\n  border: 0;\n\n  /* 原生控件不继承排版：显式继承让编辑层与文本层共用同一套字体度量 */\n  font: inherit;\n  line-height: inherit;\n  color: inherit;\n  text-align: inherit;\n  text-transform: inherit;\n  letter-spacing: inherit;\n  word-break: inherit;\n\n  appearance: none;\n  visibility: hidden;\n  background: transparent;\n  outline: none;\n\n  /* 光标颜色组件级默认：跟随共享语义 token，消费方在宿主或任意祖先上设\n     --wui-color-accent 即可覆盖（自定义属性穿透 shadow 边界继承）；\n     此前只有 interweave 页面级设置，demo 等消费方拿到的是浏览器默认黑。 */\n  caret-color: var(--wui-color-accent, #0071e3);\n\n  &::placeholder {\n    color: var(--wui-color-text-secondary, #6a6a6a);\n  }\n}\n\n/* 可见性切换：文字态隐藏编辑层、编辑态显露；盒模型、滚动与换行不随之变化 */\n:host([editing]) .editor {\n  /* 空内容时宿主可能被收缩到 0 宽：行内级盒子配上零宽 placeholder，收缩上下文（flex 项\n     min-width:0、表格单元格等）里就量不到宽度，编辑层随之没有可绘制光标的地盘，\n     清空全部内容后光标消失。留一个字符宽，保证空草稿下光标仍然可见。\n     规则落在 shadow 内：宿主上的 min-width 属于外层文档样式，会盖过 :host 声明。 */\n  min-width: 1ch;\n  visibility: visible;\n}\n\n/* 编辑态隐藏文本层：两层同盒同排版，若同时可见会把同一份文字画两遍，\n   抗锯齿边缘的墨色会加重，破坏文字态/编辑态的逐像素一致。 */\n:host([editing]) .text {\n  visibility: hidden;\n}\n\n:host([disabled]) {\n  cursor: not-allowed;\n}\n"],"mappings":""}

package/dist/components/empty/index.d.ts

@@ -4,10 +4,10 @@ export declare class WebUiEmpty extends LitElement {
     title: string;
     description: string;
     /**
-     * 版面缩放基准，单位 px，默认 56。驱动图标盒、min-height、padding 与标题/描述字号，
-     * 使大图标不再配 medium 留白。
+     * 版面缩放基准，单位 px，默认 56。驱动 icon 盒、min-height、padding 与标题/描述字号，
+     * 使大 icon 不再配 medium 留白。
      *
-     * 派生规则：图标容器边长即 `size`，默认字形边长 `round(size * 3 / 7)`，min-height
+     * 派生规则：icon 容器边长即 `size`，默认字形边长 `round(size * 3 / 7)`，min-height
      * `round(size * 30 / 7)`，padding 块 `round(size * 4 / 7)`、行 `round(size * 3 / 7)`；
      * 字号在 56 处分两档，低于 56 为 14px / 13px，56 及以上为 16px / 14px。段间距与内容宽度
      * 不随它变化。

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/empty/index.ts"],"sourcesContent":["import '@/components/icon'\n\nimport { html, LitElement, unsafeCSS } from 'lit'\nimport { customElement, property, state } from 'lit/decorators.js'\nimport { classMap } from 'lit/directives/class-map.js'\n\nimport { lucideInbox } from '@/icons'\n\nimport style from './style.css?inline'\n\n/**\n * 图标容器边长默认值（px），也是非法输入的回退目标。\n */\nconst DEFAULT_SIZE = 56\n\n/**\n * 派生度量统一除以 7。取 7 是为了让默认档 56 整除出改前 medium 的四个值：字形 3/7 → 24、\n * min-height 30/7 → 240、padding 块 4/7 → 32、padding 行 3/7 → 24。40 与 72 因此落到\n * 171 / 23 / 17 与 309 / 41 / 31，字形 17 与 31。\n */\nconst DERIVED_DENOMINATOR = 7\nconst GLYPH_NUMERATOR = 3\nconst MIN_HEIGHT_NUMERATOR = 30\nconst PADDING_BLOCK_NUMERATOR = 4\nconst PADDING_INLINE_NUMERATOR = 3\n\n/**\n * 字号只有两档，阈值与默认边长同为 56：低于阈值取改前 small 的字号，其余取改前 medium 的\n * 字号。大尺寸靠留白撑开而不是靠字变大，所以 72 与 56 同档。\n */\nconst COMPACT_SIZE_THRESHOLD = 56\nconst COMPACT_TITLE_FONT_SIZE = 14\nconst COMPACT_DESCRIPTION_FONT_SIZE = 13\nconst DEFAULT_TITLE_FONT_SIZE = 16\nconst DEFAULT_DESCRIPTION_FONT_SIZE = 14\n\n/**\n * 只做数值合法性判断，不做枚举映射：有限正数原样采用，其余输入（NaN、±Infinity、0、负数）\n * 回退默认边长。\n *\n * 这一层是必要的：`size` 会同时写进 `--wui-internal-empty-size`，未守卫时\n * `size=\"abc\"` 会产出失效的 `NaNpx`（盒退回 unset 而涨成 300×300），\n * `size=\"\"` 会产出 `0px`（图标不可见）。回退的是边长本身，整套派生度量因此一起回到默认档\n * 56，而不是按 `NaN` 算出垃圾值。\n */\nconst normalizeSize = (value: number): number => (Number.isFinite(value) && value > 0 ? value : DEFAULT_SIZE)\n\n@customElement('web-ui-empty')\nexport class WebUiEmpty extends LitElement {\n  static override styles = [unsafeCSS(style)]\n\n  @property({ type: String, reflect: true }) override title = ''\n\n  @property({ type: String, reflect: true }) description = ''\n\n  /**\n   * 版面缩放基准，单位 px，默认 56。驱动图标盒、min-height、padding 与标题/描述字号，\n   * 使大图标不再配 medium 留白。\n   *\n   * 派生规则：图标容器边长即 `size`，默认字形边长 `round(size * 3 / 7)`，min-height\n   * `round(size * 30 / 7)`，padding 块 `round(size * 4 / 7)`、行 `round(size * 3 / 7)`；\n   * 字号在 56 处分两档，低于 56 为 14px / 13px，56 及以上为 16px / 14px。段间距与内容宽度\n   * 不随它变化。\n   *\n   * 派生值全部落在 `--wui-internal-empty-*` 上，`--wui-empty-*` 仍压在其上，所以逐项覆盖\n   * 优先于本属性。非法输入（非有限数、0、负数）回退默认边长 56。\n   */\n  @property({ type: Number, reflect: true })\n  get size(): number {\n    return this._size\n  }\n\n  set size(value: number) {\n    const old = this._size\n    const normalized = normalizeSize(value)\n    if (normalized === old) return\n    this._size = normalized\n    this.requestUpdate('size', old)\n  }\n\n  private _size = DEFAULT_SIZE\n\n  private get _iconSize(): number {\n    return Math.round((this.size * GLYPH_NUMERATOR) / DERIVED_DENOMINATOR)\n  }\n\n  /**\n   * `size` 派生的整套度量。CSS 侧按 `var(--wui-empty-*, var(--wui-internal-empty-*, 默认值))`\n   * 消费，公开 token 因此始终压在派生值之上。\n   */\n  private get _sizeStyle(): Record<string, string> {\n    const size = this.size\n    const compact = size < COMPACT_SIZE_THRESHOLD\n    const scaled = (numerator: number) => `${Math.round((size * numerator) / DERIVED_DENOMINATOR)}px`\n    return {\n      '--wui-internal-empty-size': `${size}px`,\n      '--wui-internal-empty-min-height': scaled(MIN_HEIGHT_NUMERATOR),\n      '--wui-internal-empty-padding-block': scaled(PADDING_BLOCK_NUMERATOR),\n      '--wui-internal-empty-padding-inline': scaled(PADDING_INLINE_NUMERATOR),\n      '--wui-internal-empty-title-font-size': `${compact ? COMPACT_TITLE_FONT_SIZE : DEFAULT_TITLE_FONT_SIZE}px`,\n      '--wui-internal-empty-description-font-size': `${\n        compact ? COMPACT_DESCRIPTION_FONT_SIZE : DEFAULT_DESCRIPTION_FONT_SIZE\n      }px`\n    }\n  }\n\n  @state() private _hasTitleSlot = false\n  @state() private _hasDescriptionSlot = false\n  @state() private _hasActionSlot = false\n\n  override connectedCallback() {\n    super.connectedCallback()\n    this._syncSlotContent()\n  }\n\n  protected override updated() {\n    // 无条件写：条件写同样覆盖得到默认实例（实测首次 changedProperties 里带 size）。\n    // 这里换来的不变量是「派生 token 永远与当前 size 一致」——将来新增派生 token 不必\n    // 再补一处 changed 判断，而同值 setProperty 不触发样式失效，代价可忽略。\n    for (const [token, value] of Object.entries(this._sizeStyle)) {\n      this.style.setProperty(token, value)\n    }\n  }\n\n  private _syncSlotContent = () => {\n    this._hasTitleSlot = this._hasAssignedContent()\n    this._hasDescriptionSlot = this._hasAssignedContent('description')\n    this._hasActionSlot = this._hasAssignedContent('action')\n  }\n\n  private _hasAssignedContent(slotName?: string): boolean {\n    return [...this.childNodes].some(node => {\n      if (node instanceof HTMLElement && (node.getAttribute('slot') ?? '') === (slotName ?? '')) return true\n      return !slotName && node.nodeType === Node.TEXT_NODE && Boolean(node.textContent?.trim())\n    })\n  }\n\n  override render() {\n    const showTitle = this._hasTitleSlot || Boolean(this.title)\n    const showDescription = this._hasDescriptionSlot || Boolean(this.description)\n\n    return html`\n      <section class=\"empty\">\n        <div class=\"empty-icon\" aria-hidden=\"true\">\n          <slot name=\"icon\"><web-ui-icon .icon=${lucideInbox} .size=${this._iconSize}></web-ui-icon></slot>\n        </div>\n        <div class=${classMap({ 'empty-title': true, 'is-hidden': !showTitle })}>\n          <slot @slotchange=${this._syncSlotContent}>${this.title}</slot>\n        </div>\n        <div class=${classMap({ 'empty-description': true, 'is-hidden': !showDescription })}>\n          <slot name=\"description\" @slotchange=${this._syncSlotContent}>${this.description}</slot>\n        </div>\n        <div class=${classMap({ 'empty-action': true, 'is-hidden': !this._hasActionSlot })}>\n          <slot name=\"action\" @slotchange=${this._syncSlotContent}></slot>\n        </div>\n      </section>\n    `\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'web-ui-empty': WebUiEmpty\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/empty/index.ts"],"sourcesContent":["import '@/components/icon'\n\nimport { html, LitElement, unsafeCSS } from 'lit'\nimport { customElement, property, state } from 'lit/decorators.js'\nimport { classMap } from 'lit/directives/class-map.js'\n\nimport { lucideInbox } from '@/icons'\n\nimport style from './style.css?inline'\n\n/**\n * icon 容器边长默认值（px），也是非法输入的回退目标。\n */\nconst DEFAULT_SIZE = 56\n\n/**\n * 派生度量统一除以 7。取 7 是为了让默认档 56 整除出改前 medium 的四个值：字形 3/7 → 24、\n * min-height 30/7 → 240、padding 块 4/7 → 32、padding 行 3/7 → 24。40 与 72 因此落到\n * 171 / 23 / 17 与 309 / 41 / 31，字形 17 与 31。\n */\nconst DERIVED_DENOMINATOR = 7\nconst GLYPH_NUMERATOR = 3\nconst MIN_HEIGHT_NUMERATOR = 30\nconst PADDING_BLOCK_NUMERATOR = 4\nconst PADDING_INLINE_NUMERATOR = 3\n\n/**\n * 字号只有两档，阈值与默认边长同为 56：低于阈值取改前 small 的字号，其余取改前 medium 的\n * 字号。大尺寸靠留白撑开而不是靠字变大，所以 72 与 56 同档。\n */\nconst COMPACT_SIZE_THRESHOLD = 56\nconst COMPACT_TITLE_FONT_SIZE = 14\nconst COMPACT_DESCRIPTION_FONT_SIZE = 13\nconst DEFAULT_TITLE_FONT_SIZE = 16\nconst DEFAULT_DESCRIPTION_FONT_SIZE = 14\n\n/**\n * 只做数值合法性判断，不做枚举映射：有限正数原样采用，其余输入（NaN、±Infinity、0、负数）\n * 回退默认边长。\n *\n * 这一层是必要的：`size` 会同时写进 `--wui-internal-empty-size`，未守卫时\n * `size=\"abc\"` 会产出失效的 `NaNpx`（盒退回 unset 而涨成 300×300），\n * `size=\"\"` 会产出 `0px`（icon 不可见）。回退的是边长本身，整套派生度量因此一起回到默认档\n * 56，而不是按 `NaN` 算出垃圾值。\n */\nconst normalizeSize = (value: number): number => (Number.isFinite(value) && value > 0 ? value : DEFAULT_SIZE)\n\n@customElement('web-ui-empty')\nexport class WebUiEmpty extends LitElement {\n  static override styles = [unsafeCSS(style)]\n\n  @property({ type: String, reflect: true }) override title = ''\n\n  @property({ type: String, reflect: true }) description = ''\n\n  /**\n   * 版面缩放基准，单位 px，默认 56。驱动 icon 盒、min-height、padding 与标题/描述字号，\n   * 使大 icon 不再配 medium 留白。\n   *\n   * 派生规则：icon 容器边长即 `size`，默认字形边长 `round(size * 3 / 7)`，min-height\n   * `round(size * 30 / 7)`，padding 块 `round(size * 4 / 7)`、行 `round(size * 3 / 7)`；\n   * 字号在 56 处分两档，低于 56 为 14px / 13px，56 及以上为 16px / 14px。段间距与内容宽度\n   * 不随它变化。\n   *\n   * 派生值全部落在 `--wui-internal-empty-*` 上，`--wui-empty-*` 仍压在其上，所以逐项覆盖\n   * 优先于本属性。非法输入（非有限数、0、负数）回退默认边长 56。\n   */\n  @property({ type: Number, reflect: true })\n  get size(): number {\n    return this._size\n  }\n\n  set size(value: number) {\n    const old = this._size\n    const normalized = normalizeSize(value)\n    if (normalized === old) return\n    this._size = normalized\n    this.requestUpdate('size', old)\n  }\n\n  private _size = DEFAULT_SIZE\n\n  private get _iconSize(): number {\n    return Math.round((this.size * GLYPH_NUMERATOR) / DERIVED_DENOMINATOR)\n  }\n\n  /**\n   * `size` 派生的整套度量。CSS 侧按 `var(--wui-empty-*, var(--wui-internal-empty-*, 默认值))`\n   * 消费，公开 token 因此始终压在派生值之上。\n   */\n  private get _sizeStyle(): Record<string, string> {\n    const size = this.size\n    const compact = size < COMPACT_SIZE_THRESHOLD\n    const scaled = (numerator: number) => `${Math.round((size * numerator) / DERIVED_DENOMINATOR)}px`\n    return {\n      '--wui-internal-empty-size': `${size}px`,\n      '--wui-internal-empty-min-height': scaled(MIN_HEIGHT_NUMERATOR),\n      '--wui-internal-empty-padding-block': scaled(PADDING_BLOCK_NUMERATOR),\n      '--wui-internal-empty-padding-inline': scaled(PADDING_INLINE_NUMERATOR),\n      '--wui-internal-empty-title-font-size': `${compact ? COMPACT_TITLE_FONT_SIZE : DEFAULT_TITLE_FONT_SIZE}px`,\n      '--wui-internal-empty-description-font-size': `${\n        compact ? COMPACT_DESCRIPTION_FONT_SIZE : DEFAULT_DESCRIPTION_FONT_SIZE\n      }px`\n    }\n  }\n\n  @state() private _hasTitleSlot = false\n  @state() private _hasDescriptionSlot = false\n  @state() private _hasActionSlot = false\n\n  override connectedCallback() {\n    super.connectedCallback()\n    this._syncSlotContent()\n  }\n\n  protected override updated() {\n    // 无条件写：条件写同样覆盖得到默认实例（实测首次 changedProperties 里带 size）。\n    // 这里换来的不变量是「派生 token 永远与当前 size 一致」——将来新增派生 token 不必\n    // 再补一处 changed 判断，而同值 setProperty 不触发样式失效，代价可忽略。\n    for (const [token, value] of Object.entries(this._sizeStyle)) {\n      this.style.setProperty(token, value)\n    }\n  }\n\n  private _syncSlotContent = () => {\n    this._hasTitleSlot = this._hasAssignedContent()\n    this._hasDescriptionSlot = this._hasAssignedContent('description')\n    this._hasActionSlot = this._hasAssignedContent('action')\n  }\n\n  private _hasAssignedContent(slotName?: string): boolean {\n    return [...this.childNodes].some(node => {\n      if (node instanceof HTMLElement && (node.getAttribute('slot') ?? '') === (slotName ?? '')) return true\n      return !slotName && node.nodeType === Node.TEXT_NODE && Boolean(node.textContent?.trim())\n    })\n  }\n\n  override render() {\n    const showTitle = this._hasTitleSlot || Boolean(this.title)\n    const showDescription = this._hasDescriptionSlot || Boolean(this.description)\n\n    return html`\n      <section class=\"empty\">\n        <div class=\"empty-icon\" aria-hidden=\"true\">\n          <slot name=\"icon\"><web-ui-icon .icon=${lucideInbox} .size=${this._iconSize}></web-ui-icon></slot>\n        </div>\n        <div class=${classMap({ 'empty-title': true, 'is-hidden': !showTitle })}>\n          <slot @slotchange=${this._syncSlotContent}>${this.title}</slot>\n        </div>\n        <div class=${classMap({ 'empty-description': true, 'is-hidden': !showDescription })}>\n          <slot name=\"description\" @slotchange=${this._syncSlotContent}>${this.description}</slot>\n        </div>\n        <div class=${classMap({ 'empty-action': true, 'is-hidden': !this._hasActionSlot })}>\n          <slot name=\"action\" @slotchange=${this._syncSlotContent}></slot>\n        </div>\n      </section>\n    `\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'web-ui-empty': WebUiEmpty\n  }\n}\n"],"mappings":"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"}

package/dist/components/image-preview/index.d.ts

@@ -13,13 +13,13 @@ export interface ImagePreviewOptions {
     target?: Element;
     /** 显式挂载容器，优先级高于 target 和主题作用域。 */
     container?: HTMLElement;
-    /** 展示上一张 / 下一张按钮；仅在图片多于一张时渲染。默认 false。 */
+    /** 展示上一张 / 下一张 button；仅在图片多于一张时渲染。默认 false。 */
     nav?: boolean;
     /** 展示缩放工具条。默认 false。 */
     toolbar?: boolean;
-    /** 展示关闭按钮。默认 false。 */
+    /** 展示关闭 button。默认 false。 */
     closable?: boolean;
-    /** 展示「当前 / 总数」指示器。默认 false。 */
+    /** 展示「当前 / 总数」indicator。默认 false。 */
     indicator?: boolean;
     /**
      * 1x 且图片多于一张时，允许左右滑动切换图片：该手势接管整个拖拽，纵向位移被忽略
@@ -49,10 +49,10 @@ export interface ImagePreviewHandle {
     close(): void;
 }
 /**
- * 打开一个命令式图片预览。
+ * 打开一个命令式 image preview。
  *
  * 组件挂载到目标 `web-ui-theme` 的 overlay 容器（无主题作用域时回退到全局
- * fallback root），返回的句柄是唯一的控制入口。所有展示类选项默认关闭，
+ * fallback root），返回的 handle 是唯一的控制入口。所有展示类 option 默认关闭，
  * 默认只渲染图片本身。
  */
 export declare function imagePreview(options: ImagePreviewOptions): ImagePreviewHandle;

package/dist/components/image-preview/index.js

@@ -1,6 +1,6 @@
 import e from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
 import "../icon/index.js";
-import t from "../../assets/glass.js";
+import t from "../../classes/glass.js";
 import n from "../../icons/generated/lucide-chevron-left.js";
 import r from "../../icons/generated/lucide-chevron-right.js";
 import i from "../../icons/generated/lucide-plus.js";
@@ -267,7 +267,7 @@ var O = 1, k = 4, A = .5, j = .002, M = 3, N = .15, P = 320, F = 16, I = 160, L
 	}
 	_adjacentIndex(e) {
 		let t = this.images.length;
-		if (t === 0) return -1;
+		if (t <= 1) return -1;
 		if (this.loop) return ((this._index + e) % t + t) % t;
 		let n = this._index + e;
 		return n >= 0 && n < t ? n : -1;
@@ -302,7 +302,7 @@ var O = 1, k = 4, A = .5, j = .002, M = 3, N = .15, P = 320, F = 16, I = 160, L
 		let e = this.images.length, t = this._scale > O, c = e > 0 ? this._adjacentIndex(-1) : -1, l = e > 0 ? this._adjacentIndex(1) : -1, u = `translate3d(${this._swipeOffset}px, 0, 0)`, d = `translate3d(${this._offsetX}px, ${this._offsetY}px, 0) scale(${this._scale})`, f = t ? "translate3d(0, 0, 0) scale(1)" : `translate3d(0, ${this._offsetY}px, 0) scale(1)`;
 		return b`
       <dialog
-        aria-label="图片预览"
+        aria-label="Image preview"
         @cancel=${this._handleCancel}
         @close=${this._handleNativeClose}
         @pointerdown=${this._handlePointerDown}
@@ -392,7 +392,7 @@ var O = 1, k = 4, A = .5, j = .002, M = 3, N = .15, P = 320, F = 16, I = 160, L
                       variant="glass"
                       icon
                       size="36"
-                      aria-label="关闭"
+                      aria-label="Close"
                       @click=${this.close}
                     >
                       <web-ui-icon size="16" .icon=${o}></web-ui-icon>
@@ -404,7 +404,7 @@ var O = 1, k = 4, A = .5, j = .002, M = 3, N = .15, P = 320, F = 16, I = 160, L
                       variant="glass"
                       icon
                       size="44"
-                      aria-label="上一张"
+                      aria-label="Previous image"
                       ?disabled=${!this.loop && this._index === 0}
                       @click=${this.prev}
                     >
@@ -415,7 +415,7 @@ var O = 1, k = 4, A = .5, j = .002, M = 3, N = .15, P = 320, F = 16, I = 160, L
                       variant="glass"
                       icon
                       size="44"
-                      aria-label="下一张"
+                      aria-label="Next image"
                       ?disabled=${!this.loop && this._index === e - 1}
                       @click=${this.next}
                     >
@@ -428,7 +428,7 @@ var O = 1, k = 4, A = .5, j = .002, M = 3, N = .15, P = 320, F = 16, I = 160, L
                         variant="glass"
                         icon
                         size="30"
-                        aria-label="缩小"
+                        aria-label="Zoom out"
                         ?disabled=${this._scale <= O}
                         @click=${this.zoomOut}
                       >
@@ -439,7 +439,7 @@ var O = 1, k = 4, A = .5, j = .002, M = 3, N = .15, P = 320, F = 16, I = 160, L
                         variant="glass"
                         icon
                         size="30"
-                        aria-label="放大"
+                        aria-label="Zoom in"
                         ?disabled=${this._scale >= k}
                         @click=${this.zoomIn}
                       >
@@ -449,7 +449,7 @@ var O = 1, k = 4, A = .5, j = .002, M = 3, N = .15, P = 320, F = 16, I = 160, L
                         variant="glass"
                         icon
                         size="30"
-                        aria-label="重置缩放"
+                        aria-label="Reset zoom"
                         ?disabled=${this._scale <= O && !this._isPanned}
                         @click=${this.resetZoom}
                       >