sa2kit 1.6.12 → 1.6.13

package/dist/mmd/index.d.mts

@@ -154,6 +154,8 @@ interface VisualNovelNode {
     bgmVolume?: number;
     /** 节点是否循环 MMD 动画（对话期间循环，默认 true） */
     loopAnimation?: boolean;
+    /** 是否支持应援功能（默认 false） */
+    supportCheer?: boolean;
 }
 /** 视觉小说剧本配置 */
 interface VisualNovelScript {
@@ -404,6 +406,53 @@ interface ChoiceMenuProps {
 }
 declare const ChoiceMenu: React__default.FC<ChoiceMenuProps>;
 
+interface LoopConfirmDialogProps {
+    onRestart: () => void;
+    onBackToStart: () => void;
+    onCancel?: () => void;
+}
+/**
+ * 循环确认对话框
+ * 在剧本播放到最后一个节点时，询问用户是否继续循环
+ */
+declare const LoopConfirmDialog: React__default.FC<LoopConfirmDialogProps>;
+
+/**
+ * 应援按钮组件
+ */
+interface CheerButtonProps {
+    /** 点击回调 */
+    onClick: () => void;
+    /** 按钮文字 */
+    text?: string;
+    /** 是否显示 */
+    show: boolean;
+    /** 样式类名 */
+    className?: string;
+}
+declare const CheerButton: React__default.FC<CheerButtonProps>;
+
+/**
+ * 3D粒子彩花效果组件
+ *
+ * 功能：
+ * - 点击应援按钮触发粒子爆炸效果
+ * - 彩色粒子从中心向外扩散
+ * - 粒子受重力影响下落
+ * - 自动清理完成的粒子
+ */
+interface CheerParticlesRef {
+    /** 触发一次粒子效果 */
+    trigger: () => void;
+    /** 清理所有粒子 */
+    clear: () => void;
+}
+interface CheerParticlesProps {
+    /** 容器样式类名 */
+    className?: string;
+}
+declare const CheerParticles: React__default.ForwardRefExoticComponent<CheerParticlesProps & React__default.RefAttributes<CheerParticlesRef>>;
+
 /** 音乐曲目配置 */
 interface MusicTrack {
     /** 唯一标识 */
@@ -1409,4 +1458,4 @@ interface FXThreePreviewProps {
 }
 declare const FXThreePreview: React__default.FC<FXThreePreviewProps>;
 
-export { type BranchCondition, ChoiceMenu, type ChoiceMenuProps, DialogueBox, type DialogueBoxProps, type DialogueBoxTheme, type DialogueChoice, type DialogueHistoryItem, type DialogueLine, type EffectFileType, type FXComment, type FXController, type FXDefine, type FXEffect, type FXFileConfig, type FXMergeStrategy, type FXParameter, FXParser, type FXParserOptions, type FXPass, type FXShaderFunction, type FXStaticVariable, type FXSummary, type FXTechnique, type FXTexture, FXThreePreview, type FXThreePreviewProps, FXToThreeAdapter, FXViewer, type FXViewerProps, type GLSLShader, type GLSLShaders, HLSLToGLSLConverter, HistoryPanel, LoadingOverlay, type LoadingOverlayProps, LoadingScreen, type LoadingScreenProps, MMDARPlayer, type MMDARPlayerProps, type MMDARPlayerRef, MMDMusicPlayer, type MMDMusicPlayerConfig, type MMDMusicPlayerProps, type MMDMusicPlayerRef, MMDPlayerBase, MMDPlayerBaseProps, MMDPlayerBaseRef, MMDPlayerEnhanced, MMDPlayerEnhancedDebugInfo, MMDPlayerEnhancedProps, MMDPlaylist, MMDPlaylistDebugInfo, MMDPlaylistNode, MMDPlaylistProps, MMDResources, MMDStage, MMDVisualNovel, type MMDVisualNovelProps, type MMDVisualNovelRef, MobileOptimization, MultiFXAdapter, type MultiFXAdapterOptions, MusicControls, type MusicControlsProps, type MusicTrack, PlaylistPanel, type PlaylistPanelProps, StartScreen, type StartScreenProps, type ThreeMaterialConfig, type ThreeRenderConfig, TrackInfo, type TrackInfoProps, type VisualEffect, type VisualNovelNode, type VisualNovelScript, compareFXEffects, exportFXToJSON, exportFXToMarkdown, extractTexturePaths, filterDefinesByPrefix, getColorParameters, getConfigSummaryText, getFeatureFlags, getTextureDefines, hasFeature, loadAmmo, validateFXEffect };
+export { type BranchCondition, CheerButton, type CheerButtonProps, CheerParticles, type CheerParticlesProps, type CheerParticlesRef, ChoiceMenu, type ChoiceMenuProps, DialogueBox, type DialogueBoxProps, type DialogueBoxTheme, type DialogueChoice, type DialogueHistoryItem, type DialogueLine, type EffectFileType, type FXComment, type FXController, type FXDefine, type FXEffect, type FXFileConfig, type FXMergeStrategy, type FXParameter, FXParser, type FXParserOptions, type FXPass, type FXShaderFunction, type FXStaticVariable, type FXSummary, type FXTechnique, type FXTexture, FXThreePreview, type FXThreePreviewProps, FXToThreeAdapter, FXViewer, type FXViewerProps, type GLSLShader, type GLSLShaders, HLSLToGLSLConverter, HistoryPanel, LoadingOverlay, type LoadingOverlayProps, LoadingScreen, type LoadingScreenProps, LoopConfirmDialog, MMDARPlayer, type MMDARPlayerProps, type MMDARPlayerRef, MMDMusicPlayer, type MMDMusicPlayerConfig, type MMDMusicPlayerProps, type MMDMusicPlayerRef, MMDPlayerBase, MMDPlayerBaseProps, MMDPlayerBaseRef, MMDPlayerEnhanced, MMDPlayerEnhancedDebugInfo, MMDPlayerEnhancedProps, MMDPlaylist, MMDPlaylistDebugInfo, MMDPlaylistNode, MMDPlaylistProps, MMDResources, MMDStage, MMDVisualNovel, type MMDVisualNovelProps, type MMDVisualNovelRef, MobileOptimization, MultiFXAdapter, type MultiFXAdapterOptions, MusicControls, type MusicControlsProps, type MusicTrack, PlaylistPanel, type PlaylistPanelProps, StartScreen, type StartScreenProps, type ThreeMaterialConfig, type ThreeRenderConfig, TrackInfo, type TrackInfoProps, type VisualEffect, type VisualNovelNode, type VisualNovelScript, compareFXEffects, exportFXToJSON, exportFXToMarkdown, extractTexturePaths, filterDefinesByPrefix, getColorParameters, getConfigSummaryText, getFeatureFlags, getTextureDefines, hasFeature, loadAmmo, validateFXEffect };

package/dist/mmd/index.d.ts

@@ -154,6 +154,8 @@ interface VisualNovelNode {
     bgmVolume?: number;
     /** 节点是否循环 MMD 动画（对话期间循环，默认 true） */
     loopAnimation?: boolean;
+    /** 是否支持应援功能（默认 false） */
+    supportCheer?: boolean;
 }
 /** 视觉小说剧本配置 */
 interface VisualNovelScript {
@@ -404,6 +406,53 @@ interface ChoiceMenuProps {
 }
 declare const ChoiceMenu: React__default.FC<ChoiceMenuProps>;
 
+interface LoopConfirmDialogProps {
+    onRestart: () => void;
+    onBackToStart: () => void;
+    onCancel?: () => void;
+}
+/**
+ * 循环确认对话框
+ * 在剧本播放到最后一个节点时，询问用户是否继续循环
+ */
+declare const LoopConfirmDialog: React__default.FC<LoopConfirmDialogProps>;
+
+/**
+ * 应援按钮组件
+ */
+interface CheerButtonProps {
+    /** 点击回调 */
+    onClick: () => void;
+    /** 按钮文字 */
+    text?: string;
+    /** 是否显示 */
+    show: boolean;
+    /** 样式类名 */
+    className?: string;
+}
+declare const CheerButton: React__default.FC<CheerButtonProps>;
+
+/**
+ * 3D粒子彩花效果组件
+ *
+ * 功能：
+ * - 点击应援按钮触发粒子爆炸效果
+ * - 彩色粒子从中心向外扩散
+ * - 粒子受重力影响下落
+ * - 自动清理完成的粒子
+ */
+interface CheerParticlesRef {
+    /** 触发一次粒子效果 */
+    trigger: () => void;
+    /** 清理所有粒子 */
+    clear: () => void;
+}
+interface CheerParticlesProps {
+    /** 容器样式类名 */
+    className?: string;
+}
+declare const CheerParticles: React__default.ForwardRefExoticComponent<CheerParticlesProps & React__default.RefAttributes<CheerParticlesRef>>;
+
 /** 音乐曲目配置 */
 interface MusicTrack {
     /** 唯一标识 */
@@ -1409,4 +1458,4 @@ interface FXThreePreviewProps {
 }
 declare const FXThreePreview: React__default.FC<FXThreePreviewProps>;
 
-export { type BranchCondition, ChoiceMenu, type ChoiceMenuProps, DialogueBox, type DialogueBoxProps, type DialogueBoxTheme, type DialogueChoice, type DialogueHistoryItem, type DialogueLine, type EffectFileType, type FXComment, type FXController, type FXDefine, type FXEffect, type FXFileConfig, type FXMergeStrategy, type FXParameter, FXParser, type FXParserOptions, type FXPass, type FXShaderFunction, type FXStaticVariable, type FXSummary, type FXTechnique, type FXTexture, FXThreePreview, type FXThreePreviewProps, FXToThreeAdapter, FXViewer, type FXViewerProps, type GLSLShader, type GLSLShaders, HLSLToGLSLConverter, HistoryPanel, LoadingOverlay, type LoadingOverlayProps, LoadingScreen, type LoadingScreenProps, MMDARPlayer, type MMDARPlayerProps, type MMDARPlayerRef, MMDMusicPlayer, type MMDMusicPlayerConfig, type MMDMusicPlayerProps, type MMDMusicPlayerRef, MMDPlayerBase, MMDPlayerBaseProps, MMDPlayerBaseRef, MMDPlayerEnhanced, MMDPlayerEnhancedDebugInfo, MMDPlayerEnhancedProps, MMDPlaylist, MMDPlaylistDebugInfo, MMDPlaylistNode, MMDPlaylistProps, MMDResources, MMDStage, MMDVisualNovel, type MMDVisualNovelProps, type MMDVisualNovelRef, MobileOptimization, MultiFXAdapter, type MultiFXAdapterOptions, MusicControls, type MusicControlsProps, type MusicTrack, PlaylistPanel, type PlaylistPanelProps, StartScreen, type StartScreenProps, type ThreeMaterialConfig, type ThreeRenderConfig, TrackInfo, type TrackInfoProps, type VisualEffect, type VisualNovelNode, type VisualNovelScript, compareFXEffects, exportFXToJSON, exportFXToMarkdown, extractTexturePaths, filterDefinesByPrefix, getColorParameters, getConfigSummaryText, getFeatureFlags, getTextureDefines, hasFeature, loadAmmo, validateFXEffect };
+export { type BranchCondition, CheerButton, type CheerButtonProps, CheerParticles, type CheerParticlesProps, type CheerParticlesRef, ChoiceMenu, type ChoiceMenuProps, DialogueBox, type DialogueBoxProps, type DialogueBoxTheme, type DialogueChoice, type DialogueHistoryItem, type DialogueLine, type EffectFileType, type FXComment, type FXController, type FXDefine, type FXEffect, type FXFileConfig, type FXMergeStrategy, type FXParameter, FXParser, type FXParserOptions, type FXPass, type FXShaderFunction, type FXStaticVariable, type FXSummary, type FXTechnique, type FXTexture, FXThreePreview, type FXThreePreviewProps, FXToThreeAdapter, FXViewer, type FXViewerProps, type GLSLShader, type GLSLShaders, HLSLToGLSLConverter, HistoryPanel, LoadingOverlay, type LoadingOverlayProps, LoadingScreen, type LoadingScreenProps, LoopConfirmDialog, MMDARPlayer, type MMDARPlayerProps, type MMDARPlayerRef, MMDMusicPlayer, type MMDMusicPlayerConfig, type MMDMusicPlayerProps, type MMDMusicPlayerRef, MMDPlayerBase, MMDPlayerBaseProps, MMDPlayerBaseRef, MMDPlayerEnhanced, MMDPlayerEnhancedDebugInfo, MMDPlayerEnhancedProps, MMDPlaylist, MMDPlaylistDebugInfo, MMDPlaylistNode, MMDPlaylistProps, MMDResources, MMDStage, MMDVisualNovel, type MMDVisualNovelProps, type MMDVisualNovelRef, MobileOptimization, MultiFXAdapter, type MultiFXAdapterOptions, MusicControls, type MusicControlsProps, type MusicTrack, PlaylistPanel, type PlaylistPanelProps, StartScreen, type StartScreenProps, type ThreeMaterialConfig, type ThreeRenderConfig, TrackInfo, type TrackInfoProps, type VisualEffect, type VisualNovelNode, type VisualNovelScript, compareFXEffects, exportFXToJSON, exportFXToMarkdown, extractTexturePaths, filterDefinesByPrefix, getColorParameters, getConfigSummaryText, getFeatureFlags, getTextureDefines, hasFeature, loadAmmo, validateFXEffect };