@tiny-codes/react-easy 1.4.8 → 1.4.9

package/lib/hooks/useAudioPlayer.d.ts

@@ -0,0 +1,7 @@
+import AudioPlayer, { type AudioPlayerInit } from '../utils/AudioPlayer';
+/**
+ * - **EN:** A hook that provides an instance of the AudioPlayer class for managing audio playback.
+ * - **CN:** 一个提供AudioPlayer类实例的钩子，用于管理音频播放。
+ */
+declare const useAudioPlayer: (props?: AudioPlayerInit) => AudioPlayer;
+export default useAudioPlayer;

package/lib/hooks/useAudioPlayer.js

@@ -0,0 +1,42 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/useAudioPlayer.ts
+var useAudioPlayer_exports = {};
+__export(useAudioPlayer_exports, {
+  default: () => useAudioPlayer_default
+});
+module.exports = __toCommonJS(useAudioPlayer_exports);
+var import_react = require("react");
+var import_AudioPlayer = __toESM(require("../utils/AudioPlayer"));
+var useAudioPlayer = (props) => {
+  const ref = (0, import_react.useRef)(new import_AudioPlayer.default(props));
+  return ref.current;
+};
+var useAudioPlayer_default = useAudioPlayer;
+//# sourceMappingURL=useAudioPlayer.js.map

package/lib/hooks/useAudioPlayer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/hooks/useAudioPlayer.ts"],
+  "sourcesContent": ["import { useRef } from 'react';\nimport AudioPlayer, { type AudioPlayerInit } from '../utils/AudioPlayer';\n\n/**\n * - **EN:** A hook that provides an instance of the AudioPlayer class for managing audio playback.\n * - **CN:** 一个提供AudioPlayer类实例的钩子，用于管理音频播放。\n */\nconst useAudioPlayer = (props?: AudioPlayerInit): AudioPlayer => {\n  const ref = useRef<AudioPlayer>(new AudioPlayer(props));\n  return ref.current;\n};\n\nexport default useAudioPlayer;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAuB;AACvB,yBAAkD;AAMlD,IAAM,iBAAiB,CAAC,UAAyC;AAC/D,QAAM,UAAM,qBAAoB,IAAI,mBAAAA,QAAY,KAAK,CAAC;AACtD,SAAO,IAAI;AACb;AAEA,IAAO,yBAAQ;",
+  "names": ["AudioPlayer"]
+}

package/lib/hooks/useSSE.d.ts

@@ -0,0 +1,26 @@
+import type { EventSourceMessage, FetchEventSourceInit } from '@microsoft/fetch-event-source';
+export interface UseSSEProps<T = any> {
+    /** The URL to connect to */
+    url: RequestInfo;
+    /** Options for the connection. */
+    connectOptions?: Omit<FetchEventSourceInit, 'onmessage' | 'onerror' | 'onclose'>;
+    /** Automatically connect to the SSE channel. Default is `false`. */
+    autoConnect?: boolean;
+    /** Automatically close the connection when the component unmounts. Default is `true`. */
+    autoClose?: boolean;
+    /** Function to parse the incoming message. If not provided, the default JSON parser will be used. */
+    parseMessage?: (original: EventSourceMessage) => T;
+    /** Callback function to handle incoming messages. */
+    onMessage?: (messageData: T) => void;
+    /** Callback function to handle errors. */
+    onError?: (error: any) => void;
+    /** Callback function to handle connection closure. */
+    onClose?: () => void;
+}
+declare const useSSE: <T = any>(props: UseSSEProps<T>) => {
+    connect: (options?: FetchEventSourceInit & Partial<Pick<UseSSEProps, 'url'>>) => Promise<void>;
+    close: () => void;
+    isRequesting: boolean;
+    isConnected: boolean;
+};
+export default useSSE;

package/lib/hooks/useSSE.js

