xxf_react 0.5.4 → 0.5.6

package/dist/media/playback-queue-store.d.ts

@@ -3,6 +3,8 @@
  *
  * 支持多 Tab / 多页面场景，全局只有一个视频在播放。
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @module playback-queue-store
  * @see {@link ./playback-queue-store.md} 详细文档
  */
@@ -11,6 +13,8 @@
  *
  * 每个 source 代表一个独立的播放列表，通常对应一个 Tab 或页面。
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @example
  * ```ts
  * const homeSource: SourceData = {
@@ -24,6 +28,8 @@ interface SourceData {
      *
      * - 有序数组，决定播放顺序
      * - ID 应该是唯一的字符串标识符
+     *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
      */
     itemIds: string[];
 }
@@ -32,6 +38,8 @@ interface SourceData {
  *
  * 核心状态结构，包含所有 source 的数据和当前播放状态。
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @example
  * ```ts
  * const state: PlaybackQueueState = {
@@ -53,6 +61,8 @@ interface PlaybackQueueState {
      *
      * key: source 名称（如 'home', 'community', 'detail-123'）
      * value: 该 source 的数据
+     *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
      */
     sources: Record<string, SourceData>;
     /**
@@ -61,6 +71,8 @@ interface PlaybackQueueState {
      * 用于 `playById` 快速查找某个 ID 属于哪个 source。
      * 复杂度从 O(n*m) 降低到 O(1)。
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @internal 内部使用，自动维护
      */
     itemIdToSource: Record<string, string>;
@@ -69,6 +81,8 @@ interface PlaybackQueueState {
      *
      * - 播放、next、prev 操作都在此 source 内进行
      * - 为 null 表示没有激活的 source
+     *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
      */
     activeSource: string | null;
     /**
@@ -76,11 +90,15 @@ interface PlaybackQueueState {
      *
      * - 全局唯一，保证同一时间只有一个视频在播放
      * - 为 null 表示没有视频在播放
+     *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
      */
     currentId: string | null;
     /**
      * 是否静音
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @default true（默认静音，符合浏览器自动播放策略）
      */
     muted: boolean;
@@ -90,6 +108,8 @@ interface PlaybackQueueState {
      * - true: 播放到最后一个后自动回到第一个
      * - false: 播放到最后一个后停止
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @default true
      */
     loop: boolean;
@@ -98,6 +118,8 @@ interface PlaybackQueueState {
  * 播放队列操作方法接口
  *
  * 定义所有可用的操作方法。
+ *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
  */
 interface PlaybackQueueActions {
     /**
@@ -105,6 +127,8 @@ interface PlaybackQueueActions {
      *
      * 用于初始化或更新某个 Tab/页面的播放列表。
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @param source - source 名称，建议使用有意义的标识符
      *   - 'home' - 首页
      *   - 'community' - 社区页
@@ -131,6 +155,8 @@ interface PlaybackQueueActions {
      *
      * 用于滚动加载场景，追加新数据时不影响当前播放状态。
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @param source - source 名称
      * @param ids - 要追加的项目 ID 列表，会自动去重
      *
@@ -151,6 +177,8 @@ interface PlaybackQueueActions {
      * 用于页面卸载时清理数据，防止内存泄漏。
      * 如果移除的是当前激活的 source，会自动停止播放。
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @param source - 要移除的 source 名称
      *
      * @example
@@ -168,6 +196,8 @@ interface PlaybackQueueActions {
      *
      * 会自动切换 activeSource 到指定的 source。
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @param source - source 名称
      * @param id - 项目 ID
      *
@@ -188,6 +218,8 @@ interface PlaybackQueueActions {
      * 优先在当前 activeSource 中查找，找不到则通过反向索引查找。
      * 适用于不关心具体 source 的场景。
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @param id - 项目 ID
      *
      * @example
@@ -209,6 +241,8 @@ interface PlaybackQueueActions {
      * - loop=true: 回到第一个
      * - loop=false: 停止播放（currentId 变为 null）
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @example
      * ```tsx
      * const { next } = usePlaybackActions()
@@ -225,6 +259,8 @@ interface PlaybackQueueActions {
      * - loop=true: 跳到最后一个
      * - loop=false: 停止播放
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @example
      * ```tsx
      * const { prev } = usePlaybackActions()
@@ -238,6 +274,8 @@ interface PlaybackQueueActions {
      *
      * 将 currentId 设为 null，但保留 activeSource。
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @example
      * ```tsx
      * const { stop } = usePlaybackActions()
@@ -251,6 +289,8 @@ interface PlaybackQueueActions {
      *
      * 应在视频的 onEnded 事件中调用，会自动播放下一个。
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @example
      * ```tsx
      * const { onEnded } = usePlaybackActions()
@@ -262,6 +302,8 @@ interface PlaybackQueueActions {
     /**
      * 设置静音状态
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @param muted - true 静音，false 取消静音
      *
      * @example
@@ -276,6 +318,8 @@ interface PlaybackQueueActions {
     /**
      * 切换静音状态
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @example
      * ```tsx
      * const { toggleMute } = usePlaybackActions()
@@ -290,6 +334,8 @@ interface PlaybackQueueActions {
     /**
      * 设置循环播放
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @param loop - true 循环播放，false 播完停止
      *
      * @example
@@ -306,6 +352,8 @@ interface PlaybackQueueActions {
      * 将状态恢复到初始值，清空所有 source 和播放状态。
      * 通常用于用户登出或需要完全重置的场景。
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @example
      * ```tsx
      * const { reset } = usePlaybackActions()
@@ -323,6 +371,8 @@ interface PlaybackQueueActions {
  * 播放队列 Store 完整类型
  *
  * 包含状态和操作方法。
+ *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
  */
 type PlaybackQueueStore = PlaybackQueueState & PlaybackQueueActions;
 /**
@@ -330,6 +380,8 @@ type PlaybackQueueStore = PlaybackQueueState & PlaybackQueueActions;
  *
  * 使用 `subscribeWithSelector` 中间件支持选择性订阅。
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @example
  * ```tsx
  * // 直接使用 store（不推荐，建议使用封装的 hooks）
@@ -351,6 +403,8 @@ export declare const usePlaybackQueueStore: import("zustand").UseBoundStore<Omit
  * 使用 shallow 比较，避免不必要的重渲染。
  * 返回的方法引用稳定，可以安全地用作依赖项。
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @returns 所有操作方法
  *
  * @example
@@ -376,6 +430,8 @@ export declare function usePlaybackActions(): PlaybackQueueActions;
  * 选择性订阅，只有当该项目的播放状态变化时才会重渲染。
  * 这是性能最优的播放状态判断方式。
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @param id - 项目 ID
  * @returns 是否正在播放
  *
@@ -394,6 +450,8 @@ export declare function usePlaybackIsPlaying(id: string): boolean;
 /**
  * 获取静音状态
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @returns 是否静音
  *
  * @example
@@ -407,6 +465,8 @@ export declare function usePlaybackMuted(): boolean;
 /**
  * 获取当前播放的项目 ID
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @returns 当前播放的 ID，没有播放时为 null
  *
  * @example
@@ -422,6 +482,8 @@ export declare function usePlaybackCurrentId(): string | null;
 /**
  * 获取当前激活的 source 名称
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @returns source 名称，没有激活时为 null
  *
  * @example
@@ -436,6 +498,8 @@ export declare function usePlaybackActiveSource(): string | null;
 /**
  * 获取循环播放状态
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @returns 是否循环播放
  *
  * @example
@@ -452,6 +516,8 @@ export declare function usePlaybackLoop(): boolean;
 /**
  * 获取指定 source 的项目 ID 列表
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @param source - source 名称
  * @returns 项目 ID 列表，source 不存在时返回空数组
  *
@@ -468,6 +534,8 @@ export declare function usePlaybackSourceItems(source: string): string[];
  *
  * 使用 shallow 比较，仅当 isPlaying 或 muted 变化时重渲染。
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @param id - 项目 ID
  * @returns { isPlaying: boolean, muted: boolean }
  *
@@ -499,6 +567,8 @@ export declare function usePlaybackItemState(id: string): {
  * - 不在 React 组件中的场景
  * - 需要命令式调用的场景
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @example
  * ```tsx
  * // 在事件回调中使用
@@ -525,90 +595,120 @@ export declare const PlaybackQueue: {
     /**
      * 获取当前状态快照（非响应式）
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @returns 当前完整状态
      */
     readonly getState: () => PlaybackQueueState;
     /**
      * 设置某个 source 的播放列表
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.setSource}
      */
     readonly setSource: (source: string, ids: string[], autoPlay?: boolean | undefined) => void;
     /**
      * 向某个 source 追加项目
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.appendToSource}
      */
     readonly appendToSource: (source: string, ids: string[]) => void;
     /**
      * 移除某个 source
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.removeSource}
      */
     readonly removeSource: (source: string) => void;
     /**
      * 播放指定项目
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.play}
      */
     readonly play: (source: string, id: string) => void;
     /**
      * 播放指定项目（自动查找 source）
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.playById}
      */
     readonly playById: (id: string) => void;
     /**
      * 播放下一个
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.next}
      */
     readonly next: () => void;
     /**
      * 播放上一个
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.prev}
      */
     readonly prev: () => void;
     /**
      * 停止播放
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.stop}
      */
     readonly stop: () => void;
     /**
      * 播放完成回调
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.onEnded}
      */
     readonly onEnded: () => void;
     /**
      * 设置静音状态
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.setMuted}
      */
     readonly setMuted: (muted: boolean) => void;
     /**
      * 切换静音状态
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.toggleMute}
      */
     readonly toggleMute: () => void;
     /**
      * 设置循环播放
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.setLoop}
      */
     readonly setLoop: (loop: boolean) => void;
     /**
      * 重置所有状态
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.reset}
      */
     readonly reset: () => void;
     /**
      * 订阅当前播放 ID 变化
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @param callback - 回调函数，参数为 (新值, 旧值)
      * @returns 取消订阅函数
      *
@@ -626,6 +726,8 @@ export declare const PlaybackQueue: {
     /**
      * 订阅 activeSource 变化
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @param callback - 回调函数，参数为 (新值, 旧值)
      * @returns 取消订阅函数
      */
@@ -633,6 +735,8 @@ export declare const PlaybackQueue: {
     /**
      * 订阅静音状态变化
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @param callback - 回调函数，参数为 (新值, 旧值)
      * @returns 取消订阅函数
      */

package/dist/media/playback-queue-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playback-queue-store.d.ts","sourceRoot":"","sources":["../../src/media/playback-queue-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"playback-queue-store.d.ts","sourceRoot":"","sources":["../../src/media/playback-queue-store.ts"],"names":[],"mappings":"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"}

package/dist/media/playback-queue-store.js

@@ -3,6 +3,8 @@
  *
  * 支持多 Tab / 多页面场景，全局只有一个视频在播放。
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @module playback-queue-store
  * @see {@link ./playback-queue-store.md} 详细文档
  */
@@ -61,6 +63,8 @@ function updateReverseIndexForSource(currentIndex, sourceName, oldIds, newIds) {
  *
  * 使用 `subscribeWithSelector` 中间件支持选择性订阅。
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @example
  * ```tsx
  * // 直接使用 store（不推荐，建议使用封装的 hooks）
@@ -306,6 +310,8 @@ const selectLoop = (state) => state.loop;
  * 使用 shallow 比较，避免不必要的重渲染。
  * 返回的方法引用稳定，可以安全地用作依赖项。
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @returns 所有操作方法
  *
  * @example
@@ -333,6 +339,8 @@ export function usePlaybackActions() {
  * 选择性订阅，只有当该项目的播放状态变化时才会重渲染。
  * 这是性能最优的播放状态判断方式。
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @param id - 项目 ID
  * @returns 是否正在播放
  *
@@ -353,6 +361,8 @@ export function usePlaybackIsPlaying(id) {
 /**
  * 获取静音状态
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @returns 是否静音
  *
  * @example
@@ -368,6 +378,8 @@ export function usePlaybackMuted() {
 /**
  * 获取当前播放的项目 ID
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @returns 当前播放的 ID，没有播放时为 null
  *
  * @example
@@ -385,6 +397,8 @@ export function usePlaybackCurrentId() {
 /**
  * 获取当前激活的 source 名称
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @returns source 名称，没有激活时为 null
  *
  * @example
@@ -401,6 +415,8 @@ export function usePlaybackActiveSource() {
 /**
  * 获取循环播放状态
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @returns 是否循环播放
  *
  * @example
@@ -419,6 +435,8 @@ export function usePlaybackLoop() {
 /**
  * 获取指定 source 的项目 ID 列表
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @param source - source 名称
  * @returns 项目 ID 列表，source 不存在时返回空数组
  *
@@ -437,6 +455,8 @@ export function usePlaybackSourceItems(source) {
  *
  * 使用 shallow 比较，仅当 isPlaying 或 muted 变化时重渲染。
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @param id - 项目 ID
  * @returns { isPlaying: boolean, muted: boolean }
  *
@@ -473,6 +493,8 @@ export function usePlaybackItemState(id) {
  * - 不在 React 组件中的场景
  * - 需要命令式调用的场景
  *
+ * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+ *
  * @example
  * ```tsx
  * // 在事件回调中使用
@@ -499,90 +521,120 @@ export const PlaybackQueue = {
     /**
      * 获取当前状态快照（非响应式）
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @returns 当前完整状态
      */
     getState: () => usePlaybackQueueStore.getState(),
     /**
      * 设置某个 source 的播放列表
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.setSource}
      */
     setSource: (...args) => usePlaybackQueueStore.getState().setSource(...args),
     /**
      * 向某个 source 追加项目
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.appendToSource}
      */
     appendToSource: (...args) => usePlaybackQueueStore.getState().appendToSource(...args),
     /**
      * 移除某个 source
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.removeSource}
      */
     removeSource: (...args) => usePlaybackQueueStore.getState().removeSource(...args),
     /**
      * 播放指定项目
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.play}
      */
     play: (...args) => usePlaybackQueueStore.getState().play(...args),
     /**
      * 播放指定项目（自动查找 source）
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.playById}
      */
     playById: (...args) => usePlaybackQueueStore.getState().playById(...args),
     /**
      * 播放下一个
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.next}
      */
     next: () => usePlaybackQueueStore.getState().next(),
     /**
      * 播放上一个
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.prev}
      */
     prev: () => usePlaybackQueueStore.getState().prev(),
     /**
      * 停止播放
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.stop}
      */
     stop: () => usePlaybackQueueStore.getState().stop(),
     /**
      * 播放完成回调
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.onEnded}
      */
     onEnded: () => usePlaybackQueueStore.getState().onEnded(),
     /**
      * 设置静音状态
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.setMuted}
      */
     setMuted: (...args) => usePlaybackQueueStore.getState().setMuted(...args),
     /**
      * 切换静音状态
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.toggleMute}
      */
     toggleMute: () => usePlaybackQueueStore.getState().toggleMute(),
     /**
      * 设置循环播放
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.setLoop}
      */
     setLoop: (...args) => usePlaybackQueueStore.getState().setLoop(...args),
     /**
      * 重置所有状态
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @see {@link PlaybackQueueActions.reset}
      */
     reset: () => usePlaybackQueueStore.getState().reset(),
     /**
      * 订阅当前播放 ID 变化
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @param callback - 回调函数，参数为 (新值, 旧值)
      * @returns 取消订阅函数
      *
@@ -600,6 +652,8 @@ export const PlaybackQueue = {
     /**
      * 订阅 activeSource 变化
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @param callback - 回调函数，参数为 (新值, 旧值)
      * @returns 取消订阅函数
      */
@@ -607,6 +661,8 @@ export const PlaybackQueue = {
     /**
      * 订阅静音状态变化
      *
+     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
+     *
      * @param callback - 回调函数，参数为 (新值, 旧值)
      * @returns 取消订阅函数
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xxf_react",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "private": false,
   "type": "module",
   "main": "dist/index.js",