@xiping/react-components 1.0.55 → 1.0.58

package/dist/es/components/video-subtitle-player/VideoSubtitlePlayer.js

@@ -1,128 +1,75 @@
-import { jsx as e, jsxs as t } from "react/jsx-runtime";
-import { useRef as N, useEffect as u, useCallback as H } from "react";
-import I from "xgplayer";
-/* empty css                                                                                               */
-import { PanelGroup as z, Panel as o, PanelResizeHandle as S } from "react-resizable-panels";
-import { SubtitlePlayer as j } from "../subtitle-player/SubtitlePlayer.js";
-import { useVideoSubtitleStore as D } from "./useVideoSubtitleStore.js";
-/* empty css                        */
-const q = ({
-  videoUrl: m,
-  subtitles: p,
-  poster: v,
-  className: P = "",
-  style: w,
-  onFetchDetail: c
+import { jsx as u } from "react/jsx-runtime";
+import { useRef as v, useEffect as w, useCallback as d } from "react";
+import { isMobile as V, isTablet as g } from "react-device-detect";
+import { useVideoSubtitleStore as k } from "./useVideoSubtitleStore.js";
+import { useXGPlayer as H } from "./useXGPlayer.js";
+import { VideoSubtitlePlayerPC as M } from "./VideoSubtitlePlayerPC.js";
+import { VideoSubtitlePlayerMobile as T } from "./VideoSubtitlePlayerMobile.js";
+import './VideoSubtitlePlayer.css';/* empty css                        */
+const X = ({
+  videoUrl: p,
+  subtitles: r,
+  poster: b,
+  className: l = "",
+  style: n,
+  onFetchDetail: e,
+  forceLayout: m
 }) => {
-  const n = N(null), d = N(null), {
-    currentTime: r,
-    isPlaying: E,
-    setCurrentTime: _,
-    setIsPlaying: s,
-    setSubtitles: h,
-    currentDetail: l,
-    isLoadingDetail: T,
-    fetchDetail: y
-  } = D();
-  u(() => {
-    h(p);
-  }, [p, h]), u(() => {
-    if (!n.current) return;
-    const a = `xiping-video-subtitle-player-${Date.now()}`;
-    n.current && (n.current.id = a);
-    const i = new I({
-      id: a,
-      url: m,
-      poster: v,
-      autoplay: !1,
-      fluid: !1,
-      width: "100%",
-      height: "100%",
-      controls: !0
-    });
-    d.current = i;
-    const f = () => {
-      const R = i.currentTime || 0;
-      _(R);
-    }, x = () => {
-      s(!0);
-    }, g = () => {
-      s(!1);
-    }, b = () => {
-      s(!1);
-    };
-    return i.on("timeupdate", f), i.on("play", x), i.on("pause", g), i.on("ended", b), () => {
-      i.off("timeupdate", f), i.off("play", x), i.off("pause", g), i.off("ended", b), i.destroy(), d.current = null;
-    };
-  }, [m, v, _, s]), u(() => {
-    if (d.current) {
-      const a = d.current;
-      Math.abs(a.currentTime - r) > 0.5 && (a.currentTime = r);
-    }
-  }, [r]);
-  const C = H(
-    async (a) => {
-      c ? await c(a) : await y(a);
+  const t = v(null), c = m !== void 0 ? m === "mobile" : V || g, {
+    currentTime: a,
+    setCurrentTime: C,
+    setIsPlaying: y,
+    setSubtitles: s,
+    currentDetail: P,
+    isLoadingDetail: S,
+    fetchDetail: i
+  } = k();
+  w(() => {
+    s(r);
+  }, [r, s]), H(
+    t,
+    p,
+    b,
+    { setCurrentTime: C, setIsPlaying: y },
+    a
+  );
+  const f = d(
+    async (o) => {
+      e ? await e(o) : await i(o);
+    },
+    [e, i]
+  ), W = d(
+    async (o) => {
+      e ? await e(o) : await i(o);
     },
-    [c, y]
+    [e, i]
+  );
+  return c ? /* @__PURE__ */ u(
+    T,
+    {
+      playerRef: t,
+      subtitles: r,
+      currentTime: a,
+      onWordHoverChange: f,
+      onWordClick: W,
+      className: l,
+      style: n
+    }
+  ) : /* @__PURE__ */ u(
+    M,
+    {
+      playerRef: t,
+      subtitles: r,
+      currentTime: a,
+      currentDetail: P,
+      isLoadingDetail: S,
+      onWordHoverChange: f,
+      className: l,
+      style: n
+    }
   );
-  return /* @__PURE__ */ e("div", { className: `xiping-video-subtitle-player ${P}`, style: w, children: /* @__PURE__ */ t(z, { direction: "horizontal", children: [
-    /* @__PURE__ */ e(o, { defaultSize: 65, minSize: 40, children: /* @__PURE__ */ t(z, { direction: "vertical", children: [
-      /* @__PURE__ */ e(o, { defaultSize: 60, minSize: 30, children: /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__video-wrapper", children: /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__video-container", children: /* @__PURE__ */ e(
-        "div",
-        {
-          ref: n,
-          className: "xiping-video-subtitle-player__video"
-        }
-      ) }) }) }),
-      /* @__PURE__ */ e(S, { className: "xiping-video-subtitle-player__resize-handle xiping-video-subtitle-player__resize-handle--vertical" }),
-      /* @__PURE__ */ e(o, { defaultSize: 40, minSize: 20, children: /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__subtitle-container", children: /* @__PURE__ */ e(
-        j,
-        {
-          subtitles: p,
-          currentTime: r,
-          mode: "current",
-          onWordHoverChange: C
-        }
-      ) }) })
-    ] }) }),
-    /* @__PURE__ */ e(S, { className: "xiping-video-subtitle-player__resize-handle xiping-video-subtitle-player__resize-handle--horizontal" }),
-    /* @__PURE__ */ e(o, { defaultSize: 35, minSize: 25, maxSize: 50, children: /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__right", children: /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__detail", children: T ? /* @__PURE__ */ t("div", { className: "xiping-video-subtitle-player__detail-loading", children: [
-      /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__detail-loading-spinner" }),
-      /* @__PURE__ */ e("span", { children: "加载中..." })
-    ] }) : l ? /* @__PURE__ */ t("div", { className: "xiping-video-subtitle-player__detail-content", children: [
-      /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__detail-word", children: l.word }),
-      l.pronunciation && /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__detail-pronunciation", children: l.pronunciation }),
-      l.partOfSpeech && /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__detail-pos", children: l.partOfSpeech }),
-      l.translation && /* @__PURE__ */ t("div", { className: "xiping-video-subtitle-player__detail-translation", children: [
-        /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__detail-label", children: "中文翻译" }),
-        /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__detail-text", children: l.translation })
-      ] }),
-      l.definition && /* @__PURE__ */ t("div", { className: "xiping-video-subtitle-player__detail-definition", children: [
-        /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__detail-label", children: "英文解释" }),
-        /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__detail-text", children: l.definition })
-      ] }),
-      l.examples && l.examples.length > 0 && /* @__PURE__ */ t("div", { className: "xiping-video-subtitle-player__detail-examples", children: [
-        /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__detail-label", children: "例句" }),
-        l.examples.map((a, i) => /* @__PURE__ */ t(
-          "div",
-          {
-            className: "xiping-video-subtitle-player__detail-example",
-            children: [
-              /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__detail-example-en", children: a.sentence }),
-              /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__detail-example-zh", children: a.translation })
-            ]
-          },
-          i
-        ))
-      ] })
-    ] }) : /* @__PURE__ */ t("div", { className: "xiping-video-subtitle-player__detail-empty", children: [
-      /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__detail-empty-icon", children: "📖" }),
-      /* @__PURE__ */ e("div", { className: "xiping-video-subtitle-player__detail-empty-text", children: "将鼠标悬停在字幕单词上查看详情" })
-    ] }) }) }) })
-  ] }) });
 };
 export {
-  q as VideoSubtitlePlayer,
-  q as default
+  X as VideoSubtitlePlayer,
+  X as default
 };

