@zerodep-dev/vue-tsx-pro-ui 0.0.0-stage → 0.1.0

package/dist/utils/data/workdays.d.ts

@@ -0,0 +1,67 @@
+/** 工作日历：哪天上班 */
+export interface WorkCalendar {
+    /** 这一天（ISO 日期）上不上班 */
+    isWorkday(iso: string): boolean;
+}
+/** createWorkCalendar 的选项 */
+export interface WorkCalendarOptions {
+    /** 休息的星期几（0 周日 … 6 周六），默认周六、周日 */
+    weekend?: readonly number[];
+    /** 放假的日子：ISO 日期，或 [开始, 结束]（含两端） */
+    holidays?: readonly (string | readonly [string, string])[];
+    /** 调休上班的日子（落在周末的补班） */
+    workdays?: readonly string[];
+}
+/** 按周末、节假日与调休生成工作日历 */
+export declare function createWorkCalendar({ weekend, holidays, workdays, }?: WorkCalendarOptions): WorkCalendar;
+/** 只按周末（周六、周日）算的工作日历：没配置 workCalendar 时用它 */
+export declare const weekdayCalendar: WorkCalendar;
+/**
+ * from 之后到 to（含）有几个工作日：周五到下周一是 1；to 在 from 之前时为负数（两端对调再取负，同 date-fns 的方向）
+ */
+export declare function workdaysBetween(from: string, to: string, calendar?: WorkCalendar): number;
+/** 从 from 起数 count 个工作日后的那一天（count 为负往前数，为 0 时原样） */
+export declare function addWorkdays(from: string, count: number, calendar?: WorkCalendar): string;
+/** 时限的状态 */
+export interface DeadlineStates {
+    /** 还早 */
+    pending: unknown;
+    /** 快到期：剩下的工作日不多于 soon */
+    soon: unknown;
+    /** 今天到期 */
+    due: unknown;
+    /** 超期 */
+    overdue: unknown;
+    /** 已完成（按完成那天算剩余或超期） */
+    done: unknown;
+}
+/** 时限：截止日直接给出，或开始日加几个工作日 */
+export type DeadlineInput = ({
+    due: string;
+    start?: never;
+    workdays?: never;
+} | {
+    start: string;
+    workdays: number;
+    due?: never;
+}) & {
+    /** 完成的日期；完成了状态是 done */
+    done?: string | null;
+    /** 今天，默认按浏览器时区的今天 */
+    today?: string;
+    /** 剩下几个工作日以内算快到期，默认 2 */
+    soon?: number;
+};
+/** 时限的结果 */
+export interface Deadline {
+    /** 截止日 */
+    due: string;
+    /** 离截止还有几个工作日：截止当天为 0，超期为负；完成了按完成那天算 */
+    remaining: number;
+    /** 状态 */
+    state: keyof DeadlineStates;
+}
+/** 算时限：截止日、还剩几个工作日、状态 */
+export declare function deadlineOf(input: DeadlineInput, calendar?: WorkCalendar): Deadline;
+/** 当前配置的工作日历（createUi / Provider 的 workCalendar；都没给时只按周末） */
+export declare function useWorkCalendar(): WorkCalendar;

package/dist/utils/data/workdays.js

@@ -0,0 +1,67 @@
+import { useConfig } from "../../config/context.js";
+import { isoDayOfWeek, shiftIsoDate, todayIso } from "./date.js";
+//#region src/utils/data/workdays.ts
+/**
+* 工作日与时限（参考 date-fns 的 addBusinessDays、differenceInBusinessDays）：周末、法定节假日与调休补班。
+* 节假日每年发布一次，组件库不内置：应用把数据交给 createUi / Provider 的 workCalendar，组件经 useWorkCalendar 取用。
+*
+*   const workCalendar = createWorkCalendar({
+*     holidays: [['2026-10-01', '2026-10-08']],   // 放假（单日或区间）
+*     workdays: ['2026-09-27', '2026-10-10'],     // 调休上班的周末
+*   });
+*   createUi({ workCalendar });
+*
+*   const calendar = useWorkCalendar();
+*   deadlineOf({ start: verifiedOn, workdays: 10 }, calendar)   // → { due, remaining, state }
+*/
+/** 按周末、节假日与调休生成工作日历 */
+function createWorkCalendar({ weekend = [0, 6], holidays = [], workdays = [] } = {}) {
+	const off = /* @__PURE__ */ new Set();
+	for (const entry of holidays) if (typeof entry === "string") off.add(entry);
+	else for (let day = entry[0]; day <= entry[1]; day = shiftIsoDate(day, { days: 1 })) off.add(day);
+	const on = new Set(workdays);
+	return { isWorkday: (iso) => on.has(iso) || !off.has(iso) && !weekend.includes(isoDayOfWeek(iso)) };
+}
+/** 只按周末（周六、周日）算的工作日历：没配置 workCalendar 时用它 */
+var weekdayCalendar = createWorkCalendar();
+/**
+* from 之后到 to（含）有几个工作日：周五到下周一是 1；to 在 from 之前时为负数（两端对调再取负，同 date-fns 的方向）
+*/
+function workdaysBetween(from, to, calendar = weekdayCalendar) {
+	if (to < from) return 0 - workdaysBetween(to, from, calendar);
+	let count = 0;
+	for (let day = from; day < to;) {
+		day = shiftIsoDate(day, { days: 1 });
+		if (calendar.isWorkday(day)) count++;
+	}
+	return count;
+}
+/** 从 from 起数 count 个工作日后的那一天（count 为负往前数，为 0 时原样） */
+function addWorkdays(from, count, calendar = weekdayCalendar) {
+	const step = count >= 0 ? 1 : -1;
+	let day = from;
+	for (let left = Math.abs(count); left > 0;) {
+		day = shiftIsoDate(day, { days: step });
+		if (calendar.isWorkday(day)) left--;
+	}
+	return day;
+}
+/** 算时限：截止日、还剩几个工作日、状态 */
+function deadlineOf(input, calendar = weekdayCalendar) {
+	const due = input.due ?? addWorkdays(input.start, input.workdays, calendar);
+	const at = input.done ?? input.today ?? todayIso();
+	const remaining = workdaysBetween(at, due, calendar);
+	return {
+		due,
+		remaining,
+		state: input.done ? "done" : at > due ? "overdue" : at === due ? "due" : remaining <= (input.soon ?? 2) ? "soon" : "pending"
+	};
+}
+/** 当前配置的工作日历（createUi / Provider 的 workCalendar；都没给时只按周末） */
+function useWorkCalendar() {
+	return useConfig().workCalendar ?? weekdayCalendar;
+}
+//#endregion
+export { addWorkdays, createWorkCalendar, deadlineOf, useWorkCalendar, weekdayCalendar, workdaysBetween };
+
+//# sourceMappingURL=workdays.js.map

