/**
 * settingsDom.ts — 官方设置弹窗的 DOM 契约（official/ 层）。
 *
 * official/ 只做一件事：**找到并描述**宿主节点，不替消费方做决策 —— 加类、
 * 改样式、拦事件都留在 patches/ 与 motion/。这里每个函数都是纯探测：命中就
 * 返回节点或几何值，未命中安静返回 null（宿主是 CSS-module hash 的上游包，
 * 结构变了要降级成"没找到"，不能抛错）。
 *
 * 宿主（@deepseek-ai/dsh-client-ui-settings-general 的 SettingsRoot）结构：
 *
 *   div.overlay[role="presentation"]
 *     ├── div.mask[aria-hidden="true"]                      ← 弹窗的前一个兄弟
 *     └── div.panel[role="dialog"][aria-modal="true"]
 *           ├── nav > div.navList                           ← 左侧 tab 列
 *           └── div.content > div.header > (div.actions, button.close)
 *
 * 两个消费方对"这是不是设置弹窗"的口径本来就不一样，本模块把两种口径收在一处
 * （而不是让它们各自维护一份假设）：
 * - `findDialogWithNavRail()` 宽口径：modal dialog + 直接子级 nav。窗口化补丁用它 ——
 *   补丁只改外框尺寸/位置，认错弹窗的代价仅是多给一个弹窗加了把手；
 * - `isSettingsDialog()` / `findSettingsDialog()` 严口径：再要求"挂在 role=presentation
 *   层里、且紧邻自己的遮罩"。动效引擎用它 —— 它要拦关闭点击，把别的插件的可
 *   导航弹窗当成设置面板会吞掉不属于它的交互。
 */
/**
 * 设置弹窗选择器：带 `aria-modal` 的 dialog。
 *
 * 历史上两份声明不一致（`div[role="dialog"]…` 与 `[role="dialog"]…`）。实测宿主现存
 * 四个 modal 实现（ui-settings-general/SettingsRoot、ui-primitives/Modal、
 * ui-primitives/ImageLightbox、ui-settings-account/PlatformOverlay）渲染的都是
 * `<div role="dialog" aria-modal="true">`，两种写法在真实 DOM 上等价；取带 `div`
 * 前缀这份更精确（不会匹配将来可能出现的非 div 自定义元素），故统一到它。
 */
export declare const SETTINGS_DIALOG_SELECTOR = "div[role=\"dialog\"][aria-modal=\"true\"]";
/**
 * 设置弹窗挂载层：壳组件用 `role="presentation"` 的 overlay 承载遮罩与弹窗。
 * It is the one structural fact that tells the settings modal apart from any other
 * modal that happens to render a nav rail.
 */
export declare const OVERLAY_ROLE = "presentation";
/**
 * The panel's own mask: the `aria-hidden` sibling immediately before it. A
 * sibling that CONTAINS the panel is a container, not a mask - returning it would
 * make `mask.contains(target)` true for every click in the page and swallow them
 * all.
 * @param dialog - the settings dialog.
 */
export declare function maskOf(dialog: Element): HTMLElement | null;
/**
 * True for the host settings dialog: a modal dialog with a nav rail, mounted in
 * the shell's `role="presentation"` layer next to its own mask. Requiring that
 * layer and the mask sibling matters - "modal + nav" alone also accepts other
 * plugins' navigable modals, and taking one of those for the panel made this
 * engine intercept clicks that are none of its business.
 * @param node - a candidate dialog element.
 */
export declare function isSettingsDialog(node: Element): boolean;
/**
 * 严口径查找：第一个真正的设置弹窗（见 `isSettingsDialog()`），没有则 null。
 *
 * 与 `findDialogWithNavRail()` 的差别：这里额外要求 overlay 层与遮罩兄弟，
 * 且 nav 只要求"存在"（任意深度）—— 动效引擎的关闭拦截宁可漏认，也不认错。
 */
export declare function findSettingsDialog(): HTMLElement | null;
/**
 * 宽口径查找：第一个"modal dialog 且直接子级含 <nav>"的弹窗（排除其它 dialog）。
 *
 * 窗口化补丁用它：补丁不改事件、不改内容，只把外框变成可拖拽窗口，因此在
 * 结构残缺（没有 overlay/遮罩）时也照常工作 —— 这也是它和严口径同时存在的原因。
 */
export declare function findDialogWithNavRail(): HTMLElement | null;
/** The settings trigger: the shell button that opens the dialog. */
export declare const TRIGGER_SELECTOR = "button[aria-haspopup=\"dialog\"]";
/**
 * Pick the button the panel opened from. The pointer's own button wins. A
 * shortcut-opened panel has none, and the shell trigger is no longer unique:
 * since 0.1.7 the context meter, the stats pills and the usage panels all
 * declare `aria-haspopup="dialog"`, so taking the document's first match can
 * anchor the panel to a control on the far side of the viewport.
 * @param dialog - the live settings dialog.
 * @param pressed - the most recent button pressed by the pointer, if any.
 */
export declare function settingsTrigger(dialog: HTMLElement, pressed: HTMLElement | null): HTMLElement | null;
/**
 * The scale anchor for the panel: the centre of the settings trigger in the
 * panel's own coordinate space, so the panel grows out of the button instead
 * of the viewport centre. Returns null when no trigger is measurable (jsdom,
 * detached markup).
 * @param dialog - the live settings dialog.
 * @param pressed - the most recent button pressed by the pointer, if any.
 */
export declare function triggerOrigin(dialog: HTMLElement, pressed: HTMLElement | null): {
    x: number;
    y: number;
} | null;
/** The panel's scrolling content column (the nav rail's sibling). */
export declare function contentOf(dialog: HTMLElement): HTMLElement | null;
/**
 * 找左侧 tab 列表容器：nav 下首个含 button 的 div（= navList）。
 * 官方结构 navTitle（无 button）在前、navList（多个 navCell button）在后；
 * 用"含 button"判定比固定索引更抗标题区变化。
 */
export declare function findNavList(dialog: HTMLElement): HTMLElement | null;
/**
 * 右下角缩放把手的身标记属性。补丁用它判断"这个弹窗已经装过把手"，宿主与
 * 样式表都不认识它，因此值必须保持稳定（改值 = 已装把手的弹窗会被重复注入）。
 */
export declare const RESIZE_HANDLE_ATTR = "data-width-slider-resize-handle";
/**
 * Words that name a close control. The host close button carries its
 * accessible name as visually-hidden slot text, so the button's own text IS
 * the localized word for "close". The length cap keeps a long paragraph that
 * happens to start with one of these words from matching.
 */
export declare const CLOSE_LABEL: RegExp;
/** Whether a button names itself as a close control. */
export declare function isCloseButton(button: HTMLElement): boolean;
/**
 * Whether the button is the dialog header's own close control. The header is
 * the content column's first child and the close button is its direct child
 * (the action seat sits in a nested element); this structural check keeps the
 * exit working when the localized label changes.
 * @param dialog - the live settings dialog.
 * @param button - the pressed button.
 */
export declare function isHeaderCloseButton(dialog: HTMLElement, button: HTMLElement): boolean;
/**
 * Whether an inner floating layer owns the interaction: an open Menu (the
 * settings page renders several, portaled to the body) or a nested modal.
 * Those consume Escape and outside-clicks themselves, so the close paths must
 * let the event through instead of shrinking the whole panel.
 * @param dialog - the live settings dialog.
 */
export declare function innerLayerOpen(dialog: HTMLElement): boolean;