package/dist/es/components/video-subtitle-player/VideoSubtitlePlayer.mobile.css

@@ -0,0 +1 @@
+.xiping-video-subtitle-player--mobile{display:flex;flex-direction:column;min-height:0;height:100%}.xiping-video-subtitle-player__mobile-video{flex:0 0 auto;width:100%;aspect-ratio:16 / 9;background:#000}.xiping-video-subtitle-player__mobile-video-wrapper{width:100%;height:100%;background:#000;overflow:hidden}.xiping-video-subtitle-player__mobile-video-container{position:relative;width:100%;height:100%;background-color:#a62c2c;overflow:hidden}.xiping-video-subtitle-player__mobile-video-container .xgplayer{width:100%!important;height:100%!important}.xiping-video-subtitle-player__mobile-video-container .xgplayer video{-o-object-fit:fill!important;object-fit:fill!important}.xiping-video-subtitle-player__mobile-subtitle{flex:1;min-height:0;padding:12px 16px;overflow-y:auto;background:#0000004d;-webkit-overflow-scrolling:touch}

package/dist/es/components/video-subtitle-player/VideoSubtitlePlayer.pc.css

@@ -0,0 +1 @@
+.xiping-video-subtitle-player--pc .xiping-video-subtitle-player__panel-group,.xiping-video-subtitle-player--pc .xiping-video-subtitle-player__panel-group-inner{width:100%;height:100%}.xiping-video-subtitle-player--pc .xiping-video-subtitle-player__right{border-left:1px solid rgba(255,255,255,.1)}.xiping-video-subtitle-player__resize-handle--horizontal{position:relative;width:2px;background:#ffffff1a;cursor:col-resize;transition:background .2s ease;flex-shrink:0}.xiping-video-subtitle-player__resize-handle--horizontal:hover{background:#fbbf2480}.xiping-video-subtitle-player__resize-handle--horizontal:active{background:#fbbf24cc}.xiping-video-subtitle-player__resize-handle--horizontal:before{content:"";position:absolute;inset:0 -4px;cursor:col-resize}.xiping-video-subtitle-player__resize-handle--vertical{position:relative;height:2px;background:#ffffff1a;cursor:row-resize;transition:background .2s ease;flex-shrink:0}.xiping-video-subtitle-player__resize-handle--vertical:hover{background:#fbbf2480}.xiping-video-subtitle-player__resize-handle--vertical:active{background:#fbbf24cc}.xiping-video-subtitle-player__resize-handle--vertical:before{content:"";position:absolute;inset:-4px 0;cursor:row-resize}

package/dist/es/components/video-subtitle-player/VideoSubtitlePlayerMobile.d.ts

@@ -0,0 +1,20 @@
+import { default as React, RefObject } from 'react';
+import { SubtitleData, HoverTarget, WordClickTarget } from '../subtitle-player/SubtitlePlayer';
+export interface VideoSubtitlePlayerMobileProps {
+    /** 播放器挂载的容器 ref */
+    playerRef: RefObject<HTMLDivElement | null>;
+    /** 字幕数据 */
+    subtitles: SubtitleData[];
+    /** 当前播放时间（秒） */
+    currentTime: number;
+    /** 单词 hover 变化时拉取/展示详情（可为弹窗等） */
+    onWordHoverChange: (target: HoverTarget | null) => void | Promise<void>;
+    /** 单词点击时拉取/展示详情（移动端主要交互） */
+    onWordClick: (target: WordClickTarget) => void | Promise<void>;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * 移动端视图：上下两栏（视频 + 字幕），无右侧详情区，详情后续以弹窗等形式实现
+ */
+export declare const VideoSubtitlePlayerMobile: React.FC<VideoSubtitlePlayerMobileProps>;

package/dist/es/components/video-subtitle-player/VideoSubtitlePlayerMobile.js

@@ -0,0 +1,47 @@
+import { jsx as e } from "react/jsx-runtime";
+import { useCallback as l } from "react";
+import u from "clsx";
+import { SubtitlePlayer as y } from "../subtitle-player/SubtitlePlayer.js";
+import { VideoSubtitlePlayerLayoutMobile as f } from "./layouts/VideoSubtitlePlayerLayoutMobile.js";
+const P = ({
+  playerRef: r,
+  subtitles: a,
+  currentTime: s,
+  onWordHoverChange: t,
+  onWordClick: i,
+  className: c = "",
+  style: m
+}) => {
+  const n = l(
+    async (o) => {
+      await t(o);
+    },
+    [t]
+  ), d = l(
+    async (o) => {
+      await i(o);
+    },
+    [i]
+  ), b = /* @__PURE__ */ e("div", { ref: r, className: "xiping-video-subtitle-player__video" }), p = /* @__PURE__ */ e(
+    y,
+    {
+      subtitles: a,
+      currentTime: s,
+      mode: "lyrics",
+      onWordHoverChange: n,
+      onWordClick: d
+    }
+  );
+  return /* @__PURE__ */ e(
+    f,
+    {
+      className: u(c),
+      style: m,
+      videoSlot: b,
+      subtitleSlot: p
+    }
+  );
+};
+export {
+  P as VideoSubtitlePlayerMobile
+};

package/dist/es/components/video-subtitle-player/VideoSubtitlePlayerPC.d.ts

@@ -0,0 +1,23 @@
+import { default as React, RefObject } from 'react';
+import { SubtitleData, HoverTarget } from '../subtitle-player/SubtitlePlayer';
+import { SubtitleDetail } from './useVideoSubtitleStore';
+export interface VideoSubtitlePlayerPCProps {
+    /** 播放器挂载的容器 ref */
+    playerRef: RefObject<HTMLDivElement | null>;
+    /** 字幕数据 */
+    subtitles: SubtitleData[];
+    /** 当前播放时间（秒） */
+    currentTime: number;
+    /** 当前悬停单词的详情 */
+    currentDetail: SubtitleDetail | null;
+    /** 是否正在加载详情 */
+    isLoadingDetail: boolean;
+    /** 单词 hover 变化时拉取/展示详情 */
+    onWordHoverChange: (target: HoverTarget | null) => void | Promise<void>;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * PC 端视图：可拖拽分栏 + 右侧详情区，所有 PC 专属 UI 集中在此
+ */
+export declare const VideoSubtitlePlayerPC: React.FC<VideoSubtitlePlayerPCProps>;

package/dist/es/components/video-subtitle-player/VideoSubtitlePlayerPC.js

@@ -0,0 +1,75 @@
+import { jsx as i, jsxs as l } from "react/jsx-runtime";
+import { useCallback as y } from "react";
+import b from "clsx";
+import { SubtitlePlayer as h } from "../subtitle-player/SubtitlePlayer.js";
+import { VideoSubtitlePlayerLayoutPC as g } from "./layouts/VideoSubtitlePlayerLayoutPC.js";
+const C = ({
+  playerRef: t,
+  subtitles: s,
+  currentTime: n,
+  currentDetail: e,
+  isLoadingDetail: p,
+  onWordHoverChange: d,
+  className: o = "",
+  style: r
+}) => {
+  const c = y(
+    async (a) => {
+      await d(a);
+    },
+    [d]
+  ), v = /* @__PURE__ */ i("div", { ref: t, className: "xiping-video-subtitle-player__video" }), m = /* @__PURE__ */ i(
+    h,
+    {
+      subtitles: s,
+      currentTime: n,
+      mode: "lyrics",
+      onWordHoverChange: c
+    }
+  ), _ = /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__detail", children: p ? /* @__PURE__ */ l("div", { className: "xiping-video-subtitle-player__detail-loading", children: [
+    /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__detail-loading-spinner" }),
+    /* @__PURE__ */ i("span", { children: "加载中..." })
+  ] }) : e ? /* @__PURE__ */ l("div", { className: "xiping-video-subtitle-player__detail-content", children: [
+    /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__detail-word", children: e.word }),
+    e.pronunciation && /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__detail-pronunciation", children: e.pronunciation }),
+    e.partOfSpeech && /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__detail-pos", children: e.partOfSpeech }),
+    e.translation && /* @__PURE__ */ l("div", { className: "xiping-video-subtitle-player__detail-translation", children: [
+      /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__detail-label", children: "中文翻译" }),
+      /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__detail-text", children: e.translation })
+    ] }),
+    e.definition && /* @__PURE__ */ l("div", { className: "xiping-video-subtitle-player__detail-definition", children: [
+      /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__detail-label", children: "英文解释" }),
+      /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__detail-text", children: e.definition })
+    ] }),
+    e.examples && e.examples.length > 0 && /* @__PURE__ */ l("div", { className: "xiping-video-subtitle-player__detail-examples", children: [
+      /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__detail-label", children: "例句" }),
+      e.examples.map((a, x) => /* @__PURE__ */ l(
+        "div",
+        {
+          className: "xiping-video-subtitle-player__detail-example",
+          children: [
+            /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__detail-example-en", children: a.sentence }),
+            /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__detail-example-zh", children: a.translation })
+          ]
+        },
+        x
+      ))
+    ] })
+  ] }) : /* @__PURE__ */ l("div", { className: "xiping-video-subtitle-player__detail-empty", children: [
+    /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__detail-empty-icon", children: "📖" }),
+    /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__detail-empty-text", children: "将鼠标悬停在字幕单词上查看详情" })
+  ] }) });
+  return /* @__PURE__ */ i(
+    g,
+    {
+      className: b(o),
+      style: r,
+      videoSlot: v,
+      subtitleSlot: m,
+      detailSlot: _
+    }
+  );
+};
+export {
+  C as VideoSubtitlePlayerPC
+};

