sa2kit 1.0.8 → 1.1.0

package/dist/mmd/index.d.mts

@@ -264,7 +264,7 @@ declare const MMDPlayerBase: React__default.FC<MMDPlayerBaseProps>;
  * 支持通过 resources 和 stage 配置快速使用
  * 所有资源均从 public 目录加载，无需额外配置
  */
-declare const MMDPlayerEnhanced: React__default.FC<MMDPlayerEnhancedProps>;
+declare const MMDPlayerEnhanced: React__default.ForwardRefExoticComponent<MMDPlayerEnhancedProps & React__default.RefAttributes<any>>;
 
 /**
  * MMD 播放列表组件（预加载版本）

package/dist/mmd/index.d.ts

@@ -264,7 +264,7 @@ declare const MMDPlayerBase: React__default.FC<MMDPlayerBaseProps>;
  * 支持通过 resources 和 stage 配置快速使用
  * 所有资源均从 public 目录加载，无需额外配置
  */
-declare const MMDPlayerEnhanced: React__default.FC<MMDPlayerEnhancedProps>;
+declare const MMDPlayerEnhanced: React__default.ForwardRefExoticComponent<MMDPlayerEnhancedProps & React__default.RefAttributes<any>>;
 
 /**
  * MMD 播放列表组件（预加载版本）

package/dist/mmd/index.js

@@ -298,7 +298,7 @@ var MMDPlayerBase = ({
     } }, error)
   );
 };
-var MMDPlayerEnhanced = ({
+var MMDPlayerEnhanced = React2.forwardRef(({
   resources,
   resourcesList,
   defaultResourceId,
@@ -315,7 +315,7 @@ var MMDPlayerEnhanced = ({
   onSelectionChange,
   onAudioEnded,
   onAnimationEnded
-}) => {
+}, ref) => {
   console.log("\u{1F3A8} [MMDPlayerEnhanced] \u7EC4\u4EF6\u521D\u59CB\u5316");
   const [selectedResourceId, setSelectedResourceId] = React2.useState(
     defaultResourceId || resourcesList?.[0]?.id || ""
@@ -408,6 +408,55 @@ var MMDPlayerEnhanced = ({
   const [isInitialized, setIsInitialized] = React2.useState(false);
   const [reloadTrigger, setReloadTrigger] = React2.useState(0);
   const [needReset, setNeedReset] = React2.useState(false);
+  React2.useImperativeHandle(ref, () => ({
+    clearResources: () => {
+      console.log("\u{1F9F9} [MMDPlayerEnhanced] \u5916\u90E8\u89E6\u53D1\u8D44\u6E90\u6E05\u7406");
+      clearOldResources();
+    },
+    getIsPlaying: () => isPlayingRef.current,
+    getIsLoaded: () => isLoadedRef.current,
+    stopCompletely: () => {
+      console.log("\u23F9\uFE0F [MMDPlayerEnhanced] \u5B8C\u5168\u505C\u6B62");
+      stopCompletely();
+    }
+  }));
+  const stopCompletely = () => {
+    isPlayingRef.current = false;
+    setIsPlaying(false);
+    if (audioRef.current) {
+      audioRef.current.pause();
+      audioRef.current.currentTime = 0;
+    }
+    if (helperRef.current) {
+      helperRef.current.enable("physics", false);
+    }
+    animationEndedFiredRef.current = false;
+    lastAnimationTimeRef.current = 0;
+    animationStoppedCountRef.current = 0;
+    console.log("\u2705 [MMDPlayerEnhanced] \u5B8C\u5168\u505C\u6B62\u5B8C\u6210");
+  };
+  React2.useEffect(() => {
+    const container = containerRef.current;
+    if (!container) return;
+    const handleCleanupResources = () => {
+      console.log("\u{1F9F9} [MMDPlayerEnhanced] \u6536\u5230\u6E05\u7406\u8D44\u6E90\u4E8B\u4EF6");
+      if (!isPlayingRef.current) {
+        clearOldResources();
+      } else {
+        console.warn("\u26A0\uFE0F [MMDPlayerEnhanced] \u64AD\u653E\u4E2D\uFF0C\u8DF3\u8FC7\u8D44\u6E90\u6E05\u7406");
+      }
+    };
+    const handleStopCompletely = () => {
+      console.log("\u23F9\uFE0F [MMDPlayerEnhanced] \u6536\u5230\u5B8C\u5168\u505C\u6B62\u4E8B\u4EF6");
+      stopCompletely();
+    };
+    container.addEventListener("cleanupResources", handleCleanupResources);
+    container.addEventListener("stopCompletely", handleStopCompletely);
+    return () => {
+      container.removeEventListener("cleanupResources", handleCleanupResources);
+      container.removeEventListener("stopCompletely", handleStopCompletely);
+    };
+  }, []);
   React2.useEffect(() => {
     console.log("\u{1F3D7}\uFE0F [MMDPlayerEnhanced] \u573A\u666F\u521D\u59CB\u5316 useEffect \u89E6\u53D1");
     if (!containerRef.current) {
@@ -1225,7 +1274,8 @@ var MMDPlayerEnhanced = ({
     },
     background.name
   )))))));
-};
+});
+MMDPlayerEnhanced.displayName = "MMDPlayerEnhanced";
 var MMDPlaylist = ({
   playlist,
   stage,
@@ -1248,6 +1298,8 @@ var MMDPlaylist = ({
   const currentNodeIndexRef = React2.useRef(defaultNodeIndex);
   const isAutoSwitchRef = React2.useRef(false);
   const playerRefsMap = React2.useRef(/* @__PURE__ */ new Map());
