sa2kit 1.6.11 → 1.6.13

package/dist/index.d.mts

@@ -598,6 +598,9 @@ interface Project {
     link?: string;
     tags: string[];
 }
+interface ProjectsConfig {
+    projects: Project[];
+}
 interface ProjectCarouselProps {
     projects: Project[];
     className?: string;
@@ -930,4 +933,4 @@ declare function getCompletionStatusColor(isCompleted?: boolean): string;
  */
 declare function getCompletionStatusText(isCompleted?: boolean): string;
 
-export { About, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AutoOpenModal, type AutoOpenModalProps, Avatar, AvatarFallback, AvatarImage, BackButton, type BackButtonProps, type BackgroundRemovalOptions, type BackgroundRemovalState, BackgroundRemover, Badge, type BadgeProps, type Ball, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CategoryFilter, CollisionBalls, type CollisionBallsConfig, type CompletionFilter, CompletionFilterComponent, ConfirmModal, type ConfirmModalProps, Contact, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DraggableExperimentGrid, type DraggableExperimentGridProps, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, EnhancedAvatar, type EnhancedAvatarProps, ExperimentCard, type ExperimentCategory, ExperimentGrid, type ExperimentGridItem, type ExperimentGridProps, type ExperimentItem, ExperimentItemGrid, FilterButtonGroup, type FilterButtonGroupProps, type FilterOption, FloatingMenu, FloatingMenuExample, GenericOrderManager, type GenericOrderManagerProps, Grid, type GridColumns, type GridGap, type GridItem, type GridProps, Home, Input, Label, Modal, type ModalProps, Navigation, type NavigationConfig, type NavigationDirection, NavigationItemComponent as NavigationItem, type NavigationPosition, type NavigationProps, NavigationToggle, type OCROptions, type OCRResult, OCRScanner, type OCRState, type OrderManagerOperations, type OrderableItem, PageHeader, type PageHeaderProps, PermissionGuard, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, type ProfileBadge, ProfileButton, type ProfileButtonProps, type ProfileData, ProfileModal, type ProfileModalProps, Progress, ProjectCarousel, ScrollArea, ScrollBar, SearchBox, SearchResultHint, type SearchResultHintProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SentimentAnalyzer, type SentimentOptions, type SentimentResult, type SentimentState, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, SmartAssistant, type SocialLink, SortControl, type SortControlProps, type SortMode, SortModeToggle, type SortModeToggleProps, SortableExperimentItem, type SortableExperimentItemProps, type Stat, Tabs, TabsContent, TabsList, TabsTrigger, type TestFieldConfig, type TestFieldPageProps, type TextGenerationOptions, type TextGenerationState, Textarea, Timeline, type TimelineConfig, type TimelineItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserInfoBar, type UserInfoBarProps, type ViewMode, badgeVariants, buttonVariants, filterExperiments, getAllTags, getCategoryColor, getCategoryDisplayName, getCompletionFilterDisplayName, getCompletionStatusColor, getCompletionStatusText, getExperimentCounts, sortExperiments, useBackgroundRemoval, useOCR, useSentimentAnalysis, useTextGeneration, validateExperiment };
+export { About, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AutoOpenModal, type AutoOpenModalProps, Avatar, AvatarFallback, AvatarImage, BackButton, type BackButtonProps, type BackgroundRemovalOptions, type BackgroundRemovalState, BackgroundRemover, Badge, type BadgeProps, type Ball, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CategoryFilter, CollisionBalls, type CollisionBallsConfig, type CompletionFilter, CompletionFilterComponent, ConfirmModal, type ConfirmModalProps, Contact, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DraggableExperimentGrid, type DraggableExperimentGridProps, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, EnhancedAvatar, type EnhancedAvatarProps, ExperimentCard, type ExperimentCategory, ExperimentGrid, type ExperimentGridItem, type ExperimentGridProps, type ExperimentItem, ExperimentItemGrid, FilterButtonGroup, type FilterButtonGroupProps, type FilterOption, FloatingMenu, FloatingMenuExample, GenericOrderManager, type GenericOrderManagerProps, Grid, type GridColumns, type GridGap, type GridItem, type GridProps, Home, type HomeConfig, Input, Label, Modal, type ModalProps, Navigation, type NavigationConfig, type NavigationDirection, NavigationItemComponent as NavigationItem, type NavigationPosition, type NavigationProps, NavigationToggle, type OCROptions, type OCRResult, OCRScanner, type OCRState, type OrderManagerOperations, type OrderableItem, PageHeader, type PageHeaderProps, PermissionGuard, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, type ProfileBadge, ProfileButton, type ProfileButtonProps, type ProfileData, ProfileModal, type ProfileModalProps, Progress, ProjectCarousel, type ProjectsConfig, ScrollArea, ScrollBar, SearchBox, SearchResultHint, type SearchResultHintProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SentimentAnalyzer, type SentimentOptions, type SentimentResult, type SentimentState, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, SmartAssistant, type SocialLink, SortControl, type SortControlProps, type SortMode, SortModeToggle, type SortModeToggleProps, SortableExperimentItem, type SortableExperimentItemProps, type Stat, Tabs, TabsContent, TabsList, TabsTrigger, type TestFieldConfig, type TestFieldPageProps, type TextGenerationOptions, type TextGenerationState, Textarea, Timeline, type TimelineConfig, type TimelineItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserInfoBar, type UserInfoBarProps, type ViewMode, badgeVariants, buttonVariants, filterExperiments, getAllTags, getCategoryColor, getCategoryDisplayName, getCompletionFilterDisplayName, getCompletionStatusColor, getCompletionStatusText, getExperimentCounts, sortExperiments, useBackgroundRemoval, useOCR, useSentimentAnalysis, useTextGeneration, validateExperiment };

package/dist/index.d.ts

@@ -598,6 +598,9 @@ interface Project {
     link?: string;
     tags: string[];
 }
+interface ProjectsConfig {
+    projects: Project[];
+}
 interface ProjectCarouselProps {
     projects: Project[];
     className?: string;
@@ -930,4 +933,4 @@ declare function getCompletionStatusColor(isCompleted?: boolean): string;
  */
 declare function getCompletionStatusText(isCompleted?: boolean): string;
 
-export { About, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AutoOpenModal, type AutoOpenModalProps, Avatar, AvatarFallback, AvatarImage, BackButton, type BackButtonProps, type BackgroundRemovalOptions, type BackgroundRemovalState, BackgroundRemover, Badge, type BadgeProps, type Ball, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CategoryFilter, CollisionBalls, type CollisionBallsConfig, type CompletionFilter, CompletionFilterComponent, ConfirmModal, type ConfirmModalProps, Contact, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DraggableExperimentGrid, type DraggableExperimentGridProps, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, EnhancedAvatar, type EnhancedAvatarProps, ExperimentCard, type ExperimentCategory, ExperimentGrid, type ExperimentGridItem, type ExperimentGridProps, type ExperimentItem, ExperimentItemGrid, FilterButtonGroup, type FilterButtonGroupProps, type FilterOption, FloatingMenu, FloatingMenuExample, GenericOrderManager, type GenericOrderManagerProps, Grid, type GridColumns, type GridGap, type GridItem, type GridProps, Home, Input, Label, Modal, type ModalProps, Navigation, type NavigationConfig, type NavigationDirection, NavigationItemComponent as NavigationItem, type NavigationPosition, type NavigationProps, NavigationToggle, type OCROptions, type OCRResult, OCRScanner, type OCRState, type OrderManagerOperations, type OrderableItem, PageHeader, type PageHeaderProps, PermissionGuard, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, type ProfileBadge, ProfileButton, type ProfileButtonProps, type ProfileData, ProfileModal, type ProfileModalProps, Progress, ProjectCarousel, ScrollArea, ScrollBar, SearchBox, SearchResultHint, type SearchResultHintProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SentimentAnalyzer, type SentimentOptions, type SentimentResult, type SentimentState, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, SmartAssistant, type SocialLink, SortControl, type SortControlProps, type SortMode, SortModeToggle, type SortModeToggleProps, SortableExperimentItem, type SortableExperimentItemProps, type Stat, Tabs, TabsContent, TabsList, TabsTrigger, type TestFieldConfig, type TestFieldPageProps, type TextGenerationOptions, type TextGenerationState, Textarea, Timeline, type TimelineConfig, type TimelineItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserInfoBar, type UserInfoBarProps, type ViewMode, badgeVariants, buttonVariants, filterExperiments, getAllTags, getCategoryColor, getCategoryDisplayName, getCompletionFilterDisplayName, getCompletionStatusColor, getCompletionStatusText, getExperimentCounts, sortExperiments, useBackgroundRemoval, useOCR, useSentimentAnalysis, useTextGeneration, validateExperiment };
+export { About, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AutoOpenModal, type AutoOpenModalProps, Avatar, AvatarFallback, AvatarImage, BackButton, type BackButtonProps, type BackgroundRemovalOptions, type BackgroundRemovalState, BackgroundRemover, Badge, type BadgeProps, type Ball, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CategoryFilter, CollisionBalls, type CollisionBallsConfig, type CompletionFilter, CompletionFilterComponent, ConfirmModal, type ConfirmModalProps, Contact, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DraggableExperimentGrid, type DraggableExperimentGridProps, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, EnhancedAvatar, type EnhancedAvatarProps, ExperimentCard, type ExperimentCategory, ExperimentGrid, type ExperimentGridItem, type ExperimentGridProps, type ExperimentItem, ExperimentItemGrid, FilterButtonGroup, type FilterButtonGroupProps, type FilterOption, FloatingMenu, FloatingMenuExample, GenericOrderManager, type GenericOrderManagerProps, Grid, type GridColumns, type GridGap, type GridItem, type GridProps, Home, type HomeConfig, Input, Label, Modal, type ModalProps, Navigation, type NavigationConfig, type NavigationDirection, NavigationItemComponent as NavigationItem, type NavigationPosition, type NavigationProps, NavigationToggle, type OCROptions, type OCRResult, OCRScanner, type OCRState, type OrderManagerOperations, type OrderableItem, PageHeader, type PageHeaderProps, PermissionGuard, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, type ProfileBadge, ProfileButton, type ProfileButtonProps, type ProfileData, ProfileModal, type ProfileModalProps, Progress, ProjectCarousel, type ProjectsConfig, ScrollArea, ScrollBar, SearchBox, SearchResultHint, type SearchResultHintProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SentimentAnalyzer, type SentimentOptions, type SentimentResult, type SentimentState, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, SmartAssistant, type SocialLink, SortControl, type SortControlProps, type SortMode, SortModeToggle, type SortModeToggleProps, SortableExperimentItem, type SortableExperimentItemProps, type Stat, Tabs, TabsContent, TabsList, TabsTrigger, type TestFieldConfig, type TestFieldPageProps, type TextGenerationOptions, type TextGenerationState, Textarea, Timeline, type TimelineConfig, type TimelineItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserInfoBar, type UserInfoBarProps, type ViewMode, badgeVariants, buttonVariants, filterExperiments, getAllTags, getCategoryColor, getCategoryDisplayName, getCompletionFilterDisplayName, getCompletionStatusColor, getCompletionStatusText, getExperimentCounts, sortExperiments, useBackgroundRemoval, useOCR, useSentimentAnalysis, useTextGeneration, validateExperiment };

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 };