xxf_react 0.8.4 → 0.8.5

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

@@ -1 +0,0 @@
-{"version":3,"file":"playback-queue-store.d.ts","sourceRoot":"","sources":["../../src/media/playback-queue-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH;;;;;;;;;;;;;GAaG;AACH,UAAU,UAAU;IAChB;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,UAAU,kBAAkB;IACxB;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAEnC;;;;;;;;;OASG;IACH,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEtC;;;;;;;OAOG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAE3B;;;;;;;OAOG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAExB;;;;;;OAMG;IACH,KAAK,EAAE,OAAO,CAAA;IAEd;;;;;;;;;OASG;IACH,IAAI,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;GAMG;AACH,UAAU,oBAAoB;IAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IAEtE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IAEvD;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAEtC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAE1C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAE9B;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,EAAE,MAAM,IAAI,CAAA;IAEhB;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,EAAE,MAAM,IAAI,CAAA;IAEhB;;;;;;;;;;;;;OAaG;IACH,IAAI,EAAE,MAAM,IAAI,CAAA;IAEhB;;;;;;;;;;;;;OAaG;IACH,OAAO,EAAE,MAAM,IAAI,CAAA;IAEnB;;;;;;;;;;;;;;OAcG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAElC;;;;;;;;;;;;;;OAcG;IACH,UAAU,EAAE,MAAM,IAAI,CAAA;IAEtB;;;;;;;;;;;;;OAaG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAEhC;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,EAAE,MAAM,IAAI,CAAA;CACpB;AAED;;;;;;GAMG;AACH,KAAK,kBAAkB,GAAG,kBAAkB,GAAG,oBAAoB,CAAA;AA8DnE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;EAqPjC,CAAA;AAoCD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,IAAI,oBAAoB,CAEzD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAEpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM;;;EAO9C;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,aAAa;IACtB;;;;;;OAMG;6BACW,kBAAkB;IAEhC;;;;;;OAMG;;IAIH;;;;;;OAMG;;IAIH;;;;;;OAMG;;IAIH;;;;;;OAMG;;IAIH;;;;;;OAMG;;IAIH;;;;;;OAMG;;IAGH;;;;;;OAMG;;IAGH;;;;;;OAMG;;IAGH;;;;;;OAMG;;IAGH;;;;;;OAMG;;IAIH;;;;;;OAMG;;IAGH;;;;;;OAMG;;IAIH;;;;;;OAMG;;IAGH;;;;;;;;;;;;;;;;;OAiBG;4CAEW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;IAGvE;;;;;;;OAOG;+CAEW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;IAGxE;;;;;;;OAOG;wCAEW,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI;CAEpD,CAAA"}

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

@@ -1,670 +0,0 @@
-/**
- * @fileoverview 播放队列状态管理 (Zustand)
- *
- * 支持多 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} 详细文档
- */
-import { create } from 'zustand';
-import { subscribeWithSelector } from 'zustand/middleware';
-import { useShallow } from 'zustand/react/shallow';
-// ============================================================================
-// Initial State - 初始状态
-// ============================================================================
-/**
- * 初始状态
- *
- * @internal
- */
-const initialState = {
-    sources: {},
-    itemIdToSource: {},
-    activeSource: null,
-    currentId: null,
-    muted: true, // 默认静音，符合浏览器自动播放策略
-    loop: true, // 默认循环播放
-};
-// ============================================================================
-// Helper Functions - 辅助函数
-// ============================================================================
-/**
- * 更新单个 source 的反向索引
- *
- * @param currentIndex - 当前的反向索引
- * @param sourceName - source 名称
- * @param oldIds - 旧的 ID 列表
- * @param newIds - 新的 ID 列表
- * @returns 更新后的反向索引
- *
- * @internal
- */
-function updateReverseIndexForSource(currentIndex, sourceName, oldIds, newIds) {
-    const index = { ...currentIndex };
-    // 移除旧的映射
-    for (const id of oldIds) {
-        if (index[id] === sourceName) {
-            delete index[id];
-        }
-    }
-    // 添加新的映射
-    for (const id of newIds) {
-        index[id] = sourceName;
-    }
-    return index;
-}
-// ============================================================================
-// Store - Zustand Store 定义
-// ============================================================================
-/**
- * 播放队列 Zustand Store
- *
- * 使用 `subscribeWithSelector` 中间件支持选择性订阅。
- *
- * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
- *
- * @example
- * ```tsx
- * // 直接使用 store（不推荐，建议使用封装的 hooks）
- * const currentId = usePlaybackQueueStore(state => state.currentId)
- * ```
- */
-export const usePlaybackQueueStore = create()(subscribeWithSelector((set, get) => ({
-    ...initialState,
-    setSource: (source, ids, autoPlay = false) => {
-        if (!source) {
-            if (process.env.NODE_ENV === 'development') {
-                console.warn('[PlaybackQueue] source name is required');
-            }
-            return;
-        }
-        const uniqueIds = [...new Set(ids || [])];
-        set(state => {
-            var _a;
-            const oldIds = ((_a = state.sources[source]) === null || _a === void 0 ? void 0 : _a.itemIds) || [];
-            const newSources = {
-                ...state.sources,
-                [source]: { itemIds: uniqueIds },
-            };
-            const newIndex = updateReverseIndexForSource(state.itemIdToSource, source, oldIds, uniqueIds);
-            // 检查当前播放的项目是否还在列表中
-            let newCurrentId = state.currentId;
-            let newActiveSource = state.activeSource;
-            if (state.activeSource === source && state.currentId) {
-                if (!uniqueIds.includes(state.currentId)) {
-                    // 当前播放的项目不在新列表中
-                    newCurrentId = autoPlay && uniqueIds.length > 0 ? uniqueIds[0] : null;
-                }
-            }
-            // 如果要自动播放且当前没有在播放
-            if (autoPlay && uniqueIds.length > 0 && !state.currentId) {
-                newActiveSource = source;
-                newCurrentId = uniqueIds[0];
-            }
-            return {
-                sources: newSources,
-                itemIdToSource: newIndex,
-                activeSource: newActiveSource,
-                currentId: newCurrentId,
-            };
-        });
-    },
-    appendToSource: (source, ids) => {
-        if (!source || !ids || ids.length === 0)
-            return;
-        set(state => {
-            const sourceData = state.sources[source];
-            const existingIds = (sourceData === null || sourceData === void 0 ? void 0 : sourceData.itemIds) || [];
-            const existingSet = new Set(existingIds);
-            const newIds = ids.filter(id => !existingSet.has(id));
-            if (newIds.length === 0)
-                return state;
-            const allIds = [...existingIds, ...newIds];
-            const newIndex = { ...state.itemIdToSource };
-            for (const id of newIds) {
-                newIndex[id] = source;
-            }
-            return {
-                sources: {
-                    ...state.sources,
-                    [source]: { itemIds: allIds },
-                },
-                itemIdToSource: newIndex,
-            };
-        });
-    },
-    removeSource: (source) => {
-        set(state => {
-            const sourceData = state.sources[source];
-            if (!sourceData)
-                return state;
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            const { [source]: _removed, ...restSources } = state.sources;
-            // 清理反向索引
-            const newIndex = { ...state.itemIdToSource };
-            for (const id of sourceData.itemIds) {
-                if (newIndex[id] === source) {
-                    delete newIndex[id];
-                }
-            }
-            // 如果移除的是当前激活的 source，停止播放
-            if (state.activeSource === source) {
-                return {
-                    sources: restSources,
-                    itemIdToSource: newIndex,
-                    activeSource: null,
-                    currentId: null,
-                };
-            }
-            return {
-                sources: restSources,
-                itemIdToSource: newIndex,
-            };
-        });
-    },
-    play: (source, id) => {
-        const { sources } = get();
-        const sourceData = sources[source];
-        if (!sourceData) {
-            if (process.env.NODE_ENV === 'development') {
-                console.warn(`[PlaybackQueue] Source "${source}" not found`);
-            }
-            return;
-        }
-        if (!sourceData.itemIds.includes(id)) {
-            if (process.env.NODE_ENV === 'development') {
-                console.warn(`[PlaybackQueue] Item "${id}" not found in source "${source}"`);
-            }
-            return;
-        }
-        set({
-            activeSource: source,
-            currentId: id,
-        });
-    },
-    playById: (id) => {
-        var _a;
-        const { sources, activeSource, itemIdToSource } = get();
-        // 优先检查当前 activeSource
-        if (activeSource && ((_a = sources[activeSource]) === null || _a === void 0 ? void 0 : _a.itemIds.includes(id))) {
-            set({ currentId: id });
-            return;
-        }
-        // 使用反向索引快速查找
-        const source = itemIdToSource[id];
-        if (!source) {
-            if (process.env.NODE_ENV === 'development') {
-                console.warn(`[PlaybackQueue] Item "${id}" not found in any source`);
-            }
-            return;
-        }
-        set({
-            activeSource: source,
-            currentId: id,
-        });
-    },
-    next: () => {
-        const { sources, activeSource, currentId, loop } = get();
-        if (!activeSource)
-            return;
-        const sourceData = sources[activeSource];
-        if (!sourceData || sourceData.itemIds.length === 0)
-            return;
-        // 如果没有当前播放项，播放第一个
-        if (!currentId) {
-            set({ currentId: sourceData.itemIds[0] });
-            return;
-        }
-        const currentIndex = sourceData.itemIds.indexOf(currentId);
-        if (currentIndex === -1) {
-            set({ currentId: sourceData.itemIds[0] });
-            return;
-        }
-        const nextIndex = currentIndex + 1;
-        if (nextIndex >= sourceData.itemIds.length) {
-            // 已是最后一个
-            set({ currentId: loop ? sourceData.itemIds[0] : null });
-            return;
-        }
-        set({ currentId: sourceData.itemIds[nextIndex] });
-    },
-    prev: () => {
-        const { sources, activeSource, currentId, loop } = get();
-        if (!activeSource)
-            return;
-        const sourceData = sources[activeSource];
-        if (!sourceData || sourceData.itemIds.length === 0)
-            return;
-        if (!currentId) {
-            set({ currentId: sourceData.itemIds[sourceData.itemIds.length - 1] });
-            return;
-        }
-        const currentIndex = sourceData.itemIds.indexOf(currentId);
-        if (currentIndex === -1) {
-            set({ currentId: sourceData.itemIds[0] });
-            return;
-        }
-        const prevIndex = currentIndex - 1;
-        if (prevIndex < 0) {
-            set({
-                currentId: loop ? sourceData.itemIds[sourceData.itemIds.length - 1] : null
-            });
-            return;
-        }
-        set({ currentId: sourceData.itemIds[prevIndex] });
-    },
-    stop: () => {
-        set({ currentId: null });
-    },
-    onEnded: () => {
-        get().next();
-    },
-    setMuted: (muted) => {
-        set({ muted });
-    },
-    toggleMute: () => {
-        set(state => ({ muted: !state.muted }));
-    },
-    setLoop: (loop) => {
-        set({ loop });
-    },
-    reset: () => {
-        set(initialState);
-    },
-})));
-// ============================================================================
-// Selectors - 选择器（静态引用，避免重复创建）
-// ============================================================================
-/** @internal */
-const selectActions = (state) => ({
-    setSource: state.setSource,
-    appendToSource: state.appendToSource,
-    removeSource: state.removeSource,
-    play: state.play,
-    playById: state.playById,
-    next: state.next,
-    prev: state.prev,
-    stop: state.stop,
-    onEnded: state.onEnded,
-    setMuted: state.setMuted,
-    toggleMute: state.toggleMute,
-    setLoop: state.setLoop,
-    reset: state.reset,
-});
-/** @internal */
-const selectMuted = (state) => state.muted;
-/** @internal */
-const selectCurrentId = (state) => state.currentId;
-/** @internal */
-const selectActiveSource = (state) => state.activeSource;
-/** @internal */
-const selectLoop = (state) => state.loop;
-// ============================================================================
-// Hooks - React Hooks（选择性订阅，性能优化）
-// ============================================================================
-/**
- * 获取播放队列操作方法
- *
- * 使用 shallow 比较，避免不必要的重渲染。
- * 返回的方法引用稳定，可以安全地用作依赖项。
- *
- * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
- *
- * @returns 所有操作方法
- *
- * @example
- * ```tsx
- * const { play, stop, next, prev, toggleMute, onEnded } = usePlaybackActions()
- *
- * // 在视频组件中
- * <video
- *   onEnded={onEnded}
- *   onClick={() => play('home', item.id)}
- * />
- *
- * // 控制按钮
- * <button onClick={prev}>上一个</button>
- * <button onClick={next}>下一个</button>
- * <button onClick={toggleMute}>静音</button>
- * ```
- */
-export function usePlaybackActions() {
-    return usePlaybackQueueStore(useShallow(selectActions));
-}
-/**
- * 判断指定项目是否正在播放
- *
- * 选择性订阅，只有当该项目的播放状态变化时才会重渲染。
- * 这是性能最优的播放状态判断方式。
- *
- * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
- *
- * @param id - 项目 ID
- * @returns 是否正在播放
- *
- * @example
- * ```tsx
- * const VideoCard = ({ item }) => {
- *   const isPlaying = usePlaybackIsPlaying(item.id)
- *
- *   return (
- *     <video autoPlay={isPlaying} muted />
- *   )
- * }
- * ```
- */
-export function usePlaybackIsPlaying(id) {
-    return usePlaybackQueueStore(state => state.currentId === id);
-}
-/**
- * 获取静音状态
- *
- * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
- *
- * @returns 是否静音
- *
- * @example
- * ```tsx
- * const muted = usePlaybackMuted()
- *
- * <video muted={muted} />
- * ```
- */
-export function usePlaybackMuted() {
-    return usePlaybackQueueStore(selectMuted);
-}
-/**
- * 获取当前播放的项目 ID
- *
- * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
- *
- * @returns 当前播放的 ID，没有播放时为 null
- *
- * @example
- * ```tsx
- * const currentId = usePlaybackCurrentId()
- *
- * if (currentId) {
- *   console.log('正在播放:', currentId)
- * }
- * ```
- */
-export function usePlaybackCurrentId() {
-    return usePlaybackQueueStore(selectCurrentId);
-}
-/**
- * 获取当前激活的 source 名称
- *
- * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
- *
- * @returns source 名称，没有激活时为 null
- *
- * @example
- * ```tsx
- * const activeSource = usePlaybackActiveSource()
- *
- * // 高亮当前激活的 Tab
- * <Tab active={activeSource === 'home'}>首页</Tab>
- * ```
- */
-export function usePlaybackActiveSource() {
-    return usePlaybackQueueStore(selectActiveSource);
-}
-/**
- * 获取循环播放状态
- *
- * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
- *
- * @returns 是否循环播放
- *
- * @example
- * ```tsx
- * const loop = usePlaybackLoop()
- * const { setLoop } = usePlaybackActions()
- *
- * <button onClick={() => setLoop(!loop)}>
- *   {loop ? '循环开' : '循环关'}
- * </button>
- * ```
- */
-export function usePlaybackLoop() {
-    return usePlaybackQueueStore(selectLoop);
-}
-/**
- * 获取指定 source 的项目 ID 列表
- *
- * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
- *
- * @param source - source 名称
- * @returns 项目 ID 列表，source 不存在时返回空数组
- *
- * @example
- * ```tsx
- * const homeItems = usePlaybackSourceItems('home')
- *
- * console.log('首页有', homeItems.length, '个视频')
- * ```
- */
-export function usePlaybackSourceItems(source) {
-    return usePlaybackQueueStore(state => { var _a, _b; return (_b = (_a = state.sources[source]) === null || _a === void 0 ? void 0 : _a.itemIds) !== null && _b !== void 0 ? _b : []; });
-}
-/**
- * 获取单个 item 的播放状态和静音状态（常用组合）
- *
- * 使用 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 }
- *
- * @example
- * ```tsx
- * const VideoCard = ({ item }) => {
- *   const { isPlaying, muted } = usePlaybackItemState(item.id)
- *   const { onEnded } = usePlaybackActions()
- *
- *   return (
- *     <video
- *       autoPlay={isPlaying}
- *       muted={muted}
- *       onEnded={onEnded}
- *     />
- *   )
- * }
- * ```
- */
-export function usePlaybackItemState(id) {
-    return usePlaybackQueueStore(useShallow(state => ({
-        isPlaying: state.currentId === id,
-        muted: state.muted,
-    })));
-}
-// ============================================================================
-// Non-Hook API - 非 Hook API（用于组件外部或副作用）
-// ============================================================================
-/**
- * 播放队列命名空间
- *
- * 非 Hook 版本的 API，用于：
- * - 组件外部调用（如事件回调、工具函数）
- * - 不在 React 组件中的场景
- * - 需要命令式调用的场景
- *
- * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
- *
- * @example
- * ```tsx
- * // 在事件回调中使用
- * const handleClick = () => {
- *   PlaybackQueue.play('home', 'item-1')
- * }
- *
- * // 在非组件代码中使用
- * PlaybackQueue.toggleMute()
- *
- * // 获取当前状态快照
- * const state = PlaybackQueue.getState()
- * console.log('当前播放:', state.currentId)
- *
- * // 订阅状态变化
- * const unsubscribe = PlaybackQueue.subscribeCurrentId((currentId, prevId) => {
- *   console.log('播放变化:', prevId, '->', currentId)
- * })
- * // 不再需要时取消订阅
- * unsubscribe()
- * ```
- */
-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 取消订阅函数
-     *
-     * @example
-     * ```ts
-     * const unsubscribe = PlaybackQueue.subscribeCurrentId((currentId, prevId) => {
-     *   console.log('播放变化:', prevId, '->', currentId)
-     * })
-     *
-     * // 清理时取消订阅
-     * unsubscribe()
-     * ```
-     */
-    subscribeCurrentId: (callback) => usePlaybackQueueStore.subscribe(state => state.currentId, callback),
-    /**
-     * 订阅 activeSource 变化
-     *
-     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
-     *
-     * @param callback - 回调函数，参数为 (新值, 旧值)
-     * @returns 取消订阅函数
-     */
-    subscribeActiveSource: (callback) => usePlaybackQueueStore.subscribe(state => state.activeSource, callback),
-    /**
-     * 订阅静音状态变化
-     *
-     * 查看更多,请访问 https://github.com/NBXXF/xxf_react/blob/main/src/media/playback-queue-store.md
-     *
-     * @param callback - 回调函数，参数为 (新值, 旧值)
-     * @returns 取消订阅函数
-     */
-    subscribeMuted: (callback) => usePlaybackQueueStore.subscribe(state => state.muted, callback),
-};