@@ -0,0 +1,128 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/useSSE.ts
+var useSSE_exports = {};
+__export(useSSE_exports, {
+  default: () => useSSE_default
+});
+module.exports = __toCommonJS(useSSE_exports);
+var import_react = require("react");
+var import_fetch_event_source = require("@microsoft/fetch-event-source");
+var import_useRefFunction = __toESM(require("./useRefFunction"));
+var import_useRefValue = __toESM(require("./useRefValue"));
+var useSSE = (props) => {
+  const { url, autoConnect, connectOptions, onMessage, parseMessage, onError, onClose } = props;
+  const autoConnectRef = (0, import_useRefValue.default)(autoConnect);
+  const [isRequesting, setIsRequesting] = (0, import_react.useState)(false);
+  const isRequestingRef = (0, import_useRefValue.default)(isRequesting);
+  const [isConnected, setIsConnected] = (0, import_react.useState)(false);
+  const abortCtrlRef = (0, import_react.useRef)(void 0);
+  const connect = (0, import_useRefFunction.default)(async (options) => {
+    const {
+      url: connectUrl = url,
+      headers = {},
+      onopen,
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
+      onmessage,
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
+      onclose,
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
+      onerror,
+      ...restOptions
+    } = { ...connectOptions, ...options };
+    abortCtrlRef.current = new AbortController();
+    try {
+      setIsRequesting(true);
+      setIsConnected(false);
+      await (0, import_fetch_event_source.fetchEventSource)(connectUrl, {
+        method: "post",
+        signal: abortCtrlRef.current.signal,
+        openWhenHidden: true,
+        onopen: async (response) => {
+          setIsConnected(true);
+          onopen == null ? void 0 : onopen(response);
+        },
+        onmessage(event) {
+          if (!isRequestingRef.current) {
+            setIsRequesting(false);
+          }
+          try {
+            let parsed;
+            if (parseMessage) {
+              parsed = parseMessage(event);
+            } else {
+              parsed = event.data ? JSON.parse(event.data) : void 0;
+            }
+            if (parsed != null) {
+              onMessage == null ? void 0 : onMessage(parsed);
+            }
+          } catch (error) {
+            console.error("Error parsing message data:", error);
+            console.log("The underlying event:", event);
+          }
+        },
+        onerror(error) {
+          setIsRequesting(false);
+          onError == null ? void 0 : onError(error);
+        },
+        onclose() {
+          setIsRequesting(false);
+          onClose == null ? void 0 : onClose();
+        },
+        headers: {
+          "Content-Type": "application/json",
+          ...headers
+        },
+        ...restOptions
+      });
+    } finally {
+      setIsRequesting(false);
+    }
+  });
+  const close = (0, import_useRefFunction.default)(() => {
+    setIsConnected(false);
+    if (isConnected && abortCtrlRef.current) {
+      abortCtrlRef.current.abort();
+    }
+  });
+  (0, import_react.useEffect)(() => {
+    if (autoConnectRef.current) {
+      connect();
+    }
+    return close;
+  }, []);
+  return {
+    connect,
+    close,
+    isRequesting,
+    isConnected
+  };
+};
+var useSSE_default = useSSE;
+//# sourceMappingURL=useSSE.js.map

