@xihan-ui/vue 1.0.0 → 2.0.0

package/dist/sound.d.ts

@@ -1,67 +1,46 @@
 import { DialogService } from "./services/dialog-service.js";
 import { ToastService } from "./services/toast-service.js";
 import { Directive } from "vue";
-import { ToastType } from "@xihan-ui/headless";
-import { SoundPlayer } from "@xihan-ui/sound";
+import { DialogSoundKey, DialogSoundServiceOptions, SoundChoice, SoundPlayer, SoundPressOptions, ToastSoundServiceOptions } from "@xihan-ui/sound";
 //#region src/sound.d.ts
 /**
- * 取共享播放器，没有就建一个默认的。
- * 播放器本身很轻，音频上下文要等第一次真的发声才建，取了不用不花代价。
+ * 取共享播放器，没有时建立一个默认的。
+ * 播放器本身很轻，音频上下文要等第一次真正发声才建立，取用后不使用不产生开销。
  */
 declare function getSoundPlayer(): SoundPlayer;
-/** 换成自己配置的播放器（换主题、接用户偏好）。自动建的那个会被销毁。 */
+/** 换为自行配置的播放器（更换主题、接入用户偏好）。自动建立的播放器会被销毁。 */
 declare function setSoundPlayer(player: SoundPlayer): void;