package/dist/es/components/video-subtitle-player/layouts/VideoSubtitlePlayerLayoutMobile.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+import { VideoSubtitlePlayerLayoutMobileProps } from './types';
+/**
+ * 移动端布局：上下两栏，无拖拽
+ * - 上：视频区域（100vw 宽，16:9 占位）
+ * - 下：仅字幕区域（单词详情后续以弹窗等形式实现，此处不展示）
+ */
+export declare const VideoSubtitlePlayerLayoutMobile: React.FC<VideoSubtitlePlayerLayoutMobileProps>;

package/dist/es/components/video-subtitle-player/layouts/VideoSubtitlePlayerLayoutMobile.js

@@ -0,0 +1,21 @@
+import { jsxs as r, jsx as i } from "react/jsx-runtime";
+import s from "clsx";
+import '../VideoSubtitlePlayer.mobile.css';/* empty css                                */
+const m = ({ className: e = "", style: l, videoSlot: o, subtitleSlot: t }) => /* @__PURE__ */ r(
+  "div",
+  {
+    className: s(
+      "xiping-video-subtitle-player",
+      "xiping-video-subtitle-player--mobile",
+      e
+    ),
+    style: l,
+    children: [
+      /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__mobile-video", children: /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__mobile-video-wrapper", children: /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__mobile-video-container", children: o }) }) }),
+      /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__mobile-subtitle", children: t })
+    ]
+  }
+);
+export {
+  m as VideoSubtitlePlayerLayoutMobile
+};