package/dist/utils/data/workdays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workdays.js","names":[],"sources":["../../../src/utils/data/workdays.ts"],"sourcesContent":["/**\n * 工作日与时限（参考 date-fns 的 addBusinessDays、differenceInBusinessDays）：周末、法定节假日与调休补班。\n * 节假日每年发布一次，组件库不内置：应用把数据交给 createUi / Provider 的 workCalendar，组件经 useWorkCalendar 取用。\n *\n *   const workCalendar = createWorkCalendar({\n *     holidays: [['2026-10-01', '2026-10-08']],   // 放假（单日或区间）\n *     workdays: ['2026-09-27', '2026-10-10'],     // 调休上班的周末\n *   });\n *   createUi({ workCalendar });\n *\n *   const calendar = useWorkCalendar();\n *   deadlineOf({ start: verifiedOn, workdays: 10 }, calendar)   // → { due, remaining, state }\n */\nimport { useConfig } from '../../config/context';\nimport { isoDayOfWeek, shiftIsoDate, todayIso } from './date';\n\n/** 工作日历：哪天上班 */\nexport interface WorkCalendar {\n  /** 这一天（ISO 日期）上不上班 */\n  isWorkday(iso: string): boolean;\n}\n\n/** createWorkCalendar 的选项 */\nexport interface WorkCalendarOptions {\n  /** 休息的星期几（0 周日 … 6 周六），默认周六、周日 */\n  weekend?: readonly number[];\n  /** 放假的日子：ISO 日期，或 [开始, 结束]（含两端） */\n  holidays?: readonly (string | readonly [string, string])[];\n  /** 调休上班的日子（落在周末的补班） */\n  workdays?: readonly string[];\n}\n\n/** 按周末、节假日与调休生成工作日历 */\nexport function createWorkCalendar({\n  weekend = [0, 6],\n  holidays = [],\n  workdays = [],\n}: WorkCalendarOptions = {}): WorkCalendar {\n  const off = new Set<string>();\n  for (const entry of holidays) {\n    if (typeof entry === 'string') off.add(entry);\n    else\n      for (let day = entry[0]; day <= entry[1]; day = shiftIsoDate(day, { days: 1 })) off.add(day);\n  }\n  const on = new Set(workdays);\n  return {\n    isWorkday: (iso) => on.has(iso) || (!off.has(iso) && !weekend.includes(isoDayOfWeek(iso))),\n  };\n}\n\n/** 只按周末（周六、周日）算的工作日历：没配置 workCalendar 时用它 */\nexport const weekdayCalendar: WorkCalendar = createWorkCalendar();\n\n/**\n * from 之后到 to（含）有几个工作日：周五到下周一是 1；to 在 from 之前时为负数（两端对调再取负，同 date-fns 的方向）\n */\nexport function workdaysBetween(from: string, to: string, calendar = weekdayCalendar): number {\n  // 0 - x 而不是 -x：相差 0 个工作日时得 0，不是 -0\n  if (to < from) return 0 - workdaysBetween(to, from, calendar);\n  let count = 0;\n  for (let day = from; day < to;) {\n    day = shiftIsoDate(day, { days: 1 });\n    if (calendar.isWorkday(day)) count++;\n  }\n  return count;\n}\n\n/** 从 from 起数 count 个工作日后的那一天（count 为负往前数，为 0 时原样） */\nexport function addWorkdays(from: string, count: number, calendar = weekdayCalendar): string {\n  const step = count >= 0 ? 1 : -1;\n  let day = from;\n  for (let left = Math.abs(count); left > 0;) {\n    day = shiftIsoDate(day, { days: step });\n    if (calendar.isWorkday(day)) left--;\n  }\n  return day;\n}\n\n/** 时限的状态 */\nexport interface DeadlineStates {\n  /** 还早 */\n  pending: unknown;\n  /** 快到期：剩下的工作日不多于 soon */\n  soon: unknown;\n  /** 今天到期 */\n  due: unknown;\n  /** 超期 */\n  overdue: unknown;\n  /** 已完成（按完成那天算剩余或超期） */\n  done: unknown;\n}\n\n/** 时限：截止日直接给出，或开始日加几个工作日 */\nexport type DeadlineInput = (\n  | { due: string; start?: never; workdays?: never }\n  | { start: string; workdays: number; due?: never }\n) & {\n  /** 完成的日期；完成了状态是 done */\n  done?: string | null;\n  /** 今天，默认按浏览器时区的今天 */\n  today?: string;\n  /** 剩下几个工作日以内算快到期，默认 2 */\n  soon?: number;\n};\n\n/** 时限的结果 */\nexport interface Deadline {\n  /** 截止日 */\n  due: string;\n  /** 离截止还有几个工作日：截止当天为 0，超期为负；完成了按完成那天算 */\n  remaining: number;\n  /** 状态 */\n  state: keyof DeadlineStates;\n}\n\n/** 算时限：截止日、还剩几个工作日、状态 */\nexport function deadlineOf(input: DeadlineInput, calendar = weekdayCalendar): Deadline {\n  const due = input.due ?? addWorkdays(input.start, input.workdays, calendar);\n  const at = input.done ?? input.today ?? todayIso();\n  const remaining = workdaysBetween(at, due, calendar);\n  // 是否过期按日期比：周五截止、周六还没完成也算超期（虽然中间没有工作日）\n  const state: keyof DeadlineStates = input.done\n    ? 'done'\n    : at > due\n      ? 'overdue'\n      : at === due\n        ? 'due'\n        : remaining <= (input.soon ?? 2)\n          ? 'soon'\n          : 'pending';\n  return { due, remaining, state };\n}\n\n/** 当前配置的工作日历（createUi / Provider 的 workCalendar；都没给时只按周末） */\nexport function useWorkCalendar(): WorkCalendar {\n  return useConfig().workCalendar ?? weekdayCalendar;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAiCA,SAAgB,mBAAmB,EACjC,UAAU,CAAC,GAAG,CAAC,GACf,WAAW,CAAC,GACZ,WAAW,CAAC,MACW,CAAC,GAAiB;CACzC,MAAM,sBAAM,IAAI,IAAY;CAC5B,KAAK,MAAM,SAAS,UAClB,IAAI,OAAO,UAAU,UAAU,IAAI,IAAI,KAAK;MAE1C,KAAK,IAAI,MAAM,MAAM,IAAI,OAAO,MAAM,IAAI,MAAM,aAAa,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,IAAI,GAAG;CAE/F,MAAM,KAAK,IAAI,IAAI,QAAQ;CAC3B,OAAO,EACL,YAAY,QAAQ,GAAG,IAAI,GAAG,KAAM,CAAC,IAAI,IAAI,GAAG,KAAK,CAAC,QAAQ,SAAS,aAAa,GAAG,CAAC,EAC1F;AACF;;AAGA,IAAa,kBAAgC,mBAAmB;;;;AAKhE,SAAgB,gBAAgB,MAAc,IAAY,WAAW,iBAAyB;CAE5F,IAAI,KAAK,MAAM,OAAO,IAAI,gBAAgB,IAAI,MAAM,QAAQ;CAC5D,IAAI,QAAQ;CACZ,KAAK,IAAI,MAAM,MAAM,MAAM,KAAK;EAC9B,MAAM,aAAa,KAAK,EAAE,MAAM,EAAE,CAAC;EACnC,IAAI,SAAS,UAAU,GAAG,GAAG;CAC/B;CACA,OAAO;AACT;;AAGA,SAAgB,YAAY,MAAc,OAAe,WAAW,iBAAyB;CAC3F,MAAM,OAAO,SAAS,IAAI,IAAI;CAC9B,IAAI,MAAM;CACV,KAAK,IAAI,OAAO,KAAK,IAAI,KAAK,GAAG,OAAO,IAAI;EAC1C,MAAM,aAAa,KAAK,EAAE,MAAM,KAAK,CAAC;EACtC,IAAI,SAAS,UAAU,GAAG,GAAG;CAC/B;CACA,OAAO;AACT;;AAwCA,SAAgB,WAAW,OAAsB,WAAW,iBAA2B;CACrF,MAAM,MAAM,MAAM,OAAO,YAAY,MAAM,OAAO,MAAM,UAAU,QAAQ;CAC1E,MAAM,KAAK,MAAM,QAAQ,MAAM,SAAS,SAAS;CACjD,MAAM,YAAY,gBAAgB,IAAI,KAAK,QAAQ;CAWnD,OAAO;EAAE;EAAK;EAAW,OATW,MAAM,OACtC,SACA,KAAK,MACH,YACA,OAAO,MACL,QACA,cAAc,MAAM,QAAQ,KAC1B,SACA;CACqB;AACjC;;AAGA,SAAgB,kBAAgC;CAC9C,OAAO,UAAU,CAAC,CAAC,gBAAgB;AACrC"}

package/dist/utils/dom/announcer.d.ts

@@ -0,0 +1,11 @@
+/** 播报的紧迫程度 */
+export interface Politenesses {
+    /** 等读屏念完当前的内容再念（默认）：选中条数、搜索结果、已复制 */
+    polite: unknown;
+    /** 打断当前的朗读：出错、操作失败 */
+    assertive: unknown;
+}
+/** 播报的紧迫程度 */
+export type Politeness = keyof Politenesses;
+/** 让读屏念出一句话；同一句话连说两次也会念（先清空，稍后再写入）。没有 document（服务端）时什么也不做 */
+export declare function announce(message: string, politeness?: Politeness): void;

package/dist/utils/dom/announcer.js

@@ -0,0 +1,53 @@
+import { topModal } from "./overlay.js";
+//#region src/utils/dom/announcer.ts
+/**
+* 读屏播报（参考 React Aria 的 LiveAnnouncer）：整页共用两个常驻的 aria-live 区域（polite 与 assertive），
+* 组件不再各自挂播报区。读屏只念已经存在的区域里的变化，随内容一起插入的 aria-live 区域常常不念，第一句就丢了。
+*
+*   announce(lang.tableSelectedCount(3));
+*   announce('保存失败', 'assertive');
+*
+* 有模态对话框打开时区域挂进最上层的对话框：showModal 让对话框外面的内容对读屏失效。
+*/
+/** 只给读屏的区域：视觉上隐藏（同 VisuallyHidden；这里是命令式创建的元素，直接写行内样式） */
+var SR_ONLY = {
+	position: "absolute",
+	width: "1px",
+	height: "1px",
+	margin: "-1px",
+	padding: "0",
+	overflow: "hidden",
+	clipPath: "inset(50%)",
+	whiteSpace: "nowrap",
+	border: "0"
+};
+/** 清空与写入之间隔多久（毫秒）：同一帧里改两次，读屏只看到最后的结果，重复的话就不念了 */
+var REPEAT_DELAY = 100;
+var regions = /* @__PURE__ */ new Map();
+var timers = /* @__PURE__ */ new Map();
+function region(politeness) {
+	let element = regions.get(politeness);
+	if (!element) {
+		element = document.createElement("div");
+		element.setAttribute("aria-live", politeness);
+		element.setAttribute("aria-atomic", "true");
+		element.dataset.liveAnnouncer = politeness;
+		Object.assign(element.style, SR_ONLY);
+		regions.set(politeness, element);
+	}
+	const host = topModal() ?? document.body;
+	if (element.parentElement !== host) host.append(element);
+	return element;
+}
+/** 让读屏念出一句话；同一句话连说两次也会念（先清空，稍后再写入）。没有 document（服务端）时什么也不做 */
+function announce(message, politeness = "polite") {
+	if (typeof document === "undefined" || !message) return;
+	const element = region(politeness);
+	element.textContent = "";
+	clearTimeout(timers.get(politeness));
+	timers.set(politeness, setTimeout(() => element.textContent = message, REPEAT_DELAY));
+}
+//#endregion
+export { announce };
+
+//# sourceMappingURL=announcer.js.map

package/dist/utils/dom/announcer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcer.js","names":[],"sources":["../../../src/utils/dom/announcer.ts"],"sourcesContent":["/**\n * 读屏播报（参考 React Aria 的 LiveAnnouncer）：整页共用两个常驻的 aria-live 区域（polite 与 assertive），\n * 组件不再各自挂播报区。读屏只念已经存在的区域里的变化，随内容一起插入的 aria-live 区域常常不念，第一句就丢了。\n *\n *   announce(lang.tableSelectedCount(3));\n *   announce('保存失败', 'assertive');\n *\n * 有模态对话框打开时区域挂进最上层的对话框：showModal 让对话框外面的内容对读屏失效。\n */\nimport { topModal } from './overlay';\n\n/** 播报的紧迫程度 */\nexport interface Politenesses {\n  /** 等读屏念完当前的内容再念（默认）：选中条数、搜索结果、已复制 */\n  polite: unknown;\n  /** 打断当前的朗读：出错、操作失败 */\n  assertive: unknown;\n}\n\n/** 播报的紧迫程度 */\nexport type Politeness = keyof Politenesses;\n\n/** 只给读屏的区域：视觉上隐藏（同 VisuallyHidden；这里是命令式创建的元素，直接写行内样式） */\nconst SR_ONLY: Partial<CSSStyleDeclaration> = {\n  position: 'absolute',\n  width: '1px',\n  height: '1px',\n  margin: '-1px',\n  padding: '0',\n  overflow: 'hidden',\n  clipPath: 'inset(50%)',\n  whiteSpace: 'nowrap',\n  border: '0',\n};\n\n/** 清空与写入之间隔多久（毫秒）：同一帧里改两次，读屏只看到最后的结果，重复的话就不念了 */\nconst REPEAT_DELAY = 100;\n\nconst regions = new Map<Politeness, HTMLElement>();\nconst timers = new Map<Politeness, ReturnType<typeof setTimeout>>();\n\nfunction region(politeness: Politeness): HTMLElement {\n  let element = regions.get(politeness);\n  if (!element) {\n    element = document.createElement('div');\n    element.setAttribute('aria-live', politeness);\n    element.setAttribute('aria-atomic', 'true');\n    element.dataset.liveAnnouncer = politeness;\n    Object.assign(element.style, SR_ONLY);\n    regions.set(politeness, element);\n  }\n  const host = topModal() ?? document.body;\n  if (element.parentElement !== host) host.append(element);\n  return element;\n}\n\n/** 让读屏念出一句话；同一句话连说两次也会念（先清空，稍后再写入）。没有 document（服务端）时什么也不做 */\nexport function announce(message: string, politeness: Politeness = 'polite'): void {\n  if (typeof document === 'undefined' || !message) return;\n  const element = region(politeness);\n  element.textContent = '';\n  clearTimeout(timers.get(politeness));\n  timers.set(\n    politeness,\n    setTimeout(() => (element.textContent = message), REPEAT_DELAY),\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAuBA,IAAM,UAAwC;CAC5C,UAAU;CACV,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,UAAU;CACV,UAAU;CACV,YAAY;CACZ,QAAQ;AACV;;AAGA,IAAM,eAAe;AAErB,IAAM,0BAAU,IAAI,IAA6B;AACjD,IAAM,yBAAS,IAAI,IAA+C;AAElE,SAAS,OAAO,YAAqC;CACnD,IAAI,UAAU,QAAQ,IAAI,UAAU;CACpC,IAAI,CAAC,SAAS;EACZ,UAAU,SAAS,cAAc,KAAK;EACtC,QAAQ,aAAa,aAAa,UAAU;EAC5C,QAAQ,aAAa,eAAe,MAAM;EAC1C,QAAQ,QAAQ,gBAAgB;EAChC,OAAO,OAAO,QAAQ,OAAO,OAAO;EACpC,QAAQ,IAAI,YAAY,OAAO;CACjC;CACA,MAAM,OAAO,SAAS,KAAK,SAAS;CACpC,IAAI,QAAQ,kBAAkB,MAAM,KAAK,OAAO,OAAO;CACvD,OAAO;AACT;;AAGA,SAAgB,SAAS,SAAiB,aAAyB,UAAgB;CACjF,IAAI,OAAO,aAAa,eAAe,CAAC,SAAS;CACjD,MAAM,UAAU,OAAO,UAAU;CACjC,QAAQ,cAAc;CACtB,aAAa,OAAO,IAAI,UAAU,CAAC;CACnC,OAAO,IACL,YACA,iBAAkB,QAAQ,cAAc,SAAU,YAAY,CAChE;AACF"}

package/dist/utils/dom/caret.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 文本框里某个字符位置在视口中的坐标：@ 提及、斜杠命令这类跟着光标弹出的列表用它定位。
+ *
+ *   const anchor = caretAnchor(textarea, () => textarea.selectionStart);
+ *   anchorFloating(anchor, panel, { placement: 'bottom-start' });
+ *
+ * 做法同 textarea-caret-position（component/textarea-caret）：在页面外放一个镜像 div，复制影响排版的样式，
+ * 写入位置之前的文字和一个标记 span，量标记的位置，再减去文本框的滚动。input 不换行，textarea 按 pre-wrap 换行。
+ */
+import type { VirtualElement } from '@floating-ui/dom';
+/** 文本框里第 index 个字符之前（光标在那里时）的位置：视口坐标，宽 0、高一行 */
+export declare function caretRect(element: HTMLTextAreaElement | HTMLInputElement, index: number): DOMRect;
+/** 跟着光标的锚点（给 anchorFloating / useAnchoredPopover）：每次定位时按 index() 重新测量，文本框滚动时跟着更新 */
+export declare function caretAnchor(element: HTMLTextAreaElement | HTMLInputElement, index: () => number): VirtualElement;

package/dist/utils/dom/caret.js

@@ -0,0 +1,72 @@
+//#region src/utils/dom/caret.ts
+/** 影响文字排版的样式：镜像 div 照抄 */
+var MIRRORED = [
+	"direction",
+	"boxSizing",
+	"width",
+	"height",
+	"overflowX",
+	"overflowY",
+	"borderTopWidth",
+	"borderRightWidth",
+	"borderBottomWidth",
+	"borderLeftWidth",
+	"borderStyle",
+	"paddingTop",
+	"paddingRight",
+	"paddingBottom",
+	"paddingLeft",
+	"fontStyle",
+	"fontVariant",
+	"fontWeight",
+	"fontStretch",
+	"fontSize",
+	"fontSizeAdjust",
+	"lineHeight",
+	"fontFamily",
+	"fontFeatureSettings",
+	"textAlign",
+	"textTransform",
+	"textIndent",
+	"textDecoration",
+	"letterSpacing",
+	"wordSpacing",
+	"tabSize"
+];
+/** 文本框里第 index 个字符之前（光标在那里时）的位置：视口坐标，宽 0、高一行 */
+function caretRect(element, index) {
+	const style = getComputedStyle(element);
+	const mirror = document.createElement("div");
+	for (const property of MIRRORED) mirror.style[property] = style[property];
+	Object.assign(mirror.style, {
+		position: "absolute",
+		visibility: "hidden",
+		top: "0",
+		left: "-9999px",
+		overflow: "hidden",
+		whiteSpace: element instanceof HTMLTextAreaElement ? "pre-wrap" : "pre",
+		overflowWrap: "break-word"
+	});
+	mirror.textContent = element.value.slice(0, index);
+	const marker = document.createElement("span");
+	marker.textContent = element.value.slice(index) || ".";
+	mirror.append(marker);
+	document.body.append(mirror);
+	const lineHeight = parseFloat(style.lineHeight) || parseFloat(style.fontSize) * 1.2;
+	const top = marker.offsetTop + parseFloat(style.borderTopWidth) - element.scrollTop;
+	const left = marker.offsetLeft + parseFloat(style.borderLeftWidth) - element.scrollLeft;
+	mirror.remove();
+	const box = element.getBoundingClientRect();
+	return new DOMRect(box.left + left, box.top + top, 0, lineHeight);
+}
+/** 跟着光标的锚点（给 anchorFloating / useAnchoredPopover）：每次定位时按 index() 重新测量，文本框滚动时跟着更新 */
+function caretAnchor(element, index) {
+	return {
+		getBoundingClientRect: () => caretRect(element, index()),
+		contextElement: element
+	};
+}
+//#endregion
+export { caretAnchor, caretRect };
+
+//# sourceMappingURL=caret.js.map

package/dist/utils/dom/caret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caret.js","names":[],"sources":["../../../src/utils/dom/caret.ts"],"sourcesContent":["/**\n * 文本框里某个字符位置在视口中的坐标：@ 提及、斜杠命令这类跟着光标弹出的列表用它定位。\n *\n *   const anchor = caretAnchor(textarea, () => textarea.selectionStart);\n *   anchorFloating(anchor, panel, { placement: 'bottom-start' });\n *\n * 做法同 textarea-caret-position（component/textarea-caret）：在页面外放一个镜像 div，复制影响排版的样式，\n * 写入位置之前的文字和一个标记 span，量标记的位置，再减去文本框的滚动。input 不换行，textarea 按 pre-wrap 换行。\n */\nimport type { VirtualElement } from '@floating-ui/dom';\n\n/** 影响文字排版的样式：镜像 div 照抄 */\nconst MIRRORED = [\n  'direction',\n  'boxSizing',\n  'width',\n  'height',\n  'overflowX',\n  'overflowY',\n  'borderTopWidth',\n  'borderRightWidth',\n  'borderBottomWidth',\n  'borderLeftWidth',\n  'borderStyle',\n  'paddingTop',\n  'paddingRight',\n  'paddingBottom',\n  'paddingLeft',\n  'fontStyle',\n  'fontVariant',\n  'fontWeight',\n  'fontStretch',\n  'fontSize',\n  'fontSizeAdjust',\n  'lineHeight',\n  'fontFamily',\n  'fontFeatureSettings',\n  'textAlign',\n  'textTransform',\n  'textIndent',\n  'textDecoration',\n  'letterSpacing',\n  'wordSpacing',\n  'tabSize',\n] as const;\n\n/** 文本框里第 index 个字符之前（光标在那里时）的位置：视口坐标，宽 0、高一行 */\nexport function caretRect(element: HTMLTextAreaElement | HTMLInputElement, index: number): DOMRect {\n  const style = getComputedStyle(element);\n  const mirror = document.createElement('div');\n  for (const property of MIRRORED) mirror.style[property] = style[property];\n  Object.assign(mirror.style, {\n    position: 'absolute',\n    visibility: 'hidden',\n    top: '0',\n    left: '-9999px',\n    overflow: 'hidden',\n    whiteSpace: element instanceof HTMLTextAreaElement ? 'pre-wrap' : 'pre',\n    overflowWrap: 'break-word',\n  });\n  mirror.textContent = element.value.slice(0, index);\n  const marker = document.createElement('span');\n  // 标记里放后面的文字（至少一个字符）：行末的光标按下一个字的位置换行\n  marker.textContent = element.value.slice(index) || '.';\n  mirror.append(marker);\n  document.body.append(mirror);\n  const lineHeight = parseFloat(style.lineHeight) || parseFloat(style.fontSize) * 1.2;\n  const top = marker.offsetTop + parseFloat(style.borderTopWidth) - element.scrollTop;\n  const left = marker.offsetLeft + parseFloat(style.borderLeftWidth) - element.scrollLeft;\n  mirror.remove();\n  const box = element.getBoundingClientRect();\n  return new DOMRect(box.left + left, box.top + top, 0, lineHeight);\n}\n\n/** 跟着光标的锚点（给 anchorFloating / useAnchoredPopover）：每次定位时按 index() 重新测量，文本框滚动时跟着更新 */\nexport function caretAnchor(\n  element: HTMLTextAreaElement | HTMLInputElement,\n  index: () => number,\n): VirtualElement {\n  return { getBoundingClientRect: () => caretRect(element, index()), contextElement: element };\n}\n"],"mappings":";;AAYA,IAAM,WAAW;CACf;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;AAGA,SAAgB,UAAU,SAAiD,OAAwB;CACjG,MAAM,QAAQ,iBAAiB,OAAO;CACtC,MAAM,SAAS,SAAS,cAAc,KAAK;CAC3C,KAAK,MAAM,YAAY,UAAU,OAAO,MAAM,YAAY,MAAM;CAChE,OAAO,OAAO,OAAO,OAAO;EAC1B,UAAU;EACV,YAAY;EACZ,KAAK;EACL,MAAM;EACN,UAAU;EACV,YAAY,mBAAmB,sBAAsB,aAAa;EAClE,cAAc;CAChB,CAAC;CACD,OAAO,cAAc,QAAQ,MAAM,MAAM,GAAG,KAAK;CACjD,MAAM,SAAS,SAAS,cAAc,MAAM;CAE5C,OAAO,cAAc,QAAQ,MAAM,MAAM,KAAK,KAAK;CACnD,OAAO,OAAO,MAAM;CACpB,SAAS,KAAK,OAAO,MAAM;CAC3B,MAAM,aAAa,WAAW,MAAM,UAAU,KAAK,WAAW,MAAM,QAAQ,IAAI;CAChF,MAAM,MAAM,OAAO,YAAY,WAAW,MAAM,cAAc,IAAI,QAAQ;CAC1E,MAAM,OAAO,OAAO,aAAa,WAAW,MAAM,eAAe,IAAI,QAAQ;CAC7E,OAAO,OAAO;CACd,MAAM,MAAM,QAAQ,sBAAsB;CAC1C,OAAO,IAAI,QAAQ,IAAI,OAAO,MAAM,IAAI,MAAM,KAAK,GAAG,UAAU;AAClE;;AAGA,SAAgB,YACd,SACA,OACgB;CAChB,OAAO;EAAE,6BAA6B,UAAU,SAAS,MAAM,CAAC;EAAG,gBAAgB;CAAQ;AAC7F"}

package/dist/utils/dom/clipboard.d.ts

@@ -0,0 +1,16 @@
+/** useClipboard 的选项 */
+export interface ClipboardOptions {
+    /** copied 保持多久（毫秒）后复原，默认 2000 */
+    timeout?: number;
+}
+/** useClipboard 的返回值 */
+export interface ClipboardState {
+    /** 刚复制成功，timeout 后复原 */
+    readonly copied: boolean;
+    /** 上一次复制失败的原因（不安全的上下文、用户拒绝了权限）；成功后清空 */
+    readonly error: unknown;
+    /** 复制文字，返回是否成功 */
+    copy(text: string): Promise<boolean>;
+}
+/** 复制与复制状态（在 setup 里调用） */
+export declare function useClipboard({ timeout }?: ClipboardOptions): ClipboardState;

package/dist/utils/dom/clipboard.js

@@ -0,0 +1,66 @@
+import { onScopeDispose, shallowRef } from "vue";
+//#region src/utils/dom/clipboard.ts
+/**
+* 复制到剪贴板，带“刚复制过”的状态（按钮显示对勾、读屏播报“已复制”），过一会儿自动复原。
+*
+*   const clipboard = useClipboard();
+*   <IconButton icon={clipboard.copied ? Check : Copy} onClick={() => void clipboard.copy(code)} />
+*/
+/** 复制与复制状态（在 setup 里调用） */
+function useClipboard({ timeout = 2e3 } = {}) {
+	const copied = shallowRef(false);
+	const error = shallowRef(void 0);
+	let timer;
+	onScopeDispose(() => clearTimeout(timer));
+	return {
+		get copied() {
+			return copied.value;
+		},
+		get error() {
+			return error.value;
+		},
+		async copy(text) {
+			clearTimeout(timer);
+			try {
+				await writeText(text);
+			} catch (reason) {
+				copied.value = false;
+				error.value = reason;
+				return false;
+			}
+			error.value = void 0;
+			copied.value = true;
+			timer = setTimeout(() => copied.value = false, timeout);
+			return true;
+		}
+	};
+}
+/**
+* 写入剪贴板。Clipboard API 只在安全上下文（https、localhost）里有：内网常见的 http 部署没有它，
+* 这时退回 execCommand('copy')（已废弃，但各浏览器仍支持；同 VueUse useClipboard 的 legacy）
+*/
+async function writeText(text) {
+	if (navigator.clipboard) return navigator.clipboard.writeText(text);
+	if (!copyBySelection(text)) throw new Error("浏览器不允许复制：不是安全上下文，execCommand 也失败了");
+}
+/** 选中一个看不见的 textarea 再执行复制；之后焦点还给原来的元素（复制按钮） */
+function copyBySelection(text) {
+	const active = document.activeElement;
+	const textarea = document.createElement("textarea");
+	textarea.value = text;
+	textarea.readOnly = true;
+	textarea.style.cssText = "position:fixed;inset-block-start:0;opacity:0;pointer-events:none";
+	(active?.closest("dialog, [popover]") ?? document.body).append(textarea);
+	textarea.focus({ preventScroll: true });
+	textarea.select();
+	try {
+		return document.execCommand("copy");
+	} finally {
+		textarea.remove();
+		active?.focus({ preventScroll: true });
+	}
+}
+//#endregion
+export { useClipboard };
+
+//# sourceMappingURL=clipboard.js.map

package/dist/utils/dom/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","names":[],"sources":["../../../src/utils/dom/clipboard.ts"],"sourcesContent":["/**\n * 复制到剪贴板，带“刚复制过”的状态（按钮显示对勾、读屏播报“已复制”），过一会儿自动复原。\n *\n *   const clipboard = useClipboard();\n *   <IconButton icon={clipboard.copied ? Check : Copy} onClick={() => void clipboard.copy(code)} />\n */\nimport { onScopeDispose, shallowRef } from 'vue';\n\n/** useClipboard 的选项 */\nexport interface ClipboardOptions {\n  /** copied 保持多久（毫秒）后复原，默认 2000 */\n  timeout?: number;\n}\n\n/** useClipboard 的返回值 */\nexport interface ClipboardState {\n  /** 刚复制成功，timeout 后复原 */\n  readonly copied: boolean;\n  /** 上一次复制失败的原因（不安全的上下文、用户拒绝了权限）；成功后清空 */\n  readonly error: unknown;\n  /** 复制文字，返回是否成功 */\n  copy(text: string): Promise<boolean>;\n}\n\n/** 复制与复制状态（在 setup 里调用） */\nexport function useClipboard({ timeout = 2000 }: ClipboardOptions = {}): ClipboardState {\n  const copied = shallowRef(false);\n  const error = shallowRef<unknown>(undefined);\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  onScopeDispose(() => clearTimeout(timer));\n\n  return {\n    get copied() {\n      return copied.value;\n    },\n    get error() {\n      return error.value;\n    },\n    async copy(text) {\n      clearTimeout(timer);\n      try {\n        await writeText(text);\n      } catch (reason) {\n        copied.value = false;\n        error.value = reason;\n        return false;\n      }\n      error.value = undefined;\n      copied.value = true;\n      timer = setTimeout(() => (copied.value = false), timeout);\n      return true;\n    },\n  };\n}\n\n/**\n * 写入剪贴板。Clipboard API 只在安全上下文（https、localhost）里有：内网常见的 http 部署没有它，\n * 这时退回 execCommand('copy')（已废弃，但各浏览器仍支持；同 VueUse useClipboard 的 legacy）\n */\nasync function writeText(text: string) {\n  if (navigator.clipboard) return navigator.clipboard.writeText(text);\n  if (!copyBySelection(text))\n    throw new Error('浏览器不允许复制：不是安全上下文，execCommand 也失败了');\n}\n\n/** 选中一个看不见的 textarea 再执行复制；之后焦点还给原来的元素（复制按钮） */\nfunction copyBySelection(text: string): boolean {\n  const active = document.activeElement as HTMLElement | null;\n  const textarea = document.createElement('textarea');\n  textarea.value = text;\n  textarea.readOnly = true;\n  textarea.style.cssText = 'position:fixed;inset-block-start:0;opacity:0;pointer-events:none';\n  // 模态对话框打开时页面其余部分是 inert 的，放在 body 上选不中：放进焦点所在的对话框、弹层里\n  (active?.closest('dialog, [popover]') ?? document.body).append(textarea);\n  // select() 不一定把焦点移过去（MDN），先聚焦，复制的才是它的选区\n  textarea.focus({ preventScroll: true });\n  textarea.select();\n  try {\n    return document.execCommand('copy');\n  } finally {\n    textarea.remove();\n    active?.focus({ preventScroll: true });\n  }\n}\n"],"mappings":";;;;;;;;;AAyBA,SAAgB,aAAa,EAAE,UAAU,QAA2B,CAAC,GAAmB;CACtF,MAAM,SAAS,WAAW,KAAK;CAC/B,MAAM,QAAQ,WAAoB,KAAA,CAAS;CAC3C,IAAI;CACJ,qBAAqB,aAAa,KAAK,CAAC;CAExC,OAAO;EACL,IAAI,SAAS;GACX,OAAO,OAAO;EAChB;EACA,IAAI,QAAQ;GACV,OAAO,MAAM;EACf;EACA,MAAM,KAAK,MAAM;GACf,aAAa,KAAK;GAClB,IAAI;IACF,MAAM,UAAU,IAAI;GACtB,SAAS,QAAQ;IACf,OAAO,QAAQ;IACf,MAAM,QAAQ;IACd,OAAO;GACT;GACA,MAAM,QAAQ,KAAA;GACd,OAAO,QAAQ;GACf,QAAQ,iBAAkB,OAAO,QAAQ,OAAQ,OAAO;GACxD,OAAO;EACT;CACF;AACF;;;;;AAMA,eAAe,UAAU,MAAc;CACrC,IAAI,UAAU,WAAW,OAAO,UAAU,UAAU,UAAU,IAAI;CAClE,IAAI,CAAC,gBAAgB,IAAI,GACvB,MAAM,IAAI,MAAM,mCAAmC;AACvD;;AAGA,SAAS,gBAAgB,MAAuB;CAC9C,MAAM,SAAS,SAAS;CACxB,MAAM,WAAW,SAAS,cAAc,UAAU;CAClD,SAAS,QAAQ;CACjB,SAAS,WAAW;CACpB,SAAS,MAAM,UAAU;CAEzB,CAAC,QAAQ,QAAQ,mBAAmB,KAAK,SAAS,KAAA,CAAM,OAAO,QAAQ;CAEvE,SAAS,MAAM,EAAE,eAAe,KAAK,CAAC;CACtC,SAAS,OAAO;CAChB,IAAI;EACF,OAAO,SAAS,YAAY,MAAM;CACpC,UAAU;EACR,SAAS,OAAO;EAChB,QAAQ,MAAM,EAAE,eAAe,KAAK,CAAC;CACvC;AACF"}

package/dist/utils/dom/direction.d.ts

@@ -0,0 +1,12 @@
+/** 排版方向：从右到左时方向键、拖动、滚动位置要换边 */
+/** 元素是否处在从右到左排版里（按计算后的 direction，跟随 dir 属性与 CSS） */
+export declare function isRtl(element: Element): boolean;
+/** 行内方向的左右键 */
+export interface InlineArrows {
+    /** 朝行尾：从左到右时是 →，从右到左时是 ← */
+    readonly forward: 'ArrowRight' | 'ArrowLeft';
+    /** 朝行首：从左到右时是 ←，从右到左时是 → */
+    readonly backward: 'ArrowRight' | 'ArrowLeft';
+}
+/** 按排版方向取行内的前进、后退键：`const { forward, backward } = inlineArrows(isRtl(root))` */
+export declare const inlineArrows: (rtl: boolean) => InlineArrows;

package/dist/utils/dom/direction.js

@@ -0,0 +1,20 @@
+//#region src/utils/dom/direction.ts
+/** 排版方向：从右到左时方向键、拖动、滚动位置要换边 */
+/** 元素是否处在从右到左排版里（按计算后的 direction，跟随 dir 属性与 CSS） */
+function isRtl(element) {
+	return getComputedStyle(element).direction === "rtl";
+}
+var LTR_ARROWS = {
+	forward: "ArrowRight",
+	backward: "ArrowLeft"
+};
+var RTL_ARROWS = {
+	forward: "ArrowLeft",
+	backward: "ArrowRight"
+};
+/** 按排版方向取行内的前进、后退键：`const { forward, backward } = inlineArrows(isRtl(root))` */
+var inlineArrows = (rtl) => rtl ? RTL_ARROWS : LTR_ARROWS;
+//#endregion
+export { inlineArrows, isRtl };
+
+//# sourceMappingURL=direction.js.map

package/dist/utils/dom/direction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direction.js","names":[],"sources":["../../../src/utils/dom/direction.ts"],"sourcesContent":["/** 排版方向：从右到左时方向键、拖动、滚动位置要换边 */\n\n/** 元素是否处在从右到左排版里（按计算后的 direction，跟随 dir 属性与 CSS） */\nexport function isRtl(element: Element): boolean {\n  return getComputedStyle(element).direction === 'rtl';\n}\n\n/** 行内方向的左右键 */\nexport interface InlineArrows {\n  /** 朝行尾：从左到右时是 →，从右到左时是 ← */\n  readonly forward: 'ArrowRight' | 'ArrowLeft';\n  /** 朝行首：从左到右时是 ←，从右到左时是 → */\n  readonly backward: 'ArrowRight' | 'ArrowLeft';\n}\n\nconst LTR_ARROWS: InlineArrows = { forward: 'ArrowRight', backward: 'ArrowLeft' };\nconst RTL_ARROWS: InlineArrows = { forward: 'ArrowLeft', backward: 'ArrowRight' };\n\n/** 按排版方向取行内的前进、后退键：`const { forward, backward } = inlineArrows(isRtl(root))` */\nexport const inlineArrows = (rtl: boolean): InlineArrows => (rtl ? RTL_ARROWS : LTR_ARROWS);\n"],"mappings":";;;AAGA,SAAgB,MAAM,SAA2B;CAC/C,OAAO,iBAAiB,OAAO,CAAC,CAAC,cAAc;AACjD;AAUA,IAAM,aAA2B;CAAE,SAAS;CAAc,UAAU;AAAY;AAChF,IAAM,aAA2B;CAAE,SAAS;CAAa,UAAU;AAAa;;AAGhF,IAAa,gBAAgB,QAAgC,MAAM,aAAa"}

package/dist/utils/dom/download.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 把一段文字存成文件（浏览器下载）：导出代码、CSV、SVG。
+ * 内容原样写入：给 Excel 打开的 CSV 要由调用方在开头加 BOM（`'\uFEFF' + csv`），中文才不乱码。
+ *
+ *   downloadFile('theme.ts', code, 'text/typescript');
+ */
+export declare function downloadFile(name: string, content: BlobPart, type: string): void;

package/dist/utils/dom/download.js

@@ -0,0 +1,19 @@
+//#region src/utils/dom/download.ts
+/**
+* 把一段文字存成文件（浏览器下载）：导出代码、CSV、SVG。
+* 内容原样写入：给 Excel 打开的 CSV 要由调用方在开头加 BOM（`'\uFEFF' + csv`），中文才不乱码。
+*
+*   downloadFile('theme.ts', code, 'text/typescript');
+*/
+function downloadFile(name, content, type) {
+	const url = URL.createObjectURL(new Blob([content], { type }));
+	Object.assign(document.createElement("a"), {
+		href: url,
+		download: name
+	}).click();
+	setTimeout(() => URL.revokeObjectURL(url), 4e4);
+}
+//#endregion
+export { downloadFile };
+
+//# sourceMappingURL=download.js.map

package/dist/utils/dom/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","names":[],"sources":["../../../src/utils/dom/download.ts"],"sourcesContent":["/**\n * 把一段文字存成文件（浏览器下载）：导出代码、CSV、SVG。\n * 内容原样写入：给 Excel 打开的 CSV 要由调用方在开头加 BOM（`'\\uFEFF' + csv`），中文才不乱码。\n *\n *   downloadFile('theme.ts', code, 'text/typescript');\n */\nexport function downloadFile(name: string, content: BlobPart, type: string): void {\n  const url = URL.createObjectURL(new Blob([content], { type }));\n  const link = Object.assign(document.createElement('a'), { href: url, download: name });\n  link.click();\n  // 点击后浏览器才开始读这个地址：Safari、Firefox 里立即回收会让下载失败，过一会儿再回收（同 FileSaver.js）\n  setTimeout(() => URL.revokeObjectURL(url), 40_000);\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,aAAa,MAAc,SAAmB,MAAoB;CAChF,MAAM,MAAM,IAAI,gBAAgB,IAAI,KAAK,CAAC,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC;CAE7D,OADoB,OAAO,SAAS,cAAc,GAAG,GAAG;EAAE,MAAM;EAAK,UAAU;CAAK,CACpF,CAAA,CAAK,MAAM;CAEX,iBAAiB,IAAI,gBAAgB,GAAG,GAAG,GAAM;AACnD"}

package/dist/utils/dom/element.d.ts

@@ -0,0 +1,3 @@
+/** 模板 ref 的取值换成 DOM 元素 */
+/** ref 落在组件上拿到的是组件实例，取它的根元素；本来就是元素时原样返回 */
+export declare function toElement(value: unknown): HTMLElement | null;

package/dist/utils/dom/element.js

@@ -0,0 +1,12 @@
+//#region src/utils/dom/element.ts
+/** 模板 ref 的取值换成 DOM 元素 */
+/** ref 落在组件上拿到的是组件实例，取它的根元素；本来就是元素时原样返回 */
+function toElement(value) {
+	if (value instanceof HTMLElement) return value;
+	const root = value?.$el;
+	return root instanceof HTMLElement ? root : null;
+}
+//#endregion
+export { toElement };
+
+//# sourceMappingURL=element.js.map

package/dist/utils/dom/element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.js","names":[],"sources":["../../../src/utils/dom/element.ts"],"sourcesContent":["/** 模板 ref 的取值换成 DOM 元素 */\n\n/** ref 落在组件上拿到的是组件实例，取它的根元素；本来就是元素时原样返回 */\nexport function toElement(value: unknown): HTMLElement | null {\n  if (value instanceof HTMLElement) return value;\n  const root = (value as { $el?: unknown } | null)?.$el;\n  return root instanceof HTMLElement ? root : null;\n}\n"],"mappings":";;;AAGA,SAAgB,UAAU,OAAoC;CAC5D,IAAI,iBAAiB,aAAa,OAAO;CACzC,MAAM,OAAQ,OAAoC;CAClD,OAAO,gBAAgB,cAAc,OAAO;AAC9C"}

package/dist/utils/dom/event-listener.d.ts

@@ -0,0 +1,8 @@
+/** 监听的目标：window、document、元素，或返回它们的 getter（返回 null、undefined 时不监听） */
+export type ListenerTarget = EventTarget | (() => EventTarget | null | undefined);
+/** 监听 window 的事件（见文件开头） */
+export declare function useEventListener<K extends keyof WindowEventMap>(target: Window | (() => Window | null | undefined), type: K, listener: (event: WindowEventMap[K]) => void, options?: AddEventListenerOptions): () => void;
+/** 监听 document 的事件 */
+export declare function useEventListener<K extends keyof DocumentEventMap>(target: Document | (() => Document | null | undefined), type: K, listener: (event: DocumentEventMap[K]) => void, options?: AddEventListenerOptions): () => void;
+/** 监听元素（或 getter 给出的目标）的事件 */
+export declare function useEventListener<K extends keyof HTMLElementEventMap>(target: ListenerTarget, type: K, listener: (event: HTMLElementEventMap[K]) => void, options?: AddEventListenerOptions): () => void;

package/dist/utils/dom/event-listener.js

@@ -0,0 +1,35 @@
+import { getCurrentScope, onScopeDispose, watch } from "vue";
+//#region src/utils/dom/event-listener.ts
+/**
+* 事件监听，跟着作用域（组件）一起移除（参考 VueUse 的 useEventListener）：
+*
+*   useEventListener(document, 'visibilitychange', update);
+*   useEventListener(() => scroller, 'scroll', onScroll, { passive: true });   目标是 getter：变了换绑，null 时不监听
+*
+* getter 在 DOM 更新之后读（模板 ref 已经有值）；服务端渲染时什么都不做。返回立即移除的函数。
+*/
+function useEventListener(target, type, listener, options) {
+	if (typeof window === "undefined") return () => {};
+	let remove = () => {};
+	const bind = (element) => {
+		remove();
+		remove = () => {};
+		if (!element) return;
+		element.addEventListener(type, listener, options);
+		remove = () => element.removeEventListener(type, listener, options);
+	};
+	const stopWatch = typeof target === "function" ? watch(target, bind, {
+		immediate: true,
+		flush: "post"
+	}) : (bind(target), void 0);
+	const stop = () => {
+		stopWatch?.();
+		remove();
+	};
+	if (getCurrentScope()) onScopeDispose(stop);
+	return stop;
+}
+//#endregion
+export { useEventListener };
+
+//# sourceMappingURL=event-listener.js.map

package/dist/utils/dom/event-listener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-listener.js","names":[],"sources":["../../../src/utils/dom/event-listener.ts"],"sourcesContent":["/**\n * 事件监听，跟着作用域（组件）一起移除（参考 VueUse 的 useEventListener）：\n *\n *   useEventListener(document, 'visibilitychange', update);\n *   useEventListener(() => scroller, 'scroll', onScroll, { passive: true });   目标是 getter：变了换绑，null 时不监听\n *\n * getter 在 DOM 更新之后读（模板 ref 已经有值）；服务端渲染时什么都不做。返回立即移除的函数。\n */\nimport { getCurrentScope, onScopeDispose, watch } from 'vue';\n\n/** 监听的目标：window、document、元素，或返回它们的 getter（返回 null、undefined 时不监听） */\nexport type ListenerTarget = EventTarget | (() => EventTarget | null | undefined);\n\n/** 监听 window 的事件（见文件开头） */\nexport function useEventListener<K extends keyof WindowEventMap>(\n  target: Window | (() => Window | null | undefined),\n  type: K,\n  listener: (event: WindowEventMap[K]) => void,\n  options?: AddEventListenerOptions,\n): () => void;\n/** 监听 document 的事件 */\nexport function useEventListener<K extends keyof DocumentEventMap>(\n  target: Document | (() => Document | null | undefined),\n  type: K,\n  listener: (event: DocumentEventMap[K]) => void,\n  options?: AddEventListenerOptions,\n): () => void;\n/** 监听元素（或 getter 给出的目标）的事件 */\nexport function useEventListener<K extends keyof HTMLElementEventMap>(\n  target: ListenerTarget,\n  type: K,\n  listener: (event: HTMLElementEventMap[K]) => void,\n  options?: AddEventListenerOptions,\n): () => void;\nexport function useEventListener(\n  target: ListenerTarget,\n  type: string,\n  listener: (event: Event) => void,\n  options?: AddEventListenerOptions,\n): () => void {\n  if (typeof window === 'undefined') return () => {};\n  let remove = () => {};\n  const bind = (element: EventTarget | null | undefined) => {\n    remove();\n    remove = () => {};\n    if (!element) return;\n    element.addEventListener(type, listener, options);\n    remove = () => element.removeEventListener(type, listener, options);\n  };\n  const stopWatch =\n    typeof target === 'function'\n      ? watch(target, bind, { immediate: true, flush: 'post' })\n      : (bind(target), undefined);\n  const stop = () => {\n    stopWatch?.();\n    remove();\n  };\n  if (getCurrentScope()) onScopeDispose(stop);\n  return stop;\n}\n"],"mappings":";;;;;;;;;;AAkCA,SAAgB,iBACd,QACA,MACA,UACA,SACY;CACZ,IAAI,OAAO,WAAW,aAAa,aAAa,CAAC;CACjD,IAAI,eAAe,CAAC;CACpB,MAAM,QAAQ,YAA4C;EACxD,OAAO;EACP,eAAe,CAAC;EAChB,IAAI,CAAC,SAAS;EACd,QAAQ,iBAAiB,MAAM,UAAU,OAAO;EAChD,eAAe,QAAQ,oBAAoB,MAAM,UAAU,OAAO;CACpE;CACA,MAAM,YACJ,OAAO,WAAW,aACd,MAAM,QAAQ,MAAM;EAAE,WAAW;EAAM,OAAO;CAAO,CAAC,KACrD,KAAK,MAAM,GAAG,KAAA;CACrB,MAAM,aAAa;EACjB,YAAY;EACZ,OAAO;CACT;CACA,IAAI,gBAAgB,GAAG,eAAe,IAAI;CAC1C,OAAO;AACT"}