package/lib/hooks/useSSE.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/hooks/useSSE.ts"],
+  "sourcesContent": ["import { useEffect, useRef, useState } from 'react';\nimport type { EventSourceMessage, FetchEventSourceInit } from '@microsoft/fetch-event-source';\nimport { fetchEventSource } from '@microsoft/fetch-event-source';\nimport useRefFunction from './useRefFunction';\nimport useRefValue from './useRefValue';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface UseSSEProps<T = any> {\n  /** The URL to connect to */\n  url: RequestInfo;\n  /** Options for the connection. */\n  connectOptions?: Omit<FetchEventSourceInit, 'onmessage' | 'onerror' | 'onclose'>;\n  /** Automatically connect to the SSE channel. Default is `false`. */\n  autoConnect?: boolean;\n  /** Automatically close the connection when the component unmounts. Default is `true`. */\n  autoClose?: boolean;\n  /** Function to parse the incoming message. If not provided, the default JSON parser will be used. */\n  parseMessage?: (original: EventSourceMessage) => T;\n  /** Callback function to handle incoming messages. */\n  onMessage?: (messageData: T) => void;\n  /** Callback function to handle errors. */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  onError?: (error: any) => void;\n  /** Callback function to handle connection closure. */\n  onClose?: () => void;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst useSSE = <T = any>(props: UseSSEProps<T>) => {\n  const { url, autoConnect, connectOptions, onMessage, parseMessage, onError, onClose } = props;\n  const autoConnectRef = useRefValue(autoConnect);\n  const [isRequesting, setIsRequesting] = useState(false);\n  const isRequestingRef = useRefValue(isRequesting);\n  const [isConnected, setIsConnected] = useState<boolean>(false);\n  const abortCtrlRef = useRef<AbortController | undefined>(undefined);\n\n  const connect = useRefFunction(async (options?: FetchEventSourceInit & Partial<Pick<UseSSEProps, 'url'>>) => {\n    const {\n      url: connectUrl = url,\n      headers = {},\n      onopen,\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      onmessage,\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      onclose,\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      onerror,\n      ...restOptions\n    } = { ...connectOptions, ...options };\n    abortCtrlRef.current = new AbortController();\n    try {\n      setIsRequesting(true);\n      setIsConnected(false);\n      await fetchEventSource(connectUrl, {\n        method: 'post',\n        signal: abortCtrlRef.current.signal,\n        openWhenHidden: true,\n        onopen: async (response: Response) => {\n          setIsConnected(true);\n          onopen?.(response);\n        },\n        onmessage(event) {\n          if (!isRequestingRef.current) {\n            setIsRequesting(false);\n          }\n          try {\n            let parsed: T;\n            if (parseMessage) {\n              parsed = parseMessage(event);\n            } else {\n              parsed = event.data ? JSON.parse(event.data) : undefined;\n            }\n            if (parsed != null) {\n              onMessage?.(parsed);\n            }\n          } catch (error) {\n            console.error('Error parsing message data:', error);\n            console.log('The underlying event:', event);\n          }\n        },\n        onerror(error) {\n          setIsRequesting(false);\n          onError?.(error);\n        },\n        onclose() {\n          setIsRequesting(false);\n          onClose?.();\n        },\n        headers: {\n          'Content-Type': 'application/json',\n          ...headers,\n        },\n        ...restOptions,\n      });\n    } finally {\n      setIsRequesting(false);\n    }\n  });\n\n  const close = useRefFunction(() => {\n    setIsConnected(false);\n    if (isConnected && abortCtrlRef.current) {\n      abortCtrlRef.current.abort();\n    }\n  });\n\n  useEffect(() => {\n    if (autoConnectRef.current) {\n      connect();\n    }\n    return close;\n  }, []);\n\n  // 清理函数\n  return {\n    connect,\n    close,\n    isRequesting,\n    isConnected,\n  };\n};\n\nexport default useSSE;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA4C;AAE5C,gCAAiC;AACjC,4BAA2B;AAC3B,yBAAwB;AAwBxB,IAAM,SAAS,CAAU,UAA0B;AACjD,QAAM,EAAE,KAAK,aAAa,gBAAgB,WAAW,cAAc,SAAS,QAAQ,IAAI;AACxF,QAAM,qBAAiB,mBAAAA,SAAY,WAAW;AAC9C,QAAM,CAAC,cAAc,eAAe,QAAI,uBAAS,KAAK;AACtD,QAAM,sBAAkB,mBAAAA,SAAY,YAAY;AAChD,QAAM,CAAC,aAAa,cAAc,QAAI,uBAAkB,KAAK;AAC7D,QAAM,mBAAe,qBAAoC,MAAS;AAElE,QAAM,cAAU,sBAAAC,SAAe,OAAO,YAAuE;AAC3G,UAAM;AAAA,MACJ,KAAK,aAAa;AAAA,MAClB,UAAU,CAAC;AAAA,MACX;AAAA;AAAA,MAEA;AAAA;AAAA,MAEA;AAAA;AAAA,MAEA;AAAA,MACA,GAAG;AAAA,IACL,IAAI,EAAE,GAAG,gBAAgB,GAAG,QAAQ;AACpC,iBAAa,UAAU,IAAI,gBAAgB;AAC3C,QAAI;AACF,sBAAgB,IAAI;AACpB,qBAAe,KAAK;AACpB,gBAAM,4CAAiB,YAAY;AAAA,QACjC,QAAQ;AAAA,QACR,QAAQ,aAAa,QAAQ;AAAA,QAC7B,gBAAgB;AAAA,QAChB,QAAQ,OAAO,aAAuB;AACpC,yBAAe,IAAI;AACnB,2CAAS;AAAA,QACX;AAAA,QACA,UAAU,OAAO;AACf,cAAI,CAAC,gBAAgB,SAAS;AAC5B,4BAAgB,KAAK;AAAA,UACvB;AACA,cAAI;AACF,gBAAI;AACJ,gBAAI,cAAc;AAChB,uBAAS,aAAa,KAAK;AAAA,YAC7B,OAAO;AACL,uBAAS,MAAM,OAAO,KAAK,MAAM,MAAM,IAAI,IAAI;AAAA,YACjD;AACA,gBAAI,UAAU,MAAM;AAClB,qDAAY;AAAA,YACd;AAAA,UACF,SAAS,OAAP;AACA,oBAAQ,MAAM,+BAA+B,KAAK;AAClD,oBAAQ,IAAI,yBAAyB,KAAK;AAAA,UAC5C;AAAA,QACF;AAAA,QACA,QAAQ,OAAO;AACb,0BAAgB,KAAK;AACrB,6CAAU;AAAA,QACZ;AAAA,QACA,UAAU;AACR,0BAAgB,KAAK;AACrB;AAAA,QACF;AAAA,QACA,SAAS;AAAA,UACP,gBAAgB;AAAA,UAChB,GAAG;AAAA,QACL;AAAA,QACA,GAAG;AAAA,MACL,CAAC;AAAA,IACH,UAAE;AACA,sBAAgB,KAAK;AAAA,IACvB;AAAA,EACF,CAAC;AAED,QAAM,YAAQ,sBAAAA,SAAe,MAAM;AACjC,mBAAe,KAAK;AACpB,QAAI,eAAe,aAAa,SAAS;AACvC,mBAAa,QAAQ,MAAM;AAAA,IAC7B;AAAA,EACF,CAAC;AAED,8BAAU,MAAM;AACd,QAAI,eAAe,SAAS;AAC1B,cAAQ;AAAA,IACV;AACA,WAAO;AAAA,EACT,GAAG,CAAC,CAAC;AAGL,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,IAAO,iBAAQ;",
+  "names": ["useRefValue", "useRefFunction"]
+}