package/dist/media/video-play-safe.d.ts

@@ -1,26 +0,0 @@
-/**
- * Video 安全播放扩展
- * 处理移动端自动播放限制，自动降级为静音播放
- */
-export interface PlaySafeOptions {
-    /** 是否在非静音播放失败时降级为静音重试，默认 true */
-    mutedRetry?: boolean;
-    /** 从有声降级为静音时回调 */
-    onMutedChange?: () => void;
-}
-declare global {
-    interface HTMLVideoElement {
-        playSafe(options?: PlaySafeOptions): Promise<void>;
-    }
-}
-/**
- * 安全播放视频
- * 1. 按当前 video.muted 状态尝试播放
- * 2. 如果非静音播放失败，降级为静音再试
- */
-export declare function playSafe(video: HTMLVideoElement, options?: PlaySafeOptions): Promise<void>;
-/**
- * 扩展 HTMLVideoElement 原型
- */
-export declare function extendVideoElement(): void;
-//# sourceMappingURL=video-play-safe.d.ts.map

package/dist/media/video-play-safe.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"video-play-safe.d.ts","sourceRoot":"","sources":["../../src/media/video-play-safe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC5B,iCAAiC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kBAAkB;IAClB,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9B;AAGD,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,gBAAgB;QACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACtD;CACJ;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC1B,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,eAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAYzC"}