+  const playerComponentRefs = React2.useRef(/* @__PURE__ */ new Map());
+  const [memoryUsage, setMemoryUsage] = React2.useState(0);
   React2.useEffect(() => {
     currentNodeIndexRef.current = currentNodeIndex;
   }, [currentNodeIndex]);
@@ -1258,24 +1310,62 @@ var MMDPlaylist = ({
   }
   console.log("\u{1F3AF} [MMDPlaylist] \u5F53\u524D\u8282\u70B9:", currentNode.name, "\u7D22\u5F15:", currentNodeIndex);
   const stopNode = (nodeIndex) => {
-    const playerElement = playerRefsMap.current.get(nodeIndex);
-    if (!playerElement) return;
-    console.log(`\u23F9\uFE0F [MMDPlaylist] \u505C\u6B62\u8282\u70B9 ${nodeIndex}`);
-    const audioElement = playerElement.querySelector("audio");
-    if (audioElement) {
-      audioElement.pause();
-      audioElement.currentTime = 0;
-      console.log(`  \u{1F507} \u505C\u6B62\u97F3\u9891`);
+    const playerComponent = playerComponentRefs.current.get(nodeIndex);
+    if (playerComponent && playerComponent.stopCompletely) {
+      console.log(`\u23F9\uFE0F [MMDPlaylist] \u505C\u6B62\u8282\u70B9 ${nodeIndex}`);
+      playerComponent.stopCompletely();
+    } else {
+      const playerElement = playerRefsMap.current.get(nodeIndex);
+      if (!playerElement) return;
+      console.log(`\u23F9\uFE0F [MMDPlaylist] \u505C\u6B62\u8282\u70B9 ${nodeIndex} (DOM\u65B9\u5F0F)`);
+      const audioElement = playerElement.querySelector("audio");
+      if (audioElement) {
+        audioElement.pause();
+        audioElement.currentTime = 0;
+        console.log(`  \u{1F507} \u505C\u6B62\u97F3\u9891`);
+      }
+      const stopEvent = new CustomEvent("stopCompletely");
+      playerElement.dispatchEvent(stopEvent);
+      console.log(`  \u{1F4E1} \u53D1\u9001\u505C\u6B62\u4E8B\u4EF6`);
+    }
+  };
+  const clearNodeResources = (nodeIndex, excludeCurrent = true) => {
+    if (excludeCurrent && nodeIndex === currentNodeIndex) {
+      console.log(`\u26A0\uFE0F [MMDPlaylist] \u8DF3\u8FC7\u6E05\u7406\u5F53\u524D\u64AD\u653E\u8282\u70B9 ${nodeIndex}`);
+      return;
     }
-    const stopButton = playerElement.querySelector('button[title="\u505C\u6B62"]');
-    if (stopButton) {
-      stopButton.click();
-      console.log(`  \u23F9\uFE0F \u70B9\u51FB\u505C\u6B62\u6309\u94AE`);
+    const playerComponent = playerComponentRefs.current.get(nodeIndex);
+    if (playerComponent && playerComponent.clearResources) {
+      console.log(`\u{1F9F9} [MMDPlaylist] \u6E05\u7406\u8282\u70B9 ${nodeIndex} \u8D44\u6E90`);
+      playerComponent.clearResources();
     } else {
-      const pauseButton = playerElement.querySelector('button[title="\u6682\u505C"]');
-      if (pauseButton) {
-        pauseButton.click();
-        console.log(`  \u23F8\uFE0F \u70B9\u51FB\u6682\u505C\u6309\u94AE`);
+      const playerElement = playerRefsMap.current.get(nodeIndex);
+      if (playerElement) {
+        const cleanupEvent = new CustomEvent("cleanupResources");
+        playerElement.dispatchEvent(cleanupEvent);
+      }
+    }
+  };
+  const emergencyMemoryCleanup = () => {
+    if (window.performance?.memory) {
+      const memInfo = window.performance.memory;
+      const usage = memInfo.usedJSHeapSize / memInfo.totalJSHeapSize;
+      if (usage > 0.9) {
+        console.error(`\u{1F6A8} [MMDPlaylist] \u5185\u5B58\u4F7F\u7528\u4E25\u91CD\u8FC7\u9AD8 (${(usage * 100).toFixed(1)}%)\uFF0C\u7D27\u6025\u6E05\u7406`);
+        const nodesToClean = editableNodes.map((_, index) => ({
+          index,
+          distance: Math.abs(index - currentNodeIndex)
+        })).filter((node) => node.distance > 2).sort((a, b) => b.distance - a.distance).slice(0, 2);
+        nodesToClean.forEach(({ index }) => {
+          console.warn(`\u{1F9F9} [MMDPlaylist] \u7D27\u6025\u6E05\u7406\u8282\u70B9 ${index}`);
+          clearNodeResources(index, false);
+        });
+        if (window.gc) {
+          try {
+            window.gc();
+          } catch (e) {
+          }
+        }
       }
     }
   };
@@ -1286,6 +1376,19 @@ var MMDPlaylist = ({
         stopNode(index);
       }
     });
+    const nodesToKeep = /* @__PURE__ */ new Set();
+    nodesToKeep.add(currentNodeIndex);
+    if (playlist.loop && currentNodeIndex > 0) {
+      nodesToKeep.add(currentNodeIndex - 1);
+    }
+    if (currentNodeIndex < editableNodes.length - 1) {
+      nodesToKeep.add(currentNodeIndex + 1);
+    }
+    editableNodes.forEach((_, index) => {
+      if (!nodesToKeep.has(index)) {
+        clearNodeResources(index, false);
+      }
+    });
     onNodeChange?.(currentNodeIndex, currentNode);
     if (!isPreloading && (isAutoSwitchRef.current || playlist.autoPlay)) {
       console.log(`\u25B6\uFE0F [MMDPlaylist] \u51C6\u5907\u64AD\u653E\u8282\u70B9 ${currentNodeIndex}`);
@@ -1308,7 +1411,7 @@ var MMDPlaylist = ({
         }
       });
     }
-  }, [currentNodeIndex, currentNode, onNodeChange, isPreloading, playlist.autoPlay, preloadedNodes, editableNodes]);
+  }, [currentNodeIndex, currentNode, onNodeChange, isPreloading, playlist.autoPlay, playlist.loop, preloadedNodes, editableNodes]);
   const handleNodePreloaded = (nodeIndex) => {
     console.log(`\u2705 [MMDPlaylist] \u8282\u70B9 ${nodeIndex} \u9884\u52A0\u8F7D\u5B8C\u6210`);
     setPreloadedNodes((prev) => {
@@ -1327,6 +1430,20 @@ var MMDPlaylist = ({
       setPreloadProgress(progress);
     }
   }, [preloadedNodes, editableNodes.length, onLoad]);
+  React2.useEffect(() => {
+    const checkMemory = () => {
+      if (window.performance?.memory) {
+        const memInfo = window.performance.memory;
+        const usage = memInfo.usedJSHeapSize / memInfo.totalJSHeapSize;
+        setMemoryUsage(usage);
+        if (usage > 0.9) {
+          emergencyMemoryCleanup();
+        }
+      }
+    };
+    const interval = setInterval(checkMemory, 15e3);
+    return () => clearInterval(interval);
+  }, [currentNodeIndex, editableNodes]);
   const handlePlaybackEnded = (nodeIndex) => {
     console.log(`\u{1F3B5} [MMDPlaylist] \u8282\u70B9 ${nodeIndex} \u64AD\u653E\u5B8C\u6210`);
     if (nodeIndex !== currentNodeIndexRef.current) {
@@ -1436,6 +1553,11 @@ var MMDPlaylist = ({
       /* @__PURE__ */ React2__default.default.createElement(
         MMDPlayerEnhanced,
         {
+          ref: (componentRef) => {
+            if (componentRef) {
+              playerComponentRefs.current.set(index, componentRef);
+            }
+          },
           resources: node.resources,
           stage,
           autoPlay: index === currentNodeIndex && shouldAutoPlayInitial,