package/lib/utils/AudioPlayer.d.ts

@@ -0,0 +1,159 @@
+export type AudioSource = string | ReadableStreamDefaultReader<Uint8Array>;
+export interface AudioPlayerInit {
+    /**
+     * - **EN:** Audio source (URL or streaming data)
+     * - **CN:** 音频源（URL或流数据）
+     */
+    source?: AudioSource | (() => AudioSource | Promise<AudioSource>);
+    /**
+     * - **EN:** Initial volume level (0-1). Default is `0.5`
+     * - **CN:** 初始音量级别（0-1）。默认值为`0.5`
+     */
+    volume?: number;
+    /**
+     * - **EN:** Callback when audio starts playing
+     * - **CN:** 音频开始播放时的回调
+     */
+    onPlay?: () => void;
+    /**
+     * - **EN:** Callback when audio is paused
+     * - **CN:** 音频暂停时的回调
+     */
+    onPause?: () => void;
+    /**
+     * - **EN:** Callback when audio is stopped
+     * - **CN:** 音频停止时的回调
+     */
+    onStop?: () => void;
+    /**
+     * - **EN:** Callback when audio playback ends
+     * - **CN:** 音频播放结束时的回调
+     */
+    onPlayEnd?: () => void;
+    /**
+     * - **EN:** Callback when an error occurs
+     * - **CN:** 发生错误时的回调
+     */
+    onError?: (error: any) => void;
+}
+/**
+ * - **EN:** An audio player class that supports URL or streaming data input
+ * - **CN:** 一个音频播放器类，支持URL或流数据输入
+ */
+declare class AudioPlayer {
+    private audio;
+    private volume;
+    private audioContext;
+    private gainNode;
+    private sourceNode;
+    private options;
+    private onPlayEnd;
+    /**
+     * - **EN:** Creates an audio player instance
+     * - **CN:** 创建音频播放器实例
+     *
+     * @param source - can be a URL string or ReadableStreamDefaultReader |
+     *   可以是URL字符串或ReadableStreamDefaultReader
+     */
+    constructor(options?: AudioPlayerInit);
+    /**
+     * - **EN:** Check if audio is currently playing
+     * - **CN:** 检查音频是否正在播放
+     */
+    get isPlaying(): boolean;
+    /**
+     * - **EN:** Play audio. If previously paused, will resume from the pause position
+     * - **CN:** 播放音频 如果之前暂停过，将从暂停位置继续播放
+     */
+    play(): Promise<void>;
+    /**
+     * - **EN:** Set current playback time (in seconds)
+     * - **CN:** 设置当前播放时间（以秒为单位）
+     *
+     * @param time - time in seconds | 时间（秒）
+     */
+    gotoTime(time: number): void;
+    /**
+     * - **EN:** Set playback position by percentage
+     * - **CN:** 按百分比设置播放位置
+     *
+     * @param percent - percentage (0-1) | 百分比（0-1）
+     */
+    gotoPercent(percent: number): void;
+    /**
+     * - **EN:** Pause audio playback. When played again, will continue from current position
+     * - **CN:** 暂停音频播放 再次播放时将从当前位置继续
+     */
+    pause(): void;
+    /**
+     * - **EN:** Stop audio playback. Progress will reset to the beginning
+     * - **CN:** 停止音频播放 进度会重置到开始位置
+     */
+    stop(): void;
+    /**
+     * - **EN:** Update audio source
+     * - **CN:** 更新音频源
+     *
+     * @param source - can be a URL `string` or `ReadableStreamDefaultReader` |
+     *   可以是URL字符串或`ReadableStreamDefaultReader`
+     */
+    setAudioSource(source?: AudioSource): Promise<void>;
+    /**
+     * - **EN:** Increase volume (by 10% each time)
+     * - **CN:** 增加音量（每次增加10%）
+     *
+     * @param percent - increase percentage (default 10%) | 增加百分比（默认10%）
+     */
+    volumeUp(percent?: number): void;
+    /**
+     * - **EN:** Decrease volume (by 10% each time)
+     * - **CN:** 降低音量（每次降低10%）
+     *
+     * @param percent - decrease percentage (default 10%) | 降低百分比（默认10%）
+     */
+    volumeDown(percent?: number): void;
+    /**
+     * - **EN:** Set volume to a specific value (0-1)
+     * - **CN:** 将音量设置为特定值（0-1）
+     *
+     * @param value - new volume value (0-1) | 新的音量值（0-1）
+     */
+    setVolume(value: number): void;
+    /**
+     * - **EN:** Get current volume value (0-1)
+     * - **CN:** 获取当前音量值(0-1)
+     */
+    getVolume(): number;
+    /**
+     * - **EN:** Get current playback time (seconds)
+     * - **CN:** 获取当前播放时间(秒)
+     */
+    getCurrentTime(): number;
+    /**
+     * - **EN:** Get total audio duration (seconds)
+     * - **CN:** 获取音频总时长(秒)
+     */
+    getDuration(): number;
+    /**
+     * - **EN:** Add audio event listener
+     * - **CN:** 添加音频事件监听器
+     */
+    addEventListener: HTMLAudioElement['addEventListener'];
+    /**
+     * - **EN:** Remove audio event listener
+     * - **CN:** 移除音频事件监听器
+     */
+    removeEventListener: HTMLAudioElement['removeEventListener'];
+    /**
+     * - **EN:** Release resources
+     * - **CN:** 释放资源
+     */
+    dispose(): void;
+    /** Process streaming data source */
+    private handleStreamSource;
+    /** Initialize Web Audio API for better volume control */
+    private initAudioContext;
+    /** Update audio playback volume */
+    private updateVolume;
+}
+export default AudioPlayer;