package/dist/es/components/video-subtitle-player/layouts/VideoSubtitlePlayerLayoutPC.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+import { VideoSubtitlePlayerLayoutPCProps } from './types';
+/**
+ * PC 端布局：左右分栏 + 左侧上下分栏，支持拖拽调整
+ */
+export declare const VideoSubtitlePlayerLayoutPC: React.FC<VideoSubtitlePlayerLayoutPCProps>;

package/dist/es/components/video-subtitle-player/layouts/VideoSubtitlePlayerLayoutPC.js

@@ -0,0 +1,50 @@
+import { jsx as i, jsxs as a } from "react/jsx-runtime";
+import { Group as r, Panel as e, Separator as t } from "react-resizable-panels";
+import l from "clsx";
+import '../VideoSubtitlePlayer.pc.css';/* empty css                            */
+const _ = ({ className: n = "", style: s, videoSlot: d, subtitleSlot: o, detailSlot: p }) => /* @__PURE__ */ i(
+  "div",
+  {
+    className: l(
+      "xiping-video-subtitle-player",
+      "xiping-video-subtitle-player--pc",
+      n
+    ),
+    style: s,
+    children: /* @__PURE__ */ a(
+      r,
+      {
+        orientation: "horizontal",
+        className: "xiping-video-subtitle-player__panel-group",
+        children: [
+          /* @__PURE__ */ i(e, { defaultSize: "65", minSize: "40", children: /* @__PURE__ */ a(r, { orientation: "vertical", className: "xiping-video-subtitle-player__panel-group-inner", children: [
+            /* @__PURE__ */ i(e, { defaultSize: "60", minSize: "30", children: /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__video-wrapper", children: /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__video-container", children: d }) }) }),
+            /* @__PURE__ */ i(
+              t,
+              {
+                className: l(
+                  "xiping-video-subtitle-player__resize-handle",
+                  "xiping-video-subtitle-player__resize-handle--vertical"
+                )
+              }
+            ),
+            /* @__PURE__ */ i(e, { defaultSize: "40", minSize: "20", children: /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__subtitle-container", children: o }) })
+          ] }) }),
+          /* @__PURE__ */ i(
+            t,
+            {
+              className: l(
+                "xiping-video-subtitle-player__resize-handle",
+                "xiping-video-subtitle-player__resize-handle--horizontal"
+              )
+            }
+          ),
+          /* @__PURE__ */ i(e, { defaultSize: "35", minSize: "25", maxSize: "50", children: /* @__PURE__ */ i("div", { className: "xiping-video-subtitle-player__right", children: p }) })
+        ]
+      }
+    )
+  }
+);
+export {
+  _ as VideoSubtitlePlayerLayoutPC
+};