-/** 语义名，或 null 表示这一类不出声。 */
-type SoundChoice = string | null;
-interface ToastSoundOptions {
-  /** 用哪个播放器，默认共享播放器。 */
+interface ToastSoundOptions extends Omit<ToastSoundServiceOptions, 'player' | 'attachUnlock'> {
+  /** 使用哪个播放器，默认共享播放器。 */
   player?: SoundPlayer;
-  /** 通知类型 → 语义名。只写要改的那几个，其余沿用默认。 */
-  sounds?: Partial<Record<ToastType, SoundChoice>>;
-  /**
-   * 首次用户手势时解锁音频上下文，默认开。
-   * 通知常来自拦截器或推送这类非手势场景，不解锁就发不出声。
-   */
-  autoUnlock?: boolean;
 }
 /**
- * 给命令式通知服务配上声音：入队即发声，调用点一行都不用改。
+ * 为命令式通知服务配上声音：入队即发声，调用点无需修改。
  *
  * ```ts
  * export const toast = withToastSound(createToastService())
  * toast.success('已保存') // 视觉 + 听觉
  * ```
  *
- * `update` 只在改了类型且新类型不是 loading 时发声——上传完成那一刻该响，
- * 改个文案不该响。
+ * `update` 只在类型改变且新类型不是 loading 时发声：上传完成时应当发声，
+ * 修改文案不应发声。
  */
 declare function withToastSound(service: ToastService, options?: ToastSoundOptions): ToastService;
-/** 对话框服务的发声档：confirm 是征询，其余四档带类型语气。 */
-type DialogSoundKey = 'confirm' | 'info' | 'success' | 'warning' | 'error';
-interface DialogSoundOptions {
+interface DialogSoundOptions extends Omit<DialogSoundServiceOptions, 'player' | 'attachUnlock'> {
   player?: SoundPlayer;
-  sounds?: Partial<Record<DialogSoundKey, SoundChoice>>;
-  autoUnlock?: boolean;
 }
 /**
- * 给命令式确认框服务配上声音：弹出时发声，收场不发
- * （按钮那一下与随后的通知已经把结果说清楚了）。
+ * 为命令式确认框服务配上声音：弹出时发声，关闭时不发声
+ * （按钮的按下声与随后的通知已经表明了结果）。
  */
 declare function withDialogSound(service: DialogService, options?: DialogSoundOptions): DialogService;
-interface SoundDirectiveOptions {
-  /** 语义名或配方名，默认 'click'。 */
-  sound?: string;
-  /** 本次播放的音量系数（0..1）。 */
-  volume?: number;
-  /** 用哪个播放器，默认共享播放器。 */
-  player?: SoundPlayer;
-}
+interface SoundDirectiveOptions extends SoundPressOptions {}
 type SoundDirectiveValue = string | SoundDirectiveOptions | undefined;
 /**
- * `v-sound` —— 给任意元素按下时配一声。
+ * `v-sound`：为任意元素按下时配一声。
  *
- * 挂在 click 上而不是 pointerdown：键盘敲 Enter / Space 激活也要响，
- * 而且点下去又拖开取消的那种不该响。
+ * 挂在 click 上而不是 pointerdown：键盘按 Enter / Space 激活也要发声，
+ * 而按下后拖开取消的操作不应发声。
  *
  * ```vue
  * <XhButton v-sound>提交</XhButton>
@@ -71,5 +50,5 @@ type SoundDirectiveValue = string | SoundDirectiveOptions | undefined;
  */
 declare const vSound: Directive<HTMLElement, SoundDirectiveValue>;
 //#endregion
-export { DialogSoundKey, DialogSoundOptions, SoundChoice, SoundDirectiveOptions, SoundDirectiveValue, ToastSoundOptions, getSoundPlayer, setSoundPlayer, vSound, withDialogSound, withToastSound };
+export { type DialogSoundKey, DialogSoundOptions, type SoundChoice, SoundDirectiveOptions, SoundDirectiveValue, ToastSoundOptions, getSoundPlayer, setSoundPlayer, vSound, withDialogSound, withToastSound };
 //# sourceMappingURL=sound.d.ts.map

package/dist/sound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sound.d.ts","names":[],"sources":["../src/sound.ts"],"mappings":";;;;;;;;;;iBAyBgB,kBAAkB;;iBASlB,eAAe,QAAQ;;KAyB3B;UAEK;;EAEf,SAAS;;EAET,SAAS,QAAQ,OAAO,WAAW;;;;;EAKnC;;;;;;;;;;;;;iBAuBc,eAAe,SAAS,cAAc,UAAS,oBAAyB;;KAkD5E;UAEK;EACf,SAAS;EACT,SAAS,QAAQ,OAAO,gBAAgB;EACxC;;;;;;iBAec,gBAAgB,SAAS,eAAe,UAAS,qBAA0B;UAwC1E;;EAEf;;EAEA;;EAEA,SAAS;;KAGC,+BAA+B;;;;;;;;;;;;;cA6B9B,QAAQ,UAAU,aAAa"}
+{"version":3,"file":"sound.d.ts","names":[],"sources":["../src/sound.ts"],"mappings":";;;;;;;;;iBA6BgB,kBAAkB;;iBAKlB,eAAe,QAAQ;UAItB,0BAA0B,KAAK;;EAE9C,SAAS;;;;;;;;;;;;;iBAcK,eAAe,SAAS,cAAc,UAAS,oBAAyB;UAQvE,2BAA2B,KAAK;EAC/C,SAAS;;;;;;iBAOK,gBAAgB,SAAS,eAAe,UAAS,qBAA0B;UAQ1E,8BAA8B;KAEnC,+BAA+B;;;;;;;;;;;;;cAgB9B,QAAQ,UAAU,aAAa"}

package/dist/sound.js

@@ -1,172 +1,52 @@
-import { createSoundPlayer } from "@xihan-ui/sound";
+import { attachDocumentSoundUnlock, createSharedSoundPlayerController, isSoundTargetDisabled, resolveSoundPressOptions, withDialogSoundService, withToastSoundService } from "@xihan-ui/sound";
 //#region src/sound.ts
-let shared = null;
-/** 共享播放器是自己建的还是外面塞进来的：只有自己建的才由本模块销毁。 */
-let sharedIsOwn = false;
+const shared = createSharedSoundPlayerController();
 /**
-* 取共享播放器，没有就建一个默认的。
-* 播放器本身很轻，音频上下文要等第一次真的发声才建，取了不用不花代价。
+* 取共享播放器，没有时建立一个默认的。
+* 播放器本身很轻，音频上下文要等第一次真正发声才建立，取用后不使用不产生开销。
 */
 function getSoundPlayer() {
-	if (!shared) {
-		shared = createSoundPlayer();
-		sharedIsOwn = true;
-	}
-	return shared;
+	return shared.getPlayer();
 }
-/** 换成自己配置的播放器（换主题、接用户偏好）。自动建的那个会被销毁。 */
+/** 换为自行配置的播放器（更换主题、接入用户偏好）。自动建立的播放器会被销毁。 */
 function setSoundPlayer(player) {
-	if (shared && sharedIsOwn && shared !== player) shared.dispose();
-	shared = player;
-	sharedIsOwn = false;
-}
-/** 首次用户手势时解锁音频上下文，返回撤销函数。 */
-function attachUnlock(player) {
-	if (typeof document === "undefined") return () => void 0;
-	const listener = () => {
-		player.unlock();
-		document.removeEventListener("pointerdown", listener);
-		document.removeEventListener("keydown", listener);
-	};
-	document.addEventListener("pointerdown", listener);
-	document.addEventListener("keydown", listener);
-	return () => {
-		document.removeEventListener("pointerdown", listener);
-		document.removeEventListener("keydown", listener);
-	};
+	shared.setPlayer(player);
 }
-const TOAST_SOUNDS = {
-	info: "info",
-	success: "success",
-	warning: "warning",
-	error: "error",
-	loading: null
-};
 /**
-* 给命令式通知服务配上声音：入队即发声，调用点一行都不用改。
+* 为命令式通知服务配上声音：入队即发声，调用点无需修改。
 *
 * ```ts
 * export const toast = withToastSound(createToastService())
 * toast.success('已保存') // 视觉 + 听觉
 * ```
 *
-* `update` 只在改了类型且新类型不是 loading 时发声——上传完成那一刻该响，
-* 改个文案不该响。
+* `update` 只在类型改变且新类型不是 loading 时发声：上传完成时应当发声，
+* 修改文案不应发声。
 */
 function withToastSound(service, options = {}) {
-	const player = options.player ?? getSoundPlayer();
-	const sounds = {
-		...TOAST_SOUNDS,
-		...options.sounds
-	};
-	const detachUnlock = options.autoUnlock === false ? () => void 0 : attachUnlock(player);
-	const play = (type) => {
-		const name = sounds[type ?? "info"];
-		if (name) player.play(name);
-	};
-	return {
-		...service,
-		create: (opts) => {
-			play(opts?.type);
-			return service.create(opts);
-		},
-		update: (id, opts) => {
-			if (opts.type) play(opts.type);
-			service.update(id, opts);
-		},
-		info: (message, opts) => {
-			play("info");
-			return service.info(message, opts);
-		},
-		success: (message, opts) => {
-			play("success");
-			return service.success(message, opts);
-		},
-		warning: (message, opts) => {
-			play("warning");
-			return service.warning(message, opts);
-		},
-		error: (message, opts) => {
-			play("error");
-			return service.error(message, opts);
-		},
-		loading: (message, opts) => {
-			play("loading");
-			return service.loading(message, opts);
-		},
-		dispose: () => {
-			detachUnlock();
-			service.dispose();
-		}
-	};
+	return withToastSoundService(service, {
+		...options,
+		player: options.player ?? getSoundPlayer(),
+		attachUnlock: attachDocumentSoundUnlock
+	});
 }
-const DIALOG_SOUNDS = {
-	confirm: "open",
-	info: "info",
-	success: "success",
-	warning: "warning",
-	error: "error"
-};
 /**
-* 给命令式确认框服务配上声音：弹出时发声，收场不发
-* （按钮那一下与随后的通知已经把结果说清楚了）。
+* 为命令式确认框服务配上声音：弹出时发声，关闭时不发声
+* （按钮的按下声与随后的通知已经表明了结果）。
 */
 function withDialogSound(service, options = {}) {
-	const player = options.player ?? getSoundPlayer();
-	const sounds = {
-		...DIALOG_SOUNDS,
-		...options.sounds
-	};
-	const detachUnlock = options.autoUnlock === false ? () => void 0 : attachUnlock(player);
-	const play = (key) => {
-		const name = sounds[key];
-		if (name) player.play(name);
-	};
-	return {
-		...service,
-		confirm: (opts) => {
-			play("confirm");
-			return service.confirm(opts);
-		},
-		info: (opts) => {
-			play("info");
-			return service.info(opts);
-		},
-		success: (opts) => {
-			play("success");
-			return service.success(opts);
-		},
-		warning: (opts) => {
-			play("warning");
-			return service.warning(opts);
-		},
-		error: (opts) => {
-			play("error");
-			return service.error(opts);
-		},
-		dispose: () => {
-			detachUnlock();
-			service.dispose();
-		}
-	};
-}
-function toOptions(value) {
-	if (typeof value === "string") return { sound: value };
-	return {
-		sound: "click",
-		...value
-	};
-}
-/** 禁用态的元素不发声：原生 disabled 不触发 click，aria/data 标注的会。 */
-function isDisabled(el) {
-	return el.hasAttribute("disabled") || el.getAttribute("aria-disabled") === "true" || el.hasAttribute("data-disabled");
+	return withDialogSoundService(service, {
+		...options,
+		player: options.player ?? getSoundPlayer(),
+		attachUnlock: attachDocumentSoundUnlock
+	});
 }
 const bound = /* @__PURE__ */ new WeakMap();
 /**
-* `v-sound` —— 给任意元素按下时配一声。
+* `v-sound`：为任意元素按下时配一声。
 *
-* 挂在 click 上而不是 pointerdown：键盘敲 Enter / Space 激活也要响，
-* 而且点下去又拖开取消的那种不该响。
+* 挂在 click 上而不是 pointerdown：键盘按 Enter / Space 激活也要发声，
+* 而按下后拖开取消的操作不应发声。
 *
 * ```vue
 * <XhButton v-sound>提交</XhButton>
@@ -177,9 +57,9 @@ const bound = /* @__PURE__ */ new WeakMap();
 const vSound = {
 	mounted(el, binding) {
 		const entry = {
-			options: toOptions(binding.value),
+			options: resolveSoundPressOptions(binding.value),
 			handler: () => {
-				if (isDisabled(el)) return;
+				if (isSoundTargetDisabled(el)) return;
 				const { sound, volume, player } = entry.options;
 				(player ?? getSoundPlayer()).play(sound, volume === void 0 ? void 0 : { volume });
 			}
@@ -189,7 +69,7 @@ const vSound = {
 	},
 	updated(el, binding) {
 		const entry = bound.get(el);
-		if (entry) entry.options = toOptions(binding.value);
+		if (entry) entry.options = resolveSoundPressOptions(binding.value);
 	},
 	unmounted(el) {
 		const entry = bound.get(el);

package/dist/sound.js.map

@@ -1 +1 @@
-{"version":3,"file":"sound.js","names":[],"sources":["../src/sound.ts"],"sourcesContent":["// @xihan-ui/vue/sound —— 声音层的 Vue 适配。\n//\n// 与主入口分开：@xihan-ui/sound 是可选 peer，不用音效的应用不会因为装了本包\n// 而多出一个音频引擎。用之前先装 @xihan-ui/sound。\n//\n// 三种用法，从轻到重：\n//   v-sound          给任意元素或组件按下时配一声，一个字都不用改组件\n//   withToastSound   给命令式反馈服务配上声音，调用点一行都不用改\n//   getSoundPlayer   自己拿播放器，接偏好开关或调音面板\n\nimport type { ToastOptions, ToastType } from '@xihan-ui/headless'\nimport type { SoundPlayer } from '@xihan-ui/sound'\nimport type { Directive } from 'vue'\nimport type { DialogService } from './services/dialog-service'\nimport type { ToastService } from './services/toast-service'\nimport { createSoundPlayer } from '@xihan-ui/sound'\n\nlet shared: SoundPlayer | null = null\n/** 共享播放器是自己建的还是外面塞进来的：只有自己建的才由本模块销毁。 */\nlet sharedIsOwn = false\n\n/**\n * 取共享播放器，没有就建一个默认的。\n * 播放器本身很轻，音频上下文要等第一次真的发声才建，取了不用不花代价。\n */\nexport function getSoundPlayer(): SoundPlayer {\n  if (!shared) {\n    shared = createSoundPlayer()\n    sharedIsOwn = true\n  }\n  return shared\n}\n\n/** 换成自己配置的播放器（换主题、接用户偏好）。自动建的那个会被销毁。 */\nexport function setSoundPlayer(player: SoundPlayer): void {\n  if (shared && sharedIsOwn && shared !== player)\n    shared.dispose()\n  shared = player\n  sharedIsOwn = false\n}\n\n/** 首次用户手势时解锁音频上下文，返回撤销函数。 */\nfunction attachUnlock(player: SoundPlayer): () => void {\n  if (typeof document === 'undefined')\n    return () => undefined\n  const listener = (): void => {\n    player.unlock()\n    document.removeEventListener('pointerdown', listener)\n    document.removeEventListener('keydown', listener)\n  }\n  document.addEventListener('pointerdown', listener)\n  document.addEventListener('keydown', listener)\n  return () => {\n    document.removeEventListener('pointerdown', listener)\n    document.removeEventListener('keydown', listener)\n  }\n}\n\n/** 语义名，或 null 表示这一类不出声。 */\nexport type SoundChoice = string | null\n\nexport interface ToastSoundOptions {\n  /** 用哪个播放器，默认共享播放器。 */\n  player?: SoundPlayer\n  /** 通知类型 → 语义名。只写要改的那几个，其余沿用默认。 */\n  sounds?: Partial<Record<ToastType, SoundChoice>>\n  /**\n   * 首次用户手势时解锁音频上下文，默认开。\n   * 通知常来自拦截器或推送这类非手势场景，不解锁就发不出声。\n   */\n  autoUnlock?: boolean\n}\n\nconst TOAST_SOUNDS: Record<ToastType, SoundChoice> = {\n  info: 'info',\n  success: 'success',\n  warning: 'warning',\n  error: 'error',\n  // 加载中只是个过渡态，收尾时才有值得报的结果\n  loading: null,\n}\n\n/**\n * 给命令式通知服务配上声音：入队即发声，调用点一行都不用改。\n *\n * ```ts\n * export const toast = withToastSound(createToastService())\n * toast.success('已保存') // 视觉 + 听觉\n * ```\n *\n * `update` 只在改了类型且新类型不是 loading 时发声——上传完成那一刻该响，\n * 改个文案不该响。\n */\nexport function withToastSound(service: ToastService, options: ToastSoundOptions = {}): ToastService {\n  const player = options.player ?? getSoundPlayer()\n  const sounds = { ...TOAST_SOUNDS, ...options.sounds }\n  const detachUnlock = options.autoUnlock === false ? () => undefined : attachUnlock(player)\n\n  const play = (type: ToastType | undefined): void => {\n    const name = sounds[type ?? 'info']\n    if (name)\n      player.play(name)\n  }\n\n  return {\n    ...service,\n    create: (opts?: ToastOptions) => {\n      play(opts?.type)\n      return service.create(opts)\n    },\n    update: (id, opts) => {\n      if (opts.type)\n        play(opts.type)\n      service.update(id, opts)\n    },\n    info: (message, opts) => {\n      play('info')\n      return service.info(message, opts)\n    },\n    success: (message, opts) => {\n      play('success')\n      return service.success(message, opts)\n    },\n    warning: (message, opts) => {\n      play('warning')\n      return service.warning(message, opts)\n    },\n    error: (message, opts) => {\n      play('error')\n      return service.error(message, opts)\n    },\n    loading: (message, opts) => {\n      play('loading')\n      return service.loading(message, opts)\n    },\n    dispose: () => {\n      detachUnlock()\n      service.dispose()\n    },\n  }\n}\n\n/** 对话框服务的发声档：confirm 是征询，其余四档带类型语气。 */\nexport type DialogSoundKey = 'confirm' | 'info' | 'success' | 'warning' | 'error'\n\nexport interface DialogSoundOptions {\n  player?: SoundPlayer\n  sounds?: Partial<Record<DialogSoundKey, SoundChoice>>\n  autoUnlock?: boolean\n}\n\nconst DIALOG_SOUNDS: Record<DialogSoundKey, SoundChoice> = {\n  confirm: 'open',\n  info: 'info',\n  success: 'success',\n  warning: 'warning',\n  error: 'error',\n}\n\n/**\n * 给命令式确认框服务配上声音：弹出时发声，收场不发\n * （按钮那一下与随后的通知已经把结果说清楚了）。\n */\nexport function withDialogSound(service: DialogService, options: DialogSoundOptions = {}): DialogService {\n  const player = options.player ?? getSoundPlayer()\n  const sounds = { ...DIALOG_SOUNDS, ...options.sounds }\n  const detachUnlock = options.autoUnlock === false ? () => undefined : attachUnlock(player)\n\n  const play = (key: DialogSoundKey): void => {\n    const name = sounds[key]\n    if (name)\n      player.play(name)\n  }\n\n  return {\n    ...service,\n    confirm: (opts) => {\n      play('confirm')\n      return service.confirm(opts)\n    },\n    info: (opts) => {\n      play('info')\n      return service.info(opts)\n    },\n    success: (opts) => {\n      play('success')\n      return service.success(opts)\n    },\n    warning: (opts) => {\n      play('warning')\n      return service.warning(opts)\n    },\n    error: (opts) => {\n      play('error')\n      return service.error(opts)\n    },\n    dispose: () => {\n      detachUnlock()\n      service.dispose()\n    },\n  }\n}\n\nexport interface SoundDirectiveOptions {\n  /** 语义名或配方名，默认 'click'。 */\n  sound?: string\n  /** 本次播放的音量系数（0..1）。 */\n  volume?: number\n  /** 用哪个播放器，默认共享播放器。 */\n  player?: SoundPlayer\n}\n\nexport type SoundDirectiveValue = string | SoundDirectiveOptions | undefined\n\nfunction toOptions(value: SoundDirectiveValue): Required<Pick<SoundDirectiveOptions, 'sound'>> & SoundDirectiveOptions {\n  if (typeof value === 'string')\n    return { sound: value }\n  return { sound: 'click', ...value }\n}\n\n/** 禁用态的元素不发声：原生 disabled 不触发 click，aria/data 标注的会。 */\nfunction isDisabled(el: HTMLElement): boolean {\n  return el.hasAttribute('disabled')\n    || el.getAttribute('aria-disabled') === 'true'\n    || el.hasAttribute('data-disabled')\n}\n\nconst bound = new WeakMap<HTMLElement, { handler: () => void, options: ReturnType<typeof toOptions> }>()\n\n/**\n * `v-sound` —— 给任意元素按下时配一声。\n *\n * 挂在 click 上而不是 pointerdown：键盘敲 Enter / Space 激活也要响，\n * 而且点下去又拖开取消的那种不该响。\n *\n * ```vue\n * <XhButton v-sound>提交</XhButton>\n * <XhButton v-sound=\"'send'\">发送</XhButton>\n * <div v-sound=\"{ sound: 'toggle-on', volume: 0.6 }\" />\n * ```\n */\nexport const vSound: Directive<HTMLElement, SoundDirectiveValue> = {\n  mounted(el, binding) {\n    const entry = {\n      options: toOptions(binding.value),\n      handler: (): void => {\n        if (isDisabled(el))\n          return\n        const { sound, volume, player } = entry.options\n        ;(player ?? getSoundPlayer()).play(sound, volume === undefined ? undefined : { volume })\n      },\n    }\n    bound.set(el, entry)\n    el.addEventListener('click', entry.handler)\n  },\n  updated(el, binding) {\n    const entry = bound.get(el)\n    if (entry)\n      entry.options = toOptions(binding.value)\n  },\n  unmounted(el) {\n    const entry = bound.get(el)\n    if (entry)\n      el.removeEventListener('click', entry.handler)\n    bound.delete(el)\n  },\n}\n"],"mappings":"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"}
+{"version":3,"file":"sound.js","names":[],"sources":["../src/sound.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// @xihan-ui/vue/sound —— 声音层的 Vue 适配。\n//\n// 与主入口分开：@xihan-ui/sound 是可选 peer，不用音效的应用不会因为装了本包\n// 而多出一个音频引擎。用之前先装 @xihan-ui/sound。\n//\n// 三种用法，从轻到重：\n//   v-sound          给任意元素或组件按下时配一声，一个字都不用改组件\n//   withToastSound   给命令式反馈服务配上声音，调用点一行都不用改\n//   getSoundPlayer   自己拿播放器，接偏好开关或调音面板\n\nimport type { DialogSoundServiceOptions, SoundPressOptions as SharedSoundPressOptions, SoundPlayer, ToastSoundServiceOptions } from '@xihan-ui/sound'\nimport type { Directive } from 'vue'\nimport type { DialogService } from './services/dialog-service'\nimport type { ToastService } from './services/toast-service'\nimport { attachDocumentSoundUnlock, createSharedSoundPlayerController, isSoundTargetDisabled, resolveSoundPressOptions, withDialogSoundService, withToastSoundService } from '@xihan-ui/sound'\n\nexport type { DialogSoundKey, SoundChoice } from '@xihan-ui/sound'\n\nconst shared = createSharedSoundPlayerController()\n\n/**\n * 取共享播放器，没有时建立一个默认的。\n * 播放器本身很轻，音频上下文要等第一次真正发声才建立，取用后不使用不产生开销。\n */\nexport function getSoundPlayer(): SoundPlayer {\n  return shared.getPlayer()\n}\n\n/** 换为自行配置的播放器（更换主题、接入用户偏好）。自动建立的播放器会被销毁。 */\nexport function setSoundPlayer(player: SoundPlayer): void {\n  shared.setPlayer(player)\n}\n\nexport interface ToastSoundOptions extends Omit<ToastSoundServiceOptions, 'player' | 'attachUnlock'> {\n  /** 使用哪个播放器，默认共享播放器。 */\n  player?: SoundPlayer\n}\n\n/**\n * 为命令式通知服务配上声音：入队即发声，调用点无需修改。\n *\n * ```ts\n * export const toast = withToastSound(createToastService())\n * toast.success('已保存') // 视觉 + 听觉\n * ```\n *\n * `update` 只在类型改变且新类型不是 loading 时发声：上传完成时应当发声，\n * 修改文案不应发声。\n */\nexport function withToastSound(service: ToastService, options: ToastSoundOptions = {}): ToastService {\n  return withToastSoundService(service, {\n    ...options,\n    player: options.player ?? getSoundPlayer(),\n    attachUnlock: attachDocumentSoundUnlock,\n  })\n}\n\nexport interface DialogSoundOptions extends Omit<DialogSoundServiceOptions, 'player' | 'attachUnlock'> {\n  player?: SoundPlayer\n}\n\n/**\n * 为命令式确认框服务配上声音：弹出时发声，关闭时不发声\n * （按钮的按下声与随后的通知已经表明了结果）。\n */\nexport function withDialogSound(service: DialogService, options: DialogSoundOptions = {}): DialogService {\n  return withDialogSoundService(service, {\n    ...options,\n    player: options.player ?? getSoundPlayer(),\n    attachUnlock: attachDocumentSoundUnlock,\n  })\n}\n\nexport interface SoundDirectiveOptions extends SharedSoundPressOptions {}\n\nexport type SoundDirectiveValue = string | SoundDirectiveOptions | undefined\n\nconst bound = new WeakMap<HTMLElement, { handler: () => void, options: ReturnType<typeof resolveSoundPressOptions> }>()\n\n/**\n * `v-sound`：为任意元素按下时配一声。\n *\n * 挂在 click 上而不是 pointerdown：键盘按 Enter / Space 激活也要发声，\n * 而按下后拖开取消的操作不应发声。\n *\n * ```vue\n * <XhButton v-sound>提交</XhButton>\n * <XhButton v-sound=\"'send'\">发送</XhButton>\n * <div v-sound=\"{ sound: 'toggle-on', volume: 0.6 }\" />\n * ```\n */\nexport const vSound: Directive<HTMLElement, SoundDirectiveValue> = {\n  mounted(el, binding) {\n    const entry = {\n      options: resolveSoundPressOptions(binding.value),\n      handler: (): void => {\n        if (isSoundTargetDisabled(el))\n          return\n        const { sound, volume, player } = entry.options\n        ;(player ?? getSoundPlayer()).play(sound, volume === undefined ? undefined : { volume })\n      },\n    }\n    bound.set(el, entry)\n    el.addEventListener('click', entry.handler)\n  },\n  updated(el, binding) {\n    const entry = bound.get(el)\n    if (entry)\n      entry.options = resolveSoundPressOptions(binding.value)\n  },\n  unmounted(el) {\n    const entry = bound.get(el)\n    if (entry)\n      el.removeEventListener('click', entry.handler)\n    bound.delete(el)\n  },\n}\n"],"mappings":";;AAuBA,MAAM,SAAS,kCAAkC;;;;;AAMjD,SAAgB,iBAA8B;CAC5C,OAAO,OAAO,UAAU;AAC1B;;AAGA,SAAgB,eAAe,QAA2B;CACxD,OAAO,UAAU,MAAM;AACzB;;;;;;;;;;;;AAkBA,SAAgB,eAAe,SAAuB,UAA6B,CAAC,GAAiB;CACnG,OAAO,sBAAsB,SAAS;EACpC,GAAG;EACH,QAAQ,QAAQ,UAAU,eAAe;EACzC,cAAc;CAChB,CAAC;AACH;;;;;AAUA,SAAgB,gBAAgB,SAAwB,UAA8B,CAAC,GAAkB;CACvG,OAAO,uBAAuB,SAAS;EACrC,GAAG;EACH,QAAQ,QAAQ,UAAU,eAAe;EACzC,cAAc;CAChB,CAAC;AACH;AAMA,MAAM,wBAAQ,IAAI,QAAoG;;;;;;;;;;;;;AActH,MAAa,SAAsD;CACjE,QAAQ,IAAI,SAAS;EACnB,MAAM,QAAQ;GACZ,SAAS,yBAAyB,QAAQ,KAAK;GAC/C,eAAqB;IACnB,IAAI,sBAAsB,EAAE,GAC1B;IACF,MAAM,EAAE,OAAO,QAAQ,WAAW,MAAM;IACvC,CAAC,UAAU,eAAe,EAAA,CAAG,KAAK,OAAO,WAAW,KAAA,IAAY,KAAA,IAAY,EAAE,OAAO,CAAC;GACzF;EACF;EACA,MAAM,IAAI,IAAI,KAAK;EACnB,GAAG,iBAAiB,SAAS,MAAM,OAAO;CAC5C;CACA,QAAQ,IAAI,SAAS;EACnB,MAAM,QAAQ,MAAM,IAAI,EAAE;EAC1B,IAAI,OACF,MAAM,UAAU,yBAAyB,QAAQ,KAAK;CAC1D;CACA,UAAU,IAAI;EACZ,MAAM,QAAQ,MAAM,IAAI,EAAE;EAC1B,IAAI,OACF,GAAG,oBAAoB,SAAS,MAAM,OAAO;EAC/C,MAAM,OAAO,EAAE;CACjB;AACF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xihan-ui/vue",
   "type": "module",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "XiHan.UI Vue adapter — components, composables, machine runtime.",
   "author": {
     "name": "XiHanFun",
@@ -59,45 +59,48 @@
   },
   "peerDependencies": {
     "vue": "^3.5.0",
-    "@xihan-ui/backgrounds": "^1.0.0",
-    "@xihan-ui/sound": "^1.0.0"
+    "@xihan-ui/backgrounds": "^2.0.0",
+    "@xihan-ui/code-highlight": "^2.0.0",
+    "@xihan-ui/sound": "^2.0.0"
   },
   "peerDependenciesMeta": {
     "@xihan-ui/backgrounds": {
       "optional": true
     },
+    "@xihan-ui/code-highlight": {
+      "optional": true
+    },
     "@xihan-ui/sound": {
       "optional": true
     }
   },
   "dependencies": {
-    "@xihan-ui/behavior": "^1.0.0",
-    "@xihan-ui/code-highlight": "^1.0.0",
-    "@xihan-ui/headless": "^1.0.0",
-    "@xihan-ui/kernel": "^1.0.0",
-    "@xihan-ui/machine": "^1.0.0",
-    "@xihan-ui/motion": "^1.0.0",
-    "@xihan-ui/position": "^1.0.0"
+    "@xihan-ui/core": "^2.0.0",
+    "@xihan-ui/headless": "^2.0.0",
+    "@xihan-ui/motion": "^2.0.0",
+    "@xihan-ui/pointer": "^2.0.0",
+    "@xihan-ui/position": "^2.0.0"
   },
   "devDependencies": {
-    "@vitest/browser": "^4.1.10",
-    "@vitest/browser-playwright": "^4.1.10",
+    "@vitest/browser": "^4.1.11",
+    "@vitest/browser-playwright": "^4.1.11",
     "@vue/test-utils": "^2.4.6",
     "jsdom": "^27.0.0",
     "playwright": "^1.62.0",
-    "vitest": "^4.1.10",
+    "vitest": "^4.1.11",
     "vue": "^3.5.40",
-    "@xihan-ui/backgrounds": "1.0.0",
+    "@xihan-ui/backgrounds": "2.0.0",
     "@xihan-ui/build": "0.0.0",
-    "@xihan-ui/sound": "1.0.0",
-    "@xihan-ui/styles": "1.0.0",
+    "@xihan-ui/code-highlight": "2.0.0",
+    "@xihan-ui/sound": "2.0.0",
+    "@xihan-ui/styles": "2.0.0",
     "@xihan-ui/testing": "0.0.0",
-    "@xihan-ui/tokens": "1.0.0",
+    "@xihan-ui/tokens": "2.0.0",
     "@xihan-ui/tsconfig": "0.0.0"
   },
   "scripts": {
     "build": "tsdown",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.test.json",
     "test": "vitest run",
     "test:browser": "vitest run --config vitest.browser.config.ts"
   }

package/dist/components/calendar/calendar.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"calendar.d.ts","names":[],"sources":["../../../src/components/calendar/calendar.ts"],"mappings":";;;;KAQK,gBAAgB;;KAGT,wBAAwB,KAClC;cAmBW,8BAAc,8BAAA;;IAIW,MAAA;;;;IACO,MAAA;;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAKH,MAAA,UAAU;;;;;;;;;;;;;;IAKhB,MAAA,SAAS;;;;;;IAGlB,MAAA,SAAS;;;;;IAEH,MAAA,SAAS;;;;;IAEF,MAAA,SAAS;;;;;;;;;;;;;;;;EAQnB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACA,yBAAA,UAAA,UAAU;EACN,wBAAA,eAAA,UAAU;EAChB,uBAAA,UAAA,UAAU;EACR,sBAAA,aAAA,UAAU;;;IAhCX,MAAA;;;;IACO,MAAA;;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;IAKH,MAAA,UAAU;;;;;;;;;;;;;;IAKhB,MAAA,SAAS;;;;;;IAGlB,MAAA,SAAS;;;;;IAEH,MAAA,SAAS;;;;;IAEF,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAZU,oBAAA;;;;;;;;;EA4B9C,WAAC,OAAO,0BAA0B;kCAqC9C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAMhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,8BAAA;;;;;;;;;;;;;;;;qCAe5B;cAEW,4CAA4B,8BAAA;;;;;;;;;;;;;;;;qCAevC;cAEW,6CAA6B,8BAAA;;;;;;;;;;;;;;;;qCAcxC;cAEW,8BAAc,8BAAA;;;;;;;;;;;;;;;;qCAkBzB;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,8BAAA;;;;;;;;;;;;;;MAe/B,oDAAA;cAEW,iCAAiB,8BAAA;;IAIS,MAAA;;;;;;;IAAA,MAAA;;;MAWrC,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAkBzB;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}