package/lib/utils/AudioPlayer.js

@@ -0,0 +1,284 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/AudioPlayer.ts
+var AudioPlayer_exports = {};
+__export(AudioPlayer_exports, {
+  default: () => AudioPlayer_default
+});
+module.exports = __toCommonJS(AudioPlayer_exports);
+var AudioPlayer = class {
+  /**
+   * - **EN:** Creates an audio player instance
+   * - **CN:** 创建音频播放器实例
+   *
+   * @param source - can be a URL string or ReadableStreamDefaultReader |
+   *   可以是URL字符串或ReadableStreamDefaultReader
+   */
+  constructor(options) {
+    this.audioContext = null;
+    this.gainNode = null;
+    this.sourceNode = null;
+    /**
+     * - **EN:** Add audio event listener
+     * - **CN:** 添加音频事件监听器
+     */
+    this.addEventListener = (event, listener) => {
+      this.audio.addEventListener(event, listener);
+    };
+    /**
+     * - **EN:** Remove audio event listener
+     * - **CN:** 移除音频事件监听器
+     */
+    this.removeEventListener = (event, listener) => {
+      this.audio.removeEventListener(event, listener);
+    };
+    const { source, volume } = options || {};
+    this.options = options;
+    this.audio = new Audio();
+    this.volume = volume != null ? Math.min(1, Math.max(0, volume)) : 0.5;
+    this.audio.volume = this.volume;
+    if (typeof source === "function") {
+      const result = source();
+      if (typeof result === "object" && "then" in result && typeof result.then === "function") {
+        result.then((data) => this.setAudioSource(data));
+      } else {
+        this.setAudioSource(result);
+      }
+    } else {
+      this.setAudioSource(source);
+    }
+    this.onPlayEnd = () => {
+      var _a, _b;
+      (_b = (_a = this.options) == null ? void 0 : _a.onPlayEnd) == null ? void 0 : _b.call(_a);
+    };
+    this.addEventListener("ended", this.onPlayEnd);
+  }
+  /**
+   * - **EN:** Check if audio is currently playing
+   * - **CN:** 检查音频是否正在播放
+   */
+  get isPlaying() {
+    var _a;
+    return ((_a = this.audioContext) == null ? void 0 : _a.state) === "running";
+  }
+  /**
+   * - **EN:** Play audio. If previously paused, will resume from the pause position
+   * - **CN:** 播放音频 如果之前暂停过，将从暂停位置继续播放
+   */
+  async play() {
+    var _a, _b, _c, _d, _e;
+    if (!this.audioContext) {
+      this.initAudioContext();
+    }
+    if (((_a = this.audioContext) == null ? void 0 : _a.state) === "suspended") {
+      await this.audioContext.resume();
+    }
+    try {
+      await this.audio.play();
+      (_c = (_b = this.options) == null ? void 0 : _b.onPlay) == null ? void 0 : _c.call(_b);
+    } catch (error) {
+      console.error("Error playing audio:", error);
+      (_e = (_d = this.options) == null ? void 0 : _d.onError) == null ? void 0 : _e.call(_d, error);
+    }
+  }
+  /**
+   * - **EN:** Set current playback time (in seconds)
+   * - **CN:** 设置当前播放时间（以秒为单位）
+   *
+   * @param time - time in seconds | 时间（秒）
+   */
+  gotoTime(time) {
+    const newTime = Math.max(0, time);
+    if (!isNaN(this.audio.duration)) {
+      this.audio.currentTime = Math.min(newTime, this.audio.duration);
+    } else {
+      this.audio.currentTime = newTime;
+    }
+  }
+  /**
+   * - **EN:** Set playback position by percentage
+   * - **CN:** 按百分比设置播放位置
+   *
+   * @param percent - percentage (0-1) | 百分比（0-1）
+   */
+  gotoPercent(percent) {
+    if (isNaN(this.audio.duration)) {
+      return;
+    }
+    const clampedPercent = Math.min(1, Math.max(0, percent));
+    const newTime = this.audio.duration * clampedPercent;
+    this.audio.currentTime = newTime;
+  }
+  /**
+   * - **EN:** Pause audio playback. When played again, will continue from current position
+   * - **CN:** 暂停音频播放 再次播放时将从当前位置继续
+   */
+  pause() {
+    var _a, _b;
+    this.audio.pause();
+    (_b = (_a = this.options) == null ? void 0 : _a.onPause) == null ? void 0 : _b.call(_a);
+  }
+  /**
+   * - **EN:** Stop audio playback. Progress will reset to the beginning
+   * - **CN:** 停止音频播放 进度会重置到开始位置
+   */
+  stop() {
+    var _a, _b;
+    this.audio.pause();
+    this.audio.currentTime = 0;
+    (_b = (_a = this.options) == null ? void 0 : _a.onStop) == null ? void 0 : _b.call(_a);
+  }
+  /**
+   * - **EN:** Update audio source
+   * - **CN:** 更新音频源
+   *
+   * @param source - can be a URL `string` or `ReadableStreamDefaultReader` |
+   *   可以是URL字符串或`ReadableStreamDefaultReader`
+   */
+  async setAudioSource(source) {
+    this.audio.pause();
+    this.audio.src = "";
+    if (typeof source === "string") {
+      this.audio.src = source;
+    } else {
+      await this.handleStreamSource(source);
+    }
+  }
+  /**
+   * - **EN:** Increase volume (by 10% each time)
+   * - **CN:** 增加音量（每次增加10%）
+   *
+   * @param percent - increase percentage (default 10%) | 增加百分比（默认10%）
+   */
+  volumeUp(percent = 0.1) {
+    this.volume = Math.min(1, this.volume + percent);
+    this.updateVolume();
+  }
+  /**
+   * - **EN:** Decrease volume (by 10% each time)
+   * - **CN:** 降低音量（每次降低10%）
+   *
+   * @param percent - decrease percentage (default 10%) | 降低百分比（默认10%）
+   */
+  volumeDown(percent = 0.1) {
+    this.volume = Math.max(0, this.volume - percent);
+    this.updateVolume();
+  }
+  /**
+   * - **EN:** Set volume to a specific value (0-1)
+   * - **CN:** 将音量设置为特定值（0-1）
+   *
+   * @param value - new volume value (0-1) | 新的音量值（0-1）
+   */
+  setVolume(value) {
+    this.volume = Math.min(1, Math.max(0, value));
+    this.updateVolume();
+  }
+  /**
+   * - **EN:** Get current volume value (0-1)
+   * - **CN:** 获取当前音量值(0-1)
+   */
+  getVolume() {
+    return this.volume;
+  }
+  /**
+   * - **EN:** Get current playback time (seconds)
+   * - **CN:** 获取当前播放时间(秒)
+   */
+  getCurrentTime() {
+    return this.audio.currentTime;
+  }
+  /**
+   * - **EN:** Get total audio duration (seconds)
+   * - **CN:** 获取音频总时长(秒)
+   */
+  getDuration() {
+    return this.audio.duration;
+  }
+  /**
+   * - **EN:** Release resources
+   * - **CN:** 释放资源
+   */
+  dispose() {
+    this.audio.pause();
+    this.audio.src = "";
+    this.removeEventListener("ended", this.onPlayEnd);
+    if (this.audioContext) {
+      try {
+        this.audioContext.close();
+      } catch (error) {
+        console.error("Error closing AudioContext:", error);
+      }
+      this.audioContext = null;
+    }
+    this.sourceNode = null;
+    this.gainNode = null;
+  }
+  /** Process streaming data source */
+  async handleStreamSource(reader) {
+    if (!reader)
+      return;
+    try {
+      const stream = new ReadableStream({
+        async pull(controller) {
+          try {
+            const { done, value } = await reader.read();
+            if (done) {
+              controller.close();
+            } else {
+              controller.enqueue(value);
+            }
+          } catch (err) {
+            controller.error(err);
+          }
+        }
+      });
+      const response = new Response(stream);
+      const blob = await response.blob();
+      const url = URL.createObjectURL(blob);
+      this.audio.src = url;
+      this.audio.onload = () => {
+        URL.revokeObjectURL(url);
+      };
+    } catch (error) {
+      console.error("Error processing audio stream:", error);
+    }
+  }
+  /** Initialize Web Audio API for better volume control */
+  initAudioContext() {
+    if (this.audioContext)
+      return;
+    this.audioContext = new AudioContext();
+    this.sourceNode = this.audioContext.createMediaElementSource(this.audio);
+    this.gainNode = this.audioContext.createGain();
+    this.sourceNode.connect(this.gainNode);
+    this.gainNode.connect(this.audioContext.destination);
+    this.gainNode.gain.value = this.volume;
+  }
+  /** Update audio playback volume */
+  updateVolume() {
+    if (this.gainNode) {
+      this.gainNode.gain.value = this.volume;
+    } else {
+      this.audio.volume = this.volume;
+    }
+  }
+};
+var AudioPlayer_default = AudioPlayer;
+//# sourceMappingURL=AudioPlayer.js.map