package/dist/es/components/video-subtitle-player/layouts/index.d.ts

@@ -0,0 +1,3 @@
+export { VideoSubtitlePlayerLayoutPC } from './VideoSubtitlePlayerLayoutPC';
+export { VideoSubtitlePlayerLayoutMobile } from './VideoSubtitlePlayerLayoutMobile';
+export type { VideoSubtitlePlayerLayoutMobileProps, VideoSubtitlePlayerLayoutPCProps, } from './types';

package/dist/es/components/video-subtitle-player/layouts/types.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+/** 移动端布局 props：仅视频 + 字幕，无详情区（详情后续弹窗等单独实现） */
+export interface VideoSubtitlePlayerLayoutMobileProps {
+    className?: string;
+    style?: React.CSSProperties;
+    videoSlot: ReactNode;
+    subtitleSlot: ReactNode;
+}
+/** PC 端布局 props：视频 + 字幕 + 右侧详情区 */
+export interface VideoSubtitlePlayerLayoutPCProps {
+    className?: string;
+    style?: React.CSSProperties;
+    videoSlot: ReactNode;
+    subtitleSlot: ReactNode;
+    /** 右侧详情区域 */
+    detailSlot: ReactNode;
+}

package/dist/es/components/video-subtitle-player/useXGPlayer.d.ts

@@ -0,0 +1,10 @@
+import { RefObject } from 'react';
+export interface UseXGPlayerCallbacks {
+    setCurrentTime: (time: number) => void;
+    setIsPlaying: (playing: boolean) => void;
+}
+/**
+ * 封装 xgplayer 的创建、事件绑定与销毁，以及外部 currentTime 同步
+ * 调用方需渲染一个 div 并传入其 ref，播放器会挂载到该节点
+ */
+export declare function useXGPlayer(containerRef: RefObject<HTMLDivElement | null>, videoUrl: string, poster: string | undefined, callbacks: UseXGPlayerCallbacks, currentTime: number): void;

package/dist/es/components/video-subtitle-player/useXGPlayer.js

@@ -0,0 +1,36 @@
+import { useRef as h, useEffect as p } from "react";
+import P from "xgplayer";
+import '../../node_modules/.pnpm/xgplayer@3.0.23_core-js@3.47.0/node_modules/xgplayer/dist/index.min.css';/* empty css                                                                                               */
+function T(o, s, u, y, r) {
+  const a = h(null), { setCurrentTime: l, setIsPlaying: n } = y;
+  p(() => {
+    if (!o.current) return;
+    const t = `xiping-video-subtitle-player-${Date.now()}`;
+    o.current.id = t;
+    const e = new P({
+      id: t,
+      url: s,
+      poster: u,
+      autoplay: !1,
+      fluid: !1,
+      width: "100%",
+      height: "100%",
+      controls: !0
+    });
+    a.current = e;
+    const f = () => {
+      const m = e.currentTime ?? 0;
+      l(m);
+    }, i = () => n(!0), c = () => n(!1), d = () => n(!1);
+    return e.on("timeupdate", f), e.on("play", i), e.on("pause", c), e.on("ended", d), () => {
+      e.off("timeupdate", f), e.off("play", i), e.off("pause", c), e.off("ended", d), e.destroy(), a.current = null;
+    };
+  }, [s, u, l, n]), p(() => {
+    const t = a.current;
+    if (!t) return;
+    Math.abs(t.currentTime - r) > 0.5 && (t.currentTime = r);
+  }, [r]);
+}
+export {
+  T as useXGPlayer
+};

package/dist/es/index.d.ts

@@ -18,13 +18,14 @@ export * from './components/blur-fade';
 export * from './components/video-dialog';
 export * from './components/comic-text';
 export * from './components/flip-text';
-export * from './components/animated-list';
 export * from './components/shiny-button';
+export * from './components/shiny-text';
 export * from './components/scratch-to-reveal';
 export * from './components/split-text';
 export * from './components/dome-gallery';
 export * from './components/text-type';
 export * from './components/gradient-text';
+export * from './components/blur-text';
 export * from './components/variable-proximity';
 export * from './components/subtitle-player';
 export * from './components/video-subtitle-player';