@longzai-intelligence-liquid-glass/components 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,4020 @@
1
+ import * as AccordionPrimitive from "@radix-ui/react-accordion";
2
+ import * as AlertDialogPrimitive from "@radix-ui/react-alert-dialog";
3
+ import { AnchorHTMLAttributes, ButtonHTMLAttributes, ComponentPropsWithoutRef, HTMLAttributes, InputHTMLAttributes, LabelHTMLAttributes, ReactNode, Ref, SVGAttributes, SelectHTMLAttributes, TableHTMLAttributes, TdHTMLAttributes, TextareaHTMLAttributes, ThHTMLAttributes } from "react";
4
+ import * as CheckboxPrimitive from "@radix-ui/react-checkbox";
5
+ import * as DialogPrimitive from "@radix-ui/react-dialog";
6
+ import { Command as Command$1 } from "cmdk";
7
+ import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
8
+ import * as HoverCardPrimitive from "@radix-ui/react-hover-card";
9
+ import * as PopoverPrimitive from "@radix-ui/react-popover";
10
+ import * as ProgressPrimitive from "@radix-ui/react-progress";
11
+ import * as RadioGroupPrimitive from "@radix-ui/react-radio-group";
12
+ import * as SliderPrimitive from "@radix-ui/react-slider";
13
+ import * as SwitchPrimitive from "@radix-ui/react-switch";
14
+ import * as TabsPrimitive from "@radix-ui/react-tabs";
15
+ import * as ToastPrimitive from "@radix-ui/react-toast";
16
+ import * as TooltipPrimitive from "@radix-ui/react-tooltip";
17
+ import { GlassPresetId } from "@longzai-intelligence-liquid-glass/core";
18
+ import { GlassElevationLevel } from "@longzai-intelligence-liquid-glass/tokens";
19
+ //#region src/accordion.d.ts
20
+ /**
21
+ * 手风琴视觉变体
22
+ */
23
+ type AccordionVariant = 'default' | 'frosted' | 'ghost' | 'glass' | 'outline' | 'separated';
24
+ /**
25
+ * 手风琴尺寸
26
+ */
27
+ type AccordionSize = 'lg' | 'md' | 'sm';
28
+ /**
29
+ * Accordion:手风琴根(单开放 multiple 时传 type="multiple")
30
+ */
31
+ declare const Accordion: import("react").ForwardRefExoticComponent<(AccordionPrimitive.AccordionMultipleProps | AccordionPrimitive.AccordionSingleProps) & import("react").RefAttributes<HTMLDivElement>>;
32
+ /**
33
+ * AccordionItem 属性
34
+ */
35
+ type AccordionItemProps = ComponentPropsWithoutRef<typeof AccordionPrimitive.Item> & {
36
+ /**
37
+ * 视觉变体(默认 'default')
38
+ */
39
+ variant?: AccordionVariant;
40
+ /**
41
+ * 条目 ref
42
+ */
43
+ ref?: Ref<HTMLDivElement>;
44
+ };
45
+ /**
46
+ * AccordionItem:手风琴条目容器
47
+ *
48
+ * @param props - 组件属性
49
+ * @returns 条目 JSX
50
+ */
51
+ declare function AccordionItem(props: AccordionItemProps): import("react").JSX.Element;
52
+ /**
53
+ * AccordionTrigger 属性
54
+ */
55
+ type AccordionTriggerProps = ComponentPropsWithoutRef<typeof AccordionPrimitive.Trigger> & {
56
+ /**
57
+ * 视觉变体(默认 'default')
58
+ */
59
+ variant?: AccordionVariant;
60
+ /**
61
+ * 尺寸档位(默认 'md')
62
+ */
63
+ size?: AccordionSize;
64
+ /**
65
+ * 触发器 ref
66
+ */
67
+ ref?: Ref<HTMLButtonElement>;
68
+ };
69
+ /**
70
+ * AccordionTrigger:手风琴触发器(尾部旋转箭头)
71
+ *
72
+ * @param props - 组件属性
73
+ * @returns 触发器 JSX
74
+ */
75
+ declare function AccordionTrigger(props: AccordionTriggerProps): import("react").JSX.Element;
76
+ /**
77
+ * AccordionContent 属性
78
+ */
79
+ type AccordionContentProps = ComponentPropsWithoutRef<typeof AccordionPrimitive.Content> & {
80
+ /**
81
+ * 视觉变体(默认 'default')
82
+ */
83
+ variant?: AccordionVariant;
84
+ /**
85
+ * 尺寸档位(默认 'md')
86
+ */
87
+ size?: AccordionSize;
88
+ /**
89
+ * 内容 ref
90
+ */
91
+ ref?: Ref<HTMLDivElement>;
92
+ };
93
+ /**
94
+ * AccordionContent:手风琴内容(高度动画)
95
+ *
96
+ * @param props - 组件属性
97
+ * @returns 内容 JSX
98
+ */
99
+ declare function AccordionContent(props: AccordionContentProps): import("react").JSX.Element;
100
+ //#endregion
101
+ //#region src/alert.d.ts
102
+ /**
103
+ * 警告横幅变体
104
+ */
105
+ type AlertVariant = 'default' | 'destructive' | 'info' | 'success' | 'warning';
106
+ /**
107
+ * Alert 属性
108
+ */
109
+ type AlertProps = HTMLAttributes<HTMLDivElement> & {
110
+ /**
111
+ * 语义变体(默认 'default')
112
+ */
113
+ variant?: AlertVariant;
114
+ /**
115
+ * 横幅内容
116
+ */
117
+ children?: ReactNode;
118
+ };
119
+ /**
120
+ * Alert:语义警告横幅
121
+ *
122
+ * @param props - 组件属性
123
+ * @returns 横幅 JSX
124
+ */
125
+ declare function Alert(props: AlertProps): import("react").JSX.Element;
126
+ /**
127
+ * AlertTitle 属性
128
+ */
129
+ type AlertTitleProps = HTMLAttributes<HTMLHeadingElement>;
130
+ /**
131
+ * AlertTitle:横幅标题
132
+ *
133
+ * @param props - 组件属性
134
+ * @returns 标题 JSX
135
+ */
136
+ declare function AlertTitle(props: AlertTitleProps): import("react").JSX.Element;
137
+ /**
138
+ * AlertDescription 属性
139
+ */
140
+ type AlertDescriptionProps = HTMLAttributes<HTMLParagraphElement>;
141
+ /**
142
+ * AlertDescription:横幅描述
143
+ *
144
+ * @param props - 组件属性
145
+ * @returns 描述 JSX
146
+ */
147
+ declare function AlertDescription(props: AlertDescriptionProps): import("react").JSX.Element;
148
+ //#endregion
149
+ //#region src/alert-dialog.d.ts
150
+ /**
151
+ * AlertDialog:确认对话框根
152
+ */
153
+ declare const AlertDialog: import("react").FC<AlertDialogPrimitive.AlertDialogProps>;
154
+ /**
155
+ * AlertDialogTrigger:确认对话框触发器
156
+ */
157
+ declare const AlertDialogTrigger: import("react").ForwardRefExoticComponent<AlertDialogPrimitive.AlertDialogTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
158
+ /**
159
+ * AlertDialogPortal 属性
160
+ */
161
+ type AlertDialogPortalProps = ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Portal>;
162
+ /**
163
+ * AlertDialogPortal:传送门容器
164
+ *
165
+ * @param props - 组件属性
166
+ * @returns 传送门 JSX
167
+ */
168
+ declare function AlertDialogPortal(props: AlertDialogPortalProps): import("react").JSX.Element;
169
+ /**
170
+ * AlertDialogOverlay 属性
171
+ */
172
+ type AlertDialogOverlayProps = ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Overlay>;
173
+ /**
174
+ * AlertDialogOverlay:遮罩层
175
+ *
176
+ * @param props - 组件属性
177
+ * @returns 遮罩 JSX
178
+ */
179
+ declare function AlertDialogOverlay(props: AlertDialogOverlayProps): import("react").JSX.Element;
180
+ /**
181
+ * AlertDialogContent 属性
182
+ */
183
+ type AlertDialogContentProps = ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Content> & {
184
+ /**
185
+ * 内容 ref
186
+ */
187
+ ref?: Ref<HTMLDivElement>;
188
+ };
189
+ /**
190
+ * AlertDialogContent:确认对话框内容(含遮罩,居中弹层)
191
+ *
192
+ * @param props - 组件属性
193
+ * @returns 内容 JSX
194
+ */
195
+ declare function AlertDialogContent(props: AlertDialogContentProps): import("react").JSX.Element;
196
+ /**
197
+ * AlertDialogHeader 属性
198
+ */
199
+ type AlertDialogHeaderProps = ComponentPropsWithoutRef<'div'>;
200
+ /**
201
+ * AlertDialogHeader:头部区
202
+ *
203
+ * @param props - 组件属性
204
+ * @returns 头部 JSX
205
+ */
206
+ declare function AlertDialogHeader(props: AlertDialogHeaderProps): import("react").JSX.Element;
207
+ /**
208
+ * AlertDialogFooter 属性
209
+ */
210
+ type AlertDialogFooterProps = ComponentPropsWithoutRef<'div'>;
211
+ /**
212
+ * AlertDialogFooter:底部操作区
213
+ *
214
+ * @param props - 组件属性
215
+ * @returns 底部 JSX
216
+ */
217
+ declare function AlertDialogFooter(props: AlertDialogFooterProps): import("react").JSX.Element;
218
+ /**
219
+ * AlertDialogTitle 属性
220
+ */
221
+ type AlertDialogTitleProps = ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Title>;
222
+ /**
223
+ * AlertDialogTitle:标题
224
+ *
225
+ * @param props - 组件属性
226
+ * @returns 标题 JSX
227
+ */
228
+ declare function AlertDialogTitle(props: AlertDialogTitleProps): import("react").JSX.Element;
229
+ /**
230
+ * AlertDialogDescription 属性
231
+ */
232
+ type AlertDialogDescriptionProps = ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Description>;
233
+ /**
234
+ * AlertDialogDescription:描述文本
235
+ *
236
+ * @param props - 组件属性
237
+ * @returns 描述 JSX
238
+ */
239
+ declare function AlertDialogDescription(props: AlertDialogDescriptionProps): import("react").JSX.Element;
240
+ /**
241
+ * AlertDialogAction 属性
242
+ */
243
+ type AlertDialogActionProps = ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Action>;
244
+ /**
245
+ * AlertDialogAction:确认按钮(关闭并确认)
246
+ *
247
+ * @param props - 组件属性
248
+ * @returns 按钮 JSX
249
+ */
250
+ declare function AlertDialogAction(props: AlertDialogActionProps): import("react").JSX.Element;
251
+ /**
252
+ * AlertDialogCancel 属性
253
+ */
254
+ type AlertDialogCancelProps = ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Cancel>;
255
+ /**
256
+ * AlertDialogCancel:取消按钮
257
+ *
258
+ * @param props - 组件属性
259
+ * @returns 按钮 JSX
260
+ */
261
+ declare function AlertDialogCancel(props: AlertDialogCancelProps): import("react").JSX.Element;
262
+ //#endregion
263
+ //#region src/animated-gradient.d.ts
264
+ /**
265
+ * AnimatedGradient 配色变体
266
+ */
267
+ type AnimatedGradientVariant = 'aurora' | 'cool' | 'default' | 'glass' | 'warm';
268
+ /**
269
+ * AnimatedGradient 属性
270
+ */
271
+ type AnimatedGradientProps = HTMLAttributes<HTMLDivElement> & {
272
+ /**
273
+ * 配色变体(默认 'default')
274
+ */
275
+ variant?: AnimatedGradientVariant;
276
+ /**
277
+ * 动画周期(秒,默认 6)
278
+ */
279
+ duration?: number;
280
+ /**
281
+ * 渐变内容
282
+ */
283
+ children?: ReactNode;
284
+ /**
285
+ * 容器 ref(React 19 ref-as-prop)
286
+ */
287
+ ref?: Ref<HTMLDivElement>;
288
+ };
289
+ /**
290
+ * AnimatedGradient:流动动画渐变容器
291
+ *
292
+ * @param props - 组件属性
293
+ * @returns 渐变容器 JSX
294
+ */
295
+ declare function AnimatedGradient(props: AnimatedGradientProps): import("react").JSX.Element;
296
+ //#endregion
297
+ //#region src/aurora-background.d.ts
298
+ /**
299
+ * AuroraBackground 属性
300
+ */
301
+ type AuroraBackgroundProps = HTMLAttributes<HTMLDivElement> & {
302
+ /**
303
+ * 极光色块数量(默认 3)
304
+ */
305
+ blobCount?: number;
306
+ /**
307
+ * 极光基础配色(循环取用)
308
+ */
309
+ colors?: string[];
310
+ /**
311
+ * 动画周期(秒,默认 8)
312
+ */
313
+ duration?: number;
314
+ /**
315
+ * 模糊强度(px,默认 80)
316
+ */
317
+ blur?: number;
318
+ /**
319
+ * 极光层不透明度 0-1(默认 0.4)
320
+ */
321
+ intensity?: number;
322
+ /**
323
+ * 叠加层之上的内容
324
+ */
325
+ children?: ReactNode;
326
+ /**
327
+ * 叠加层 ref(React 19 ref-as-prop)
328
+ */
329
+ ref?: Ref<HTMLDivElement>;
330
+ };
331
+ /**
332
+ * AuroraBackground:极光漂移背景叠加层
333
+ *
334
+ * @param props - 组件属性
335
+ * @returns 极光背景 JSX
336
+ */
337
+ declare function AuroraBackground(props: AuroraBackgroundProps): import("react").JSX.Element;
338
+ //#endregion
339
+ //#region src/avatar.d.ts
340
+ /**
341
+ * Avatar 尺寸
342
+ */
343
+ type AvatarSize = 'lg' | 'md' | 'sm';
344
+ /**
345
+ * Avatar 属性
346
+ */
347
+ type AvatarProps = Omit<HTMLAttributes<HTMLSpanElement>, 'children'> & {
348
+ /**
349
+ * 图片地址(缺省渲染回退内容)
350
+ */
351
+ src?: string;
352
+ /**
353
+ * 图片替代文本
354
+ */
355
+ alt?: string;
356
+ /**
357
+ * 回退内容(图片加载失败或无 src 时显示)
358
+ */
359
+ fallback?: ReactNode;
360
+ /**
361
+ * 尺寸档位(默认 'md')
362
+ */
363
+ size?: AvatarSize;
364
+ /**
365
+ * 头像内容
366
+ */
367
+ children?: ReactNode;
368
+ };
369
+ /**
370
+ * Avatar:头像(图片 + 回退)
371
+ *
372
+ * @param props - 组件属性
373
+ * @returns 头像 JSX
374
+ */
375
+ declare function Avatar(props: AvatarProps): import("react").JSX.Element;
376
+ /**
377
+ * AvatarGroup 属性
378
+ */
379
+ type AvatarGroupProps = Omit<HTMLAttributes<HTMLSpanElement>, 'children'> & {
380
+ /**
381
+ * 头像列表
382
+ */
383
+ children?: ReactNode;
384
+ /**
385
+ * 最多直接展示数(超出折叠为 +N)
386
+ */
387
+ max?: number;
388
+ };
389
+ /**
390
+ * AvatarGroup:头像组(溢出折叠 +N)
391
+ *
392
+ * @param props - 组件属性
393
+ * @returns 头像组 JSX
394
+ */
395
+ declare function AvatarGroup(props: AvatarGroupProps): import("react").JSX.Element;
396
+ /**
397
+ * AvatarStatusDot 属性
398
+ */
399
+ type AvatarStatusDotProps = HTMLAttributes<HTMLSpanElement> & {
400
+ /**
401
+ * 状态色(CSS 颜色值,默认语义绿)
402
+ */
403
+ color?: string;
404
+ };
405
+ /**
406
+ * AvatarStatusDot:头像状态点
407
+ *
408
+ * @param props - 组件属性
409
+ * @returns 状态点 JSX
410
+ */
411
+ declare function AvatarStatusDot(props: AvatarStatusDotProps): import("react").JSX.Element;
412
+ //#endregion
413
+ //#region src/badge.d.ts
414
+ /**
415
+ * 徽标视觉变体
416
+ */
417
+ type BadgeVariant = 'default' | 'destructive' | 'ghost' | 'glass' | 'glow' | 'info' | 'liquid' | 'matte' | 'outline' | 'success' | 'warning';
418
+ /**
419
+ * 徽标尺寸
420
+ */
421
+ type BadgeSize = 'lg' | 'md' | 'sm';
422
+ /**
423
+ * Badge 属性
424
+ */
425
+ type BadgeProps = HTMLAttributes<HTMLSpanElement> & {
426
+ /**
427
+ * 视觉变体(默认 'default')
428
+ */
429
+ variant?: BadgeVariant;
430
+ /**
431
+ * 尺寸档位(默认 'md')
432
+ */
433
+ size?: BadgeSize;
434
+ /**
435
+ * 徽标内容
436
+ */
437
+ children?: ReactNode;
438
+ };
439
+ /**
440
+ * Badge:状态胶囊徽标
441
+ *
442
+ * @param props - 组件属性
443
+ * @returns 徽标 JSX
444
+ */
445
+ declare function Badge(props: BadgeProps): import("react").JSX.Element;
446
+ //#endregion
447
+ //#region src/blur-fade.d.ts
448
+ /**
449
+ * BlurFade 属性
450
+ */
451
+ type BlurFadeProps = HTMLAttributes<HTMLDivElement> & {
452
+ /**
453
+ * 过渡延迟(ms,默认 0)
454
+ */
455
+ delay?: number;
456
+ /**
457
+ * 过渡时长(ms,默认 500)
458
+ */
459
+ duration?: number;
460
+ /**
461
+ * 初始模糊量(px,默认 8)
462
+ */
463
+ blur?: number;
464
+ /**
465
+ * 初始纵向位移(px,默认 12)
466
+ */
467
+ yOffset?: number;
468
+ /**
469
+ * 是否仅动画一次(默认 true)
470
+ */
471
+ once?: boolean;
472
+ /**
473
+ * IntersectionObserver 阈值 0-1(默认 0.1)
474
+ */
475
+ threshold?: number;
476
+ /**
477
+ * 淡入内容
478
+ */
479
+ children?: ReactNode;
480
+ /**
481
+ * 容器 ref(React 19 ref-as-prop)
482
+ */
483
+ ref?: Ref<HTMLDivElement>;
484
+ };
485
+ /**
486
+ * BlurFade:视口触发模糊淡入容器
487
+ *
488
+ * @param props - 组件属性
489
+ * @returns 淡入容器 JSX
490
+ */
491
+ declare function BlurFade(props: BlurFadeProps): import("react").JSX.Element;
492
+ //#endregion
493
+ //#region src/blur-spotlight.d.ts
494
+ /**
495
+ * BlurSpotlight 属性
496
+ */
497
+ type BlurSpotlightProps = HTMLAttributes<HTMLDivElement> & {
498
+ /**
499
+ * 聚光半径(px,默认 300)
500
+ */
501
+ size?: number;
502
+ /**
503
+ * 聚光颜色(默认 '#6366f1')
504
+ */
505
+ color?: string;
506
+ /**
507
+ * 模糊量(px,默认 80)
508
+ */
509
+ blur?: number;
510
+ /**
511
+ * 强度/不透明度 0-1(默认 0.5)
512
+ */
513
+ intensity?: number;
514
+ /**
515
+ * 叠加层 ref(React 19 ref-as-prop)
516
+ */
517
+ ref?: Ref<HTMLDivElement>;
518
+ };
519
+ /**
520
+ * BlurSpotlight:光标跟随模糊聚光叠加层
521
+ *
522
+ * @param props - 组件属性
523
+ * @returns 聚光叠加层 JSX
524
+ */
525
+ declare function BlurSpotlight(props: BlurSpotlightProps): import("react").JSX.Element;
526
+ //#endregion
527
+ //#region src/border-beam.d.ts
528
+ /**
529
+ * BorderBeam 属性
530
+ */
531
+ type BorderBeamProps = HTMLAttributes<HTMLDivElement> & {
532
+ /**
533
+ * 环绕周期(秒,默认 6)
534
+ */
535
+ duration?: number;
536
+ /**
537
+ * 动画延迟(秒,默认 0)
538
+ */
539
+ delay?: number;
540
+ /**
541
+ * 光束宽度(px,默认 100)
542
+ */
543
+ size?: number;
544
+ /**
545
+ * 渐变起始色(默认 var(--color-accent))
546
+ */
547
+ colorFrom?: string;
548
+ /**
549
+ * 渐变结束色(默认 transparent)
550
+ */
551
+ colorTo?: string;
552
+ /**
553
+ * 覆写圆角(默认继承宿主圆角)
554
+ */
555
+ borderRadius?: string;
556
+ /**
557
+ * 叠加层 ref(React 19 ref-as-prop)
558
+ */
559
+ ref?: Ref<HTMLDivElement>;
560
+ };
561
+ /**
562
+ * BorderBeam:环绕流光边框叠加层
563
+ *
564
+ * @param props - 组件属性
565
+ * @returns 流光边框 JSX
566
+ */
567
+ declare function BorderBeam(props: BorderBeamProps): import("react").JSX.Element;
568
+ //#endregion
569
+ //#region src/button.d.ts
570
+ /**
571
+ * Button 视觉变体
572
+ */
573
+ type ButtonVariant = 'default' | 'frosted' | 'ghost' | 'glass' | 'glow' | 'liquid' | 'matte' | 'outline';
574
+ /**
575
+ * Button 尺寸
576
+ */
577
+ type ButtonSize = 'lg' | 'md' | 'sm';
578
+ /**
579
+ * Button 属性
580
+ */
581
+ type ButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & {
582
+ /**
583
+ * 视觉变体(默认 default)
584
+ */
585
+ variant?: ButtonVariant;
586
+ /**
587
+ * 尺寸(默认 md)
588
+ */
589
+ size?: ButtonSize;
590
+ /**
591
+ * 以子元素为渲染根(Radix Slot 透传)
592
+ */
593
+ asChild?: boolean;
594
+ /**
595
+ * 按钮内容
596
+ */
597
+ children?: ReactNode;
598
+ /**
599
+ * 按钮 ref(React 19 ref-as-prop)
600
+ */
601
+ ref?: Ref<HTMLButtonElement>;
602
+ };
603
+ /**
604
+ * Button:玻璃质感按钮
605
+ *
606
+ * @param props - 组件属性
607
+ * @returns 按钮 JSX
608
+ */
609
+ declare function Button(props: ButtonProps): import("react").JSX.Element;
610
+ //#endregion
611
+ //#region src/card.d.ts
612
+ /**
613
+ * Card 属性
614
+ */
615
+ type CardProps = HTMLAttributes<HTMLDivElement> & {
616
+ /**
617
+ * 卡片内容
618
+ */
619
+ children?: ReactNode;
620
+ };
621
+ /**
622
+ * Card:通用卡片容器
623
+ *
624
+ * @param props - 组件属性
625
+ * @returns 卡片 JSX
626
+ */
627
+ declare function Card(props: CardProps): import("react").JSX.Element;
628
+ /**
629
+ * CardHeader 属性
630
+ */
631
+ type CardHeaderProps = HTMLAttributes<HTMLDivElement>;
632
+ /**
633
+ * CardHeader:卡片头部
634
+ *
635
+ * @param props - 组件属性
636
+ * @returns 头部 JSX
637
+ */
638
+ declare function CardHeader(props: CardHeaderProps): import("react").JSX.Element;
639
+ /**
640
+ * CardTitle 属性
641
+ */
642
+ type CardTitleProps = HTMLAttributes<HTMLHeadingElement>;
643
+ /**
644
+ * CardTitle:卡片标题
645
+ *
646
+ * @param props - 组件属性
647
+ * @returns 标题 JSX
648
+ */
649
+ declare function CardTitle(props: CardTitleProps): import("react").JSX.Element;
650
+ /**
651
+ * CardDescription 属性
652
+ */
653
+ type CardDescriptionProps = HTMLAttributes<HTMLParagraphElement>;
654
+ /**
655
+ * CardDescription:卡片描述
656
+ *
657
+ * @param props - 组件属性
658
+ * @returns 描述 JSX
659
+ */
660
+ declare function CardDescription(props: CardDescriptionProps): import("react").JSX.Element;
661
+ /**
662
+ * CardContent 属性
663
+ */
664
+ type CardContentProps = HTMLAttributes<HTMLDivElement>;
665
+ /**
666
+ * CardContent:卡片内容区
667
+ *
668
+ * @param props - 组件属性
669
+ * @returns 内容 JSX
670
+ */
671
+ declare function CardContent(props: CardContentProps): import("react").JSX.Element;
672
+ /**
673
+ * CardFooter 属性
674
+ */
675
+ type CardFooterProps = HTMLAttributes<HTMLDivElement>;
676
+ /**
677
+ * CardFooter:卡片底部
678
+ *
679
+ * @param props - 组件属性
680
+ * @returns 底部 JSX
681
+ */
682
+ declare function CardFooter(props: CardFooterProps): import("react").JSX.Element;
683
+ //#endregion
684
+ //#region src/checkbox.d.ts
685
+ /**
686
+ * 复选框视觉变体
687
+ */
688
+ type CheckboxVariant = 'default' | 'frosted' | 'glass' | 'liquid' | 'matte' | 'outline';
689
+ /**
690
+ * 复选框尺寸
691
+ */
692
+ type CheckboxSize = 'lg' | 'md' | 'sm';
693
+ /**
694
+ * Checkbox 属性
695
+ */
696
+ type CheckboxProps = ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root> & {
697
+ /**
698
+ * 视觉变体(默认 'default')
699
+ */
700
+ variant?: CheckboxVariant;
701
+ /**
702
+ * 尺寸档位(默认 'md')
703
+ */
704
+ size?: CheckboxSize;
705
+ /**
706
+ * 根节点 ref
707
+ */
708
+ ref?: Ref<HTMLButtonElement>;
709
+ };
710
+ /**
711
+ * Checkbox:玻璃质感复选框(勾选/半选指示器)
712
+ *
713
+ * @param props - 组件属性
714
+ * @returns 复选框 JSX
715
+ */
716
+ declare function Checkbox(props: CheckboxProps): import("react").JSX.Element;
717
+ //#endregion
718
+ //#region src/chip.d.ts
719
+ /**
720
+ * 芯片尺寸
721
+ */
722
+ type ChipSize = 'lg' | 'md' | 'sm';
723
+ /**
724
+ * Chip 属性
725
+ */
726
+ type ChipProps = HTMLAttributes<HTMLSpanElement> & {
727
+ /**
728
+ * 尺寸档位(默认 'sm')
729
+ */
730
+ size?: ChipSize;
731
+ /**
732
+ * 芯片内容
733
+ */
734
+ children?: ReactNode;
735
+ };
736
+ /**
737
+ * Chip:紧凑标签芯片
738
+ *
739
+ * @param props - 组件属性
740
+ * @returns 芯片 JSX
741
+ */
742
+ declare function Chip(props: ChipProps): import("react").JSX.Element;
743
+ //#endregion
744
+ //#region src/chromatic-text.d.ts
745
+ /**
746
+ * 色差通道配色 [红, 蓝]
747
+ */
748
+ type ChromaticChannelColors = [string, string];
749
+ /**
750
+ * ChromaticText 属性
751
+ */
752
+ type ChromaticTextProps = HTMLAttributes<HTMLSpanElement> & {
753
+ /**
754
+ * 色差错位量(px,默认 2)
755
+ */
756
+ offset?: number;
757
+ /**
758
+ * 抖动动画周期(秒,0 为静态,默认 0)
759
+ */
760
+ duration?: number;
761
+ /**
762
+ * 通道配色 [红, 蓝](默认 ['#ff0040', '#0080ff'])
763
+ */
764
+ colors?: ChromaticChannelColors;
765
+ /**
766
+ * 文字内容
767
+ */
768
+ children?: ReactNode;
769
+ /**
770
+ * 文字 ref(React 19 ref-as-prop)
771
+ */
772
+ ref?: Ref<HTMLSpanElement>;
773
+ };
774
+ /**
775
+ * ChromaticText:红蓝色差文字
776
+ *
777
+ * @param props - 组件属性
778
+ * @returns 色差文字 JSX
779
+ */
780
+ declare function ChromaticText(props: ChromaticTextProps): import("react").JSX.Element;
781
+ //#endregion
782
+ //#region src/class-name.utils.d.ts
783
+ /**
784
+ * 类名合并工具
785
+ *
786
+ * 过滤假值类名并以空格连接(衍生自 glinui 的 cn 思路,去除 tailwind-merge 依赖)。
787
+ */
788
+ /**
789
+ * 合并类名
790
+ *
791
+ * @param inputs - 类名片段(假值自动忽略)
792
+ * @returns 空格连接的类名串
793
+ */
794
+ declare function cn(...inputs: Array<string | false | null | undefined>): string;
795
+ //#endregion
796
+ //#region src/code.d.ts
797
+ /**
798
+ * Code 属性
799
+ */
800
+ type CodeProps = HTMLAttributes<HTMLElement> & {
801
+ /**
802
+ * 代码内容
803
+ */
804
+ children?: ReactNode;
805
+ };
806
+ /**
807
+ * Code:行内代码
808
+ *
809
+ * @param props - 组件属性
810
+ * @returns 代码 JSX
811
+ */
812
+ declare function Code(props: CodeProps): import("react").JSX.Element;
813
+ //#endregion
814
+ //#region src/command.d.ts
815
+ /**
816
+ * Command:命令面板根
817
+ */
818
+ declare const Command: import("react").ForwardRefExoticComponent<{
819
+ children?: React.ReactNode;
820
+ } & Pick<Pick<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof import("react").HTMLAttributes<HTMLDivElement>> & {
821
+ ref?: React.Ref<HTMLDivElement>;
822
+ } & {
823
+ asChild?: boolean;
824
+ }, "asChild" | "key" | keyof import("react").HTMLAttributes<HTMLDivElement>> & {
825
+ label?: string;
826
+ shouldFilter?: boolean;
827
+ filter?: (value: string, search: string, keywords?: string[]) => number;
828
+ defaultValue?: string;
829
+ value?: string;
830
+ onValueChange?: (value: string) => void;
831
+ loop?: boolean;
832
+ disablePointerSelection?: boolean;
833
+ vimBindings?: boolean;
834
+ } & import("react").RefAttributes<HTMLDivElement>> & {
835
+ List: React.ForwardRefExoticComponent<{
836
+ children?: React.ReactNode;
837
+ } & Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
838
+ ref?: React.Ref<HTMLDivElement>;
839
+ } & {
840
+ asChild?: boolean;
841
+ }, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & {
842
+ label?: string;
843
+ } & React.RefAttributes<HTMLDivElement>>;
844
+ Item: React.ForwardRefExoticComponent<{
845
+ children?: React.ReactNode;
846
+ } & Omit<Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
847
+ ref?: React.Ref<HTMLDivElement>;
848
+ } & {
849
+ asChild?: boolean;
850
+ }, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild">, "onSelect" | "disabled" | "value"> & {
851
+ disabled?: boolean;
852
+ onSelect?: (value: string) => void;
853
+ value?: string;
854
+ keywords?: string[];
855
+ forceMount?: boolean;
856
+ } & React.RefAttributes<HTMLDivElement>>;
857
+ Input: React.ForwardRefExoticComponent<Omit<Pick<Pick<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "key" | keyof React.InputHTMLAttributes<HTMLInputElement>> & {
858
+ ref?: React.Ref<HTMLInputElement>;
859
+ } & {
860
+ asChild?: boolean;
861
+ }, "key" | "asChild" | keyof React.InputHTMLAttributes<HTMLInputElement>>, "onChange" | "value" | "type"> & {
862
+ value?: string;
863
+ onValueChange?: (search: string) => void;
864
+ } & React.RefAttributes<HTMLInputElement>>;
865
+ Group: React.ForwardRefExoticComponent<{
866
+ children?: React.ReactNode;
867
+ } & Omit<Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
868
+ ref?: React.Ref<HTMLDivElement>;
869
+ } & {
870
+ asChild?: boolean;
871
+ }, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild">, "heading" | "value"> & {
872
+ heading?: React.ReactNode;
873
+ value?: string;
874
+ forceMount?: boolean;
875
+ } & React.RefAttributes<HTMLDivElement>>;
876
+ Separator: React.ForwardRefExoticComponent<Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
877
+ ref?: React.Ref<HTMLDivElement>;
878
+ } & {
879
+ asChild?: boolean;
880
+ }, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & {
881
+ alwaysRender?: boolean;
882
+ } & React.RefAttributes<HTMLDivElement>>;
883
+ Dialog: React.ForwardRefExoticComponent<DialogPrimitive.DialogProps & {
884
+ children?: React.ReactNode;
885
+ } & Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
886
+ ref?: React.Ref<HTMLDivElement>;
887
+ } & {
888
+ asChild?: boolean;
889
+ }, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & {
890
+ label?: string;
891
+ shouldFilter?: boolean;
892
+ filter?: (value: string, search: string, keywords?: string[]) => number;
893
+ defaultValue?: string;
894
+ value?: string;
895
+ onValueChange?: (value: string) => void;
896
+ loop?: boolean;
897
+ disablePointerSelection?: boolean;
898
+ vimBindings?: boolean;
899
+ } & {
900
+ overlayClassName?: string;
901
+ contentClassName?: string;
902
+ container?: HTMLElement;
903
+ } & React.RefAttributes<HTMLDivElement>>;
904
+ Empty: React.ForwardRefExoticComponent<{
905
+ children?: React.ReactNode;
906
+ } & Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
907
+ ref?: React.Ref<HTMLDivElement>;
908
+ } & {
909
+ asChild?: boolean;
910
+ }, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & React.RefAttributes<HTMLDivElement>>;
911
+ Loading: React.ForwardRefExoticComponent<{
912
+ children?: React.ReactNode;
913
+ } & Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
914
+ ref?: React.Ref<HTMLDivElement>;
915
+ } & {
916
+ asChild?: boolean;
917
+ }, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & {
918
+ progress?: number;
919
+ label?: string;
920
+ } & React.RefAttributes<HTMLDivElement>>;
921
+ };
922
+ /**
923
+ * CommandInput 属性
924
+ */
925
+ type CommandInputProps = ComponentPropsWithoutRef<typeof Command$1.Input> & {
926
+ /**
927
+ * 输入框 ref
928
+ */
929
+ ref?: Ref<HTMLInputElement>;
930
+ };
931
+ /**
932
+ * CommandInput:命令输入框(前置搜索图标)
933
+ *
934
+ * @param props - 组件属性
935
+ * @returns 输入 JSX
936
+ */
937
+ declare function CommandInput(props: CommandInputProps): import("react").JSX.Element;
938
+ /**
939
+ * CommandList 属性
940
+ */
941
+ type CommandListProps = ComponentPropsWithoutRef<typeof Command$1.List> & {
942
+ /**
943
+ * 列表 ref
944
+ */
945
+ ref?: Ref<HTMLDivElement>;
946
+ };
947
+ /**
948
+ * CommandList:命令结果列表(滚动容器)
949
+ *
950
+ * @param props - 组件属性
951
+ * @returns 列表 JSX
952
+ */
953
+ declare function CommandList(props: CommandListProps): import("react").JSX.Element;
954
+ /**
955
+ * CommandEmpty 属性
956
+ */
957
+ type CommandEmptyProps = ComponentPropsWithoutRef<typeof Command$1.Empty>;
958
+ /**
959
+ * CommandEmpty:空结果提示
960
+ *
961
+ * @param props - 组件属性
962
+ * @returns 提示 JSX
963
+ */
964
+ declare function CommandEmpty(props: CommandEmptyProps): import("react").JSX.Element;
965
+ /**
966
+ * CommandGroup 属性
967
+ */
968
+ type CommandGroupProps = ComponentPropsWithoutRef<typeof Command$1.Group>;
969
+ /**
970
+ * CommandGroup:命令分组
971
+ *
972
+ * @param props - 组件属性
973
+ * @returns 分组 JSX
974
+ */
975
+ declare function CommandGroup(props: CommandGroupProps): import("react").JSX.Element;
976
+ /**
977
+ * CommandItem 属性
978
+ */
979
+ type CommandItemProps = ComponentPropsWithoutRef<typeof Command$1.Item> & {
980
+ /**
981
+ * 菜单项 ref
982
+ */
983
+ ref?: Ref<HTMLDivElement>;
984
+ };
985
+ /**
986
+ * CommandItem:命令项
987
+ *
988
+ * @param props - 组件属性
989
+ * @returns 命令项 JSX
990
+ */
991
+ declare function CommandItem(props: CommandItemProps): import("react").JSX.Element;
992
+ /**
993
+ * CommandSeparator 属性
994
+ */
995
+ type CommandSeparatorProps = ComponentPropsWithoutRef<typeof Command$1.Separator>;
996
+ /**
997
+ * CommandSeparator:命令分隔线
998
+ *
999
+ * @param props - 组件属性
1000
+ * @returns 分隔线 JSX
1001
+ */
1002
+ declare function CommandSeparator(props: CommandSeparatorProps): import("react").JSX.Element;
1003
+ /**
1004
+ * CommandDialog 属性
1005
+ */
1006
+ type CommandDialogProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Root> & {
1007
+ /**
1008
+ * 面板标题(对话框可访问名)
1009
+ */
1010
+ title?: string;
1011
+ /**
1012
+ * 面板描述
1013
+ */
1014
+ description?: string;
1015
+ /**
1016
+ * 命令面板内容
1017
+ */
1018
+ children?: ReactNode;
1019
+ };
1020
+ /**
1021
+ * CommandDialog:命令面板弹窗(Dialog + Command)
1022
+ *
1023
+ * @param props - 组件属性
1024
+ * @returns 弹窗 JSX
1025
+ */
1026
+ declare function CommandDialog(props: CommandDialogProps): import("react").JSX.Element;
1027
+ //#endregion
1028
+ //#region src/counter.d.ts
1029
+ /**
1030
+ * Counter 属性
1031
+ */
1032
+ type CounterProps = {
1033
+ /**
1034
+ * 目标数值
1035
+ */
1036
+ value: number;
1037
+ /**
1038
+ * 动画时长(毫秒,默认 800)
1039
+ */
1040
+ duration?: number;
1041
+ /**
1042
+ * 小数位数(默认 0)
1043
+ */
1044
+ decimals?: number;
1045
+ /**
1046
+ * 千分位分隔(默认 true)
1047
+ */
1048
+ groupSeparator?: boolean;
1049
+ /**
1050
+ * 根类名
1051
+ */
1052
+ className?: string;
1053
+ };
1054
+ /**
1055
+ * Counter:滚动计数器
1056
+ *
1057
+ * @param props - 组件属性
1058
+ * @returns 计数 JSX
1059
+ */
1060
+ declare function Counter(props: CounterProps): import("react").JSX.Element;
1061
+ //#endregion
1062
+ //#region src/table.d.ts
1063
+ /**
1064
+ * 表格视觉变体
1065
+ */
1066
+ type TableVariant = 'default' | 'ghost' | 'glass' | 'liquid' | 'matte' | 'outline';
1067
+ /**
1068
+ * 表格尺寸
1069
+ */
1070
+ type TableSize = 'lg' | 'md' | 'sm';
1071
+ /**
1072
+ * 表格布局算法
1073
+ */
1074
+ type TableLayout = 'auto' | 'fixed';
1075
+ /**
1076
+ * 单元格水平对齐方向
1077
+ */
1078
+ type TableAlign = 'center' | 'left' | 'right';
1079
+ /**
1080
+ * 行色调
1081
+ */
1082
+ type TableRowTone = 'danger' | 'default' | 'info' | 'success' | 'warning';
1083
+ /**
1084
+ * 表格上下文值(Table 根节点下发,子组件经 useContext 读取)
1085
+ */
1086
+ type TableContextValue = {
1087
+ /**
1088
+ * 视觉变体(默认 'default')
1089
+ */
1090
+ variant: TableVariant;
1091
+ /**
1092
+ * 尺寸档位(默认 'md')
1093
+ */
1094
+ size: TableSize;
1095
+ /**
1096
+ * 是否条纹行
1097
+ */
1098
+ striped: boolean;
1099
+ /**
1100
+ * 是否交互行(悬停反馈)
1101
+ */
1102
+ interactive: boolean;
1103
+ /**
1104
+ * 是否粘性表头
1105
+ */
1106
+ stickyHeader: boolean;
1107
+ /**
1108
+ * 是否粘性首列
1109
+ */
1110
+ stickyFirstColumn: boolean;
1111
+ /**
1112
+ * 是否网格分割线
1113
+ */
1114
+ grid: boolean;
1115
+ /**
1116
+ * 是否禁止换行
1117
+ */
1118
+ noWrap: boolean;
1119
+ /**
1120
+ * 是否行间分割线
1121
+ */
1122
+ rowDividers: boolean;
1123
+ };
1124
+ /**
1125
+ * Table 属性
1126
+ */
1127
+ type TableProps = TableHTMLAttributes<HTMLTableElement> & {
1128
+ /**
1129
+ * 视觉变体(默认 'default')
1130
+ */
1131
+ variant?: TableVariant;
1132
+ /**
1133
+ * 尺寸档位(默认 'md')
1134
+ */
1135
+ size?: TableSize;
1136
+ /**
1137
+ * 滚动容器附加类名
1138
+ */
1139
+ containerClassName?: string;
1140
+ /**
1141
+ * 是否条纹行(默认 false)
1142
+ */
1143
+ striped?: boolean;
1144
+ /**
1145
+ * 是否交互行(默认 true)
1146
+ */
1147
+ interactive?: boolean;
1148
+ /**
1149
+ * 是否粘性表头(默认 false)
1150
+ */
1151
+ stickyHeader?: boolean;
1152
+ /**
1153
+ * 是否粘性首列(默认 false)
1154
+ */
1155
+ stickyFirstColumn?: boolean;
1156
+ /**
1157
+ * 是否网格分割线(默认 false)
1158
+ */
1159
+ grid?: boolean;
1160
+ /**
1161
+ * 是否禁止换行(默认 false)
1162
+ */
1163
+ noWrap?: boolean;
1164
+ /**
1165
+ * 是否行间分割线(默认 true)
1166
+ */
1167
+ rowDividers?: boolean;
1168
+ /**
1169
+ * 布局算法(默认 'auto')
1170
+ */
1171
+ layout?: TableLayout;
1172
+ /**
1173
+ * 表格元素 ref(React 19 ref-as-prop)
1174
+ */
1175
+ ref?: Ref<HTMLTableElement>;
1176
+ };
1177
+ /**
1178
+ * Table:表格根(渲染滚动容器并经上下文下发选项)
1179
+ *
1180
+ * @param props - 组件属性
1181
+ * @returns 表格 JSX
1182
+ */
1183
+ declare function Table(props: TableProps): import("react").JSX.Element;
1184
+ /**
1185
+ * TableHeader 属性
1186
+ */
1187
+ type TableHeaderProps = HTMLAttributes<HTMLTableSectionElement> & {
1188
+ /**
1189
+ * 表头区块 ref
1190
+ */
1191
+ ref?: Ref<HTMLTableSectionElement>;
1192
+ };
1193
+ /**
1194
+ * TableHeader:表头区块(配合 stickyHeader 粘性吸顶)
1195
+ *
1196
+ * @param props - 组件属性
1197
+ * @returns 表头 JSX
1198
+ */
1199
+ declare function TableHeader(props: TableHeaderProps): import("react").JSX.Element;
1200
+ /**
1201
+ * TableBody 属性
1202
+ */
1203
+ type TableBodyProps = HTMLAttributes<HTMLTableSectionElement> & {
1204
+ /**
1205
+ * 表体区块 ref
1206
+ */
1207
+ ref?: Ref<HTMLTableSectionElement>;
1208
+ };
1209
+ /**
1210
+ * TableBody:表体区块
1211
+ *
1212
+ * @param props - 组件属性
1213
+ * @returns 表体 JSX
1214
+ */
1215
+ declare function TableBody(props: TableBodyProps): import("react").JSX.Element;
1216
+ /**
1217
+ * TableFooter 属性
1218
+ */
1219
+ type TableFooterProps = HTMLAttributes<HTMLTableSectionElement> & {
1220
+ /**
1221
+ * 表脚区块 ref
1222
+ */
1223
+ ref?: Ref<HTMLTableSectionElement>;
1224
+ };
1225
+ /**
1226
+ * TableFooter:表脚区块
1227
+ *
1228
+ * @param props - 组件属性
1229
+ * @returns 表脚 JSX
1230
+ */
1231
+ declare function TableFooter(props: TableFooterProps): import("react").JSX.Element;
1232
+ /**
1233
+ * TableRow 属性
1234
+ */
1235
+ type TableRowProps = HTMLAttributes<HTMLTableRowElement> & {
1236
+ /**
1237
+ * 行色调(默认 'default')
1238
+ */
1239
+ tone?: TableRowTone;
1240
+ /**
1241
+ * 行元素 ref
1242
+ */
1243
+ ref?: Ref<HTMLTableRowElement>;
1244
+ };
1245
+ /**
1246
+ * TableRow:数据行(支持色调与选中态)
1247
+ *
1248
+ * @param props - 组件属性
1249
+ * @returns 数据行 JSX
1250
+ */
1251
+ declare function TableRow(props: TableRowProps): import("react").JSX.Element;
1252
+ /**
1253
+ * TableHead 属性
1254
+ */
1255
+ type TableHeadProps = ThHTMLAttributes<HTMLTableCellElement> & {
1256
+ /**
1257
+ * 水平对齐(默认 'left')
1258
+ */
1259
+ align?: TableAlign;
1260
+ /**
1261
+ * 是否粘性首列(默认 false)
1262
+ */
1263
+ sticky?: boolean;
1264
+ /**
1265
+ * 表头单元格 ref
1266
+ */
1267
+ ref?: Ref<HTMLTableCellElement>;
1268
+ };
1269
+ /**
1270
+ * TableHead:表头单元格(尺寸经上下文下发)
1271
+ *
1272
+ * @param props - 组件属性
1273
+ * @returns 表头单元格 JSX
1274
+ */
1275
+ declare function TableHead(props: TableHeadProps): import("react").JSX.Element;
1276
+ /**
1277
+ * TableCell 属性
1278
+ */
1279
+ type TableCellProps = TdHTMLAttributes<HTMLTableCellElement> & {
1280
+ /**
1281
+ * 水平对齐(默认 'left')
1282
+ */
1283
+ align?: TableAlign;
1284
+ /**
1285
+ * 是否截断溢出文本(默认 false)
1286
+ */
1287
+ truncate?: boolean;
1288
+ /**
1289
+ * 是否粘性首列(默认 false)
1290
+ */
1291
+ sticky?: boolean;
1292
+ /**
1293
+ * 数据单元格 ref
1294
+ */
1295
+ ref?: Ref<HTMLTableCellElement>;
1296
+ };
1297
+ /**
1298
+ * TableCell:数据单元格(尺寸经上下文下发)
1299
+ *
1300
+ * @param props - 组件属性
1301
+ * @returns 数据单元格 JSX
1302
+ */
1303
+ declare function TableCell(props: TableCellProps): import("react").JSX.Element;
1304
+ /**
1305
+ * TableCaption 属性
1306
+ */
1307
+ type TableCaptionProps = HTMLAttributes<HTMLTableCaptionElement> & {
1308
+ /**
1309
+ * 题注 ref
1310
+ */
1311
+ ref?: Ref<HTMLTableCaptionElement>;
1312
+ };
1313
+ /**
1314
+ * TableCaption:表格题注
1315
+ *
1316
+ * @param props - 组件属性
1317
+ * @returns 题注 JSX
1318
+ */
1319
+ declare function TableCaption(props: TableCaptionProps): import("react").JSX.Element;
1320
+ /**
1321
+ * TableEmpty 属性
1322
+ */
1323
+ type TableEmptyProps = {
1324
+ /**
1325
+ * 跨越的列数
1326
+ */
1327
+ colSpan: number;
1328
+ /**
1329
+ * 空态文案(默认 'No results.')
1330
+ */
1331
+ children?: ReactNode;
1332
+ };
1333
+ /**
1334
+ * TableEmpty:空态占位行
1335
+ *
1336
+ * @param props - 组件属性
1337
+ * @returns 空态行 JSX
1338
+ */
1339
+ declare function TableEmpty(props: TableEmptyProps): import("react").JSX.Element;
1340
+ //#endregion
1341
+ //#region src/data-table.d.ts
1342
+ /**
1343
+ * 排序状态(列标识 + 方向)
1344
+ */
1345
+ type DataTableSortState = {
1346
+ direction: 'asc' | 'desc';
1347
+ id: string;
1348
+ };
1349
+ /**
1350
+ * 列取值器(字段键或取值函数)
1351
+ *
1352
+ * @typeParam TData - 行数据类型
1353
+ */
1354
+ type DataTableAccessor<TData> = keyof TData | ((row: TData) => unknown);
1355
+ /**
1356
+ * 自定义单元格渲染上下文
1357
+ *
1358
+ * @typeParam TData - 行数据类型
1359
+ */
1360
+ type DataTableCellContext<TData> = {
1361
+ row: TData;
1362
+ rowId: string;
1363
+ value: unknown;
1364
+ };
1365
+ /**
1366
+ * 列定义
1367
+ *
1368
+ * @typeParam TData - 行数据类型
1369
+ */
1370
+ type DataTableColumn<TData> = {
1371
+ /**
1372
+ * 列标识(排序/显隐的键)
1373
+ */
1374
+ id: string;
1375
+ /**
1376
+ * 表头内容
1377
+ */
1378
+ header: ReactNode;
1379
+ /**
1380
+ * 取值器(字段键或取值函数)
1381
+ */
1382
+ accessor: DataTableAccessor<TData>;
1383
+ /**
1384
+ * 自定义单元格渲染器(缺省按值渲染)
1385
+ */
1386
+ cell?: (context: DataTableCellContext<TData>) => ReactNode;
1387
+ /**
1388
+ * 是否可排序(默认 true)
1389
+ */
1390
+ sortable?: boolean;
1391
+ /**
1392
+ * 是否参与搜索(默认 true)
1393
+ */
1394
+ searchable?: boolean;
1395
+ /**
1396
+ * 是否允许在列菜单中隐藏(默认 true)
1397
+ */
1398
+ canHide?: boolean;
1399
+ /**
1400
+ * 初始是否隐藏(默认 false)
1401
+ */
1402
+ hidden?: boolean;
1403
+ /**
1404
+ * 水平对齐(默认 'left')
1405
+ */
1406
+ align?: TableAlign;
1407
+ /**
1408
+ * 数据单元格附加类名
1409
+ */
1410
+ className?: string;
1411
+ /**
1412
+ * 表头单元格附加类名
1413
+ */
1414
+ headerClassName?: string;
1415
+ };
1416
+ /**
1417
+ * 行数据约束(字符串键的对象)
1418
+ */
1419
+ type DataTableRecord = Record<string, unknown>;
1420
+ /**
1421
+ * 行标识解析器
1422
+ *
1423
+ * @typeParam TData - 行数据类型
1424
+ */
1425
+ type DataTableGetRowId<TData> = (row: TData, index: number) => string;
1426
+ /**
1427
+ * 选中行集合变更回调
1428
+ *
1429
+ * @typeParam TData - 行数据类型
1430
+ */
1431
+ type DataTableSelectionChangeHandler<TData> = (rows: TData[]) => void;
1432
+ /**
1433
+ * DataTable 属性
1434
+ *
1435
+ * @typeParam TData - 行数据类型
1436
+ */
1437
+ type DataTableProps<TData extends DataTableRecord> = Omit<TableProps, 'children'> & {
1438
+ /**
1439
+ * 列定义列表
1440
+ */
1441
+ columns: DataTableColumn<TData>[];
1442
+ /**
1443
+ * 数据行列表
1444
+ */
1445
+ data: TData[];
1446
+ /**
1447
+ * 行标识解析器(缺省用行下标)
1448
+ */
1449
+ getRowId?: DataTableGetRowId<TData>;
1450
+ /**
1451
+ * 行色调解析器
1452
+ */
1453
+ rowTone?: (row: TData) => TableRowTone;
1454
+ /**
1455
+ * 行点击回调
1456
+ */
1457
+ onRowClick?: (row: TData) => void;
1458
+ /**
1459
+ * 选中行集合变更回调
1460
+ */
1461
+ onSelectionChange?: DataTableSelectionChangeHandler<TData>;
1462
+ /**
1463
+ * 是否启用搜索(默认 true)
1464
+ */
1465
+ searchable?: boolean;
1466
+ /**
1467
+ * 搜索输入占位文案
1468
+ */
1469
+ searchPlaceholder?: string;
1470
+ /**
1471
+ * 是否启用行选择(默认 false)
1472
+ */
1473
+ selectable?: boolean;
1474
+ /**
1475
+ * 每页行数(默认 10)
1476
+ */
1477
+ pageSize?: number;
1478
+ /**
1479
+ * 每页行数选项(默认 [10, 20, 50])
1480
+ */
1481
+ pageSizeOptions?: number[];
1482
+ /**
1483
+ * 空态文案
1484
+ */
1485
+ emptyMessage?: string;
1486
+ /**
1487
+ * 根节点附加类名
1488
+ */
1489
+ className?: string;
1490
+ };
1491
+ /**
1492
+ * DataTable:泛型数据表格(工具栏 + 表格 + 分页,含排序/搜索/行选择/列显隐)
1493
+ *
1494
+ * @typeParam TData - 行数据类型
1495
+ * @param props - 组件属性
1496
+ * @returns 数据表格 JSX
1497
+ */
1498
+ declare function DataTable<TData extends DataTableRecord>(props: DataTableProps<TData>): import("react").JSX.Element;
1499
+ //#endregion
1500
+ //#region src/depth-card.d.ts
1501
+ /**
1502
+ * DepthCard 属性
1503
+ */
1504
+ type DepthCardProps = Omit<HTMLAttributes<HTMLDivElement>, 'children'> & {
1505
+ /**
1506
+ * 最大倾角(deg,默认 15)
1507
+ */
1508
+ maxTilt?: number;
1509
+ /**
1510
+ * 透视距离(px,默认 800)
1511
+ */
1512
+ perspective?: number;
1513
+ /**
1514
+ * 悬停缩放倍率(默认 1.02)
1515
+ */
1516
+ hoverScale?: number;
1517
+ /**
1518
+ * 是否启用眩光层(默认 true)
1519
+ */
1520
+ glare?: boolean;
1521
+ /**
1522
+ * 眩光最大不透明度(默认 0.2)
1523
+ */
1524
+ glareOpacity?: number;
1525
+ /**
1526
+ * 卡片内容
1527
+ */
1528
+ children?: ReactNode;
1529
+ };
1530
+ /**
1531
+ * DepthCard:视差倾斜分层玻璃卡片
1532
+ *
1533
+ * @param props - 组件属性
1534
+ * @returns 卡片 JSX
1535
+ */
1536
+ declare function DepthCard(props: DepthCardProps): import("react").JSX.Element;
1537
+ //#endregion
1538
+ //#region src/dot-pattern.d.ts
1539
+ /**
1540
+ * DotPattern 属性
1541
+ */
1542
+ type DotPatternProps = SVGAttributes<SVGSVGElement> & {
1543
+ /**
1544
+ * 点半径基准(默认 1.5)
1545
+ */
1546
+ dotSize?: number;
1547
+ /**
1548
+ * 平铺间距(默认 20)
1549
+ */
1550
+ gap?: number;
1551
+ /**
1552
+ * 点填充色(默认 currentColor)
1553
+ */
1554
+ dotColor?: string;
1555
+ /**
1556
+ * 点不透明度(默认 0.2)
1557
+ */
1558
+ dotOpacity?: number;
1559
+ /**
1560
+ * 覆写点半径(默认取 dotSize)
1561
+ */
1562
+ cr?: number;
1563
+ /**
1564
+ * 图案 ref(React 19 ref-as-prop)
1565
+ */
1566
+ ref?: Ref<SVGSVGElement>;
1567
+ };
1568
+ /**
1569
+ * DotPattern:平铺点阵背景图案
1570
+ *
1571
+ * @param props - 组件属性
1572
+ * @returns 点阵 SVG JSX
1573
+ */
1574
+ declare function DotPattern(props: DotPatternProps): import("react").JSX.Element;
1575
+ //#endregion
1576
+ //#region src/dropdown-menu.d.ts
1577
+ /**
1578
+ * 下拉菜单玻璃变体(触发器与内容共用)
1579
+ */
1580
+ type DropdownMenuVariant = 'default' | 'frosted' | 'glass' | 'ghost' | 'outline';
1581
+ /**
1582
+ * 下拉菜单尺寸
1583
+ */
1584
+ type DropdownMenuSize = 'lg' | 'md' | 'sm';
1585
+ /**
1586
+ * DropdownMenu:下拉菜单根
1587
+ */
1588
+ declare const DropdownMenu: import("react").FC<DropdownMenuPrimitive.DropdownMenuProps>;
1589
+ /**
1590
+ * DropdownMenuTrigger 属性
1591
+ */
1592
+ type DropdownMenuTriggerProps = ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Trigger> & {
1593
+ /**
1594
+ * 视觉变体(默认 'default')
1595
+ */
1596
+ variant?: DropdownMenuVariant;
1597
+ /**
1598
+ * 尺寸档位(默认 'md')
1599
+ */
1600
+ size?: DropdownMenuSize;
1601
+ /**
1602
+ * 触发器 ref
1603
+ */
1604
+ ref?: Ref<HTMLButtonElement>;
1605
+ };
1606
+ /**
1607
+ * DropdownMenuTrigger:触发器按钮
1608
+ *
1609
+ * @param props - 组件属性
1610
+ * @returns 触发器 JSX
1611
+ */
1612
+ declare function DropdownMenuTrigger(props: DropdownMenuTriggerProps): import("react").JSX.Element;
1613
+ /**
1614
+ * DropdownMenuContent 属性
1615
+ */
1616
+ type DropdownMenuContentProps = ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Content> & {
1617
+ /**
1618
+ * 视觉变体(默认 'default')
1619
+ */
1620
+ variant?: DropdownMenuVariant;
1621
+ /**
1622
+ * 尺寸档位(默认 'md')
1623
+ */
1624
+ size?: DropdownMenuSize;
1625
+ /**
1626
+ * 内容面板 ref
1627
+ */
1628
+ ref?: Ref<HTMLDivElement>;
1629
+ };
1630
+ /**
1631
+ * DropdownMenuContent:内容面板(portal 挂载)
1632
+ *
1633
+ * @param props - 组件属性
1634
+ * @returns 内容面板 JSX
1635
+ */
1636
+ declare function DropdownMenuContent(props: DropdownMenuContentProps): import("react").JSX.Element;
1637
+ /**
1638
+ * DropdownMenuItem 属性
1639
+ */
1640
+ type DropdownMenuItemProps = ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Item> & {
1641
+ /**
1642
+ * 左缩进(为指示器留位)
1643
+ */
1644
+ inset?: boolean;
1645
+ /**
1646
+ * 菜单项 ref
1647
+ */
1648
+ ref?: Ref<HTMLDivElement>;
1649
+ };
1650
+ /**
1651
+ * DropdownMenuItem:菜单项
1652
+ *
1653
+ * @param props - 组件属性
1654
+ * @returns 菜单项 JSX
1655
+ */
1656
+ declare function DropdownMenuItem(props: DropdownMenuItemProps): import("react").JSX.Element;
1657
+ /**
1658
+ * DropdownMenuCheckboxItem 属性
1659
+ */
1660
+ type DropdownMenuCheckboxItemProps = ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.CheckboxItem> & {
1661
+ /**
1662
+ * 菜单项 ref
1663
+ */
1664
+ ref?: Ref<HTMLDivElement>;
1665
+ };
1666
+ /**
1667
+ * DropdownMenuCheckboxItem:复选菜单项(带勾选指示器)
1668
+ *
1669
+ * @param props - 组件属性
1670
+ * @returns 菜单项 JSX
1671
+ */
1672
+ declare function DropdownMenuCheckboxItem(props: DropdownMenuCheckboxItemProps): import("react").JSX.Element;
1673
+ /**
1674
+ * DropdownMenuRadioGroup:单选组
1675
+ */
1676
+ declare const DropdownMenuRadioGroup: import("react").ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuRadioGroupProps & import("react").RefAttributes<HTMLDivElement>>;
1677
+ /**
1678
+ * DropdownMenuRadioItem 属性
1679
+ */
1680
+ type DropdownMenuRadioItemProps = ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.RadioItem> & {
1681
+ /**
1682
+ * 菜单项 ref
1683
+ */
1684
+ ref?: Ref<HTMLDivElement>;
1685
+ };
1686
+ /**
1687
+ * DropdownMenuRadioItem:单选菜单项(带圆点指示器)
1688
+ *
1689
+ * @param props - 组件属性
1690
+ * @returns 菜单项 JSX
1691
+ */
1692
+ declare function DropdownMenuRadioItem(props: DropdownMenuRadioItemProps): import("react").JSX.Element;
1693
+ /**
1694
+ * DropdownMenuLabel 属性
1695
+ */
1696
+ type DropdownMenuLabelProps = ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Label> & {
1697
+ /**
1698
+ * 左缩进(与 inset 项对齐)
1699
+ */
1700
+ inset?: boolean;
1701
+ /**
1702
+ * 标签 ref
1703
+ */
1704
+ ref?: Ref<HTMLDivElement>;
1705
+ };
1706
+ /**
1707
+ * DropdownMenuLabel:菜单分组标签
1708
+ *
1709
+ * @param props - 组件属性
1710
+ * @returns 标签 JSX
1711
+ */
1712
+ declare function DropdownMenuLabel(props: DropdownMenuLabelProps): import("react").JSX.Element;
1713
+ /**
1714
+ * DropdownMenuSeparator 属性
1715
+ */
1716
+ type DropdownMenuSeparatorProps = ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Separator> & {
1717
+ /**
1718
+ * 分隔线 ref
1719
+ */
1720
+ ref?: Ref<HTMLDivElement>;
1721
+ };
1722
+ /**
1723
+ * DropdownMenuSeparator:菜单分隔线
1724
+ *
1725
+ * @param props - 组件属性
1726
+ * @returns 分隔线 JSX
1727
+ */
1728
+ declare function DropdownMenuSeparator(props: DropdownMenuSeparatorProps): import("react").JSX.Element;
1729
+ /**
1730
+ * DropdownMenuShortcut 属性
1731
+ */
1732
+ type DropdownMenuShortcutProps = ComponentPropsWithoutRef<'span'>;
1733
+ /**
1734
+ * DropdownMenuShortcut:菜单项快捷键提示
1735
+ *
1736
+ * @param props - 组件属性
1737
+ * @returns 提示 JSX
1738
+ */
1739
+ declare function DropdownMenuShortcut(props: DropdownMenuShortcutProps): import("react").JSX.Element;
1740
+ /**
1741
+ * DropdownMenuSub:子菜单根
1742
+ */
1743
+ declare const DropdownMenuSub: import("react").FC<DropdownMenuPrimitive.DropdownMenuSubProps>;
1744
+ /**
1745
+ * DropdownMenuSubTrigger 属性
1746
+ */
1747
+ type DropdownMenuSubTriggerProps = ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.SubTrigger> & {
1748
+ /**
1749
+ * 左缩进
1750
+ */
1751
+ inset?: boolean;
1752
+ /**
1753
+ * 子菜单触发器 ref
1754
+ */
1755
+ ref?: Ref<HTMLDivElement>;
1756
+ };
1757
+ /**
1758
+ * DropdownMenuSubTrigger:子菜单触发项(尾部箭头)
1759
+ *
1760
+ * @param props - 组件属性
1761
+ * @returns 触发项 JSX
1762
+ */
1763
+ declare function DropdownMenuSubTrigger(props: DropdownMenuSubTriggerProps): import("react").JSX.Element;
1764
+ /**
1765
+ * DropdownMenuSubContent 属性
1766
+ */
1767
+ type DropdownMenuSubContentProps = ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.SubContent> & {
1768
+ /**
1769
+ * 视觉变体(默认 'default')
1770
+ */
1771
+ variant?: DropdownMenuVariant;
1772
+ /**
1773
+ * 尺寸档位(默认 'md')
1774
+ */
1775
+ size?: DropdownMenuSize;
1776
+ /**
1777
+ * 子菜单面板 ref
1778
+ */
1779
+ ref?: Ref<HTMLDivElement>;
1780
+ };
1781
+ /**
1782
+ * DropdownMenuSubContent:子菜单内容面板
1783
+ *
1784
+ * @param props - 组件属性
1785
+ * @returns 面板 JSX
1786
+ */
1787
+ declare function DropdownMenuSubContent(props: DropdownMenuSubContentProps): import("react").JSX.Element;
1788
+ //#endregion
1789
+ //#region src/floating-panel.d.ts
1790
+ /**
1791
+ * FloatingPanel 属性
1792
+ */
1793
+ type FloatingPanelProps = Omit<HTMLAttributes<HTMLDivElement>, 'children'> & {
1794
+ /**
1795
+ * 是否启用拖拽(默认 true)
1796
+ */
1797
+ draggable?: boolean;
1798
+ /**
1799
+ * 初始横坐标(px)
1800
+ */
1801
+ defaultX?: number;
1802
+ /**
1803
+ * 初始纵坐标(px)
1804
+ */
1805
+ defaultY?: number;
1806
+ /**
1807
+ * 面板宽度(默认 320)
1808
+ */
1809
+ width?: number | string;
1810
+ /**
1811
+ * 是否显示关闭按钮(默认 false)
1812
+ */
1813
+ closable?: boolean;
1814
+ /**
1815
+ * 关闭回调
1816
+ */
1817
+ onClose?: () => void;
1818
+ /**
1819
+ * 面板内容
1820
+ */
1821
+ children?: ReactNode;
1822
+ };
1823
+ /**
1824
+ * FloatingPanel:可拖拽玻璃面板
1825
+ *
1826
+ * @param props - 组件属性
1827
+ * @returns 面板 JSX
1828
+ */
1829
+ declare function FloatingPanel(props: FloatingPanelProps): import("react").JSX.Element;
1830
+ //#endregion
1831
+ //#region src/glass-breadcrumb.d.ts
1832
+ /**
1833
+ * 面包屑项
1834
+ */
1835
+ type GlassBreadcrumbItem = {
1836
+ /**
1837
+ * 项标识(作 key)
1838
+ */
1839
+ id: string;
1840
+ /**
1841
+ * 项文本
1842
+ */
1843
+ label: ReactNode;
1844
+ /**
1845
+ * 链接地址(缺省渲染为按钮)
1846
+ */
1847
+ href?: string;
1848
+ /**
1849
+ * 点击回调
1850
+ */
1851
+ onClick?: () => void;
1852
+ };
1853
+ /**
1854
+ * GlassBreadcrumb 属性
1855
+ */
1856
+ type GlassBreadcrumbProps = Omit<HTMLAttributes<HTMLElement>, 'children'> & {
1857
+ /**
1858
+ * 面包屑项列表
1859
+ */
1860
+ items: GlassBreadcrumbItem[];
1861
+ /**
1862
+ * 分隔符(默认 '/')
1863
+ */
1864
+ separator?: ReactNode;
1865
+ /**
1866
+ * 最大可见项数(超出部分折叠为省略号)
1867
+ */
1868
+ maxItems?: number;
1869
+ };
1870
+ /**
1871
+ * GlassBreadcrumb:胶囊玻璃面包屑
1872
+ *
1873
+ * @param props - 组件属性
1874
+ * @returns 面包屑 JSX
1875
+ */
1876
+ declare function GlassBreadcrumb(props: GlassBreadcrumbProps): import("react").JSX.Element;
1877
+ //#endregion
1878
+ //#region src/glass-card.d.ts
1879
+ /**
1880
+ * 卡片尺寸
1881
+ */
1882
+ type GlassCardSize = 'lg' | 'md' | 'sm';
1883
+ /**
1884
+ * GlassCard 属性
1885
+ */
1886
+ type GlassCardProps = HTMLAttributes<HTMLDivElement> & {
1887
+ /**
1888
+ * CSS 海拔层级(默认 '3',悬停自动升一档)
1889
+ */
1890
+ elevation?: GlassElevationLevel;
1891
+ /**
1892
+ * 内边距档位(默认 'md')
1893
+ */
1894
+ size?: GlassCardSize;
1895
+ /**
1896
+ * 卡片内容
1897
+ */
1898
+ children?: ReactNode;
1899
+ /**
1900
+ * 卡片 ref(React 19 ref-as-prop)
1901
+ */
1902
+ ref?: Ref<HTMLDivElement>;
1903
+ /**
1904
+ * 引擎预设(声明时切换为多后端渲染引擎路径,需安装 react 适配层)
1905
+ */
1906
+ engine?: GlassPresetId;
1907
+ };
1908
+ /**
1909
+ * GlassCard:海拔分级玻璃卡片
1910
+ *
1911
+ * @param props - 组件属性
1912
+ * @returns 卡片 JSX
1913
+ */
1914
+ declare function GlassCard(props: GlassCardProps): import("react").JSX.Element;
1915
+ /**
1916
+ * GlassCard 组合子属性
1917
+ */
1918
+ type GlassCardSectionProps = HTMLAttributes<HTMLDivElement> & {
1919
+ /**
1920
+ * 区块内容
1921
+ */
1922
+ children?: ReactNode;
1923
+ };
1924
+ /**
1925
+ * GlassCardHeader:卡片头部区块
1926
+ *
1927
+ * @param props - 组件属性
1928
+ * @returns 区块 JSX
1929
+ */
1930
+ declare function GlassCardHeader(props: GlassCardSectionProps): import("react").JSX.Element;
1931
+ /**
1932
+ * GlassCardContent:卡片内容区块
1933
+ *
1934
+ * @param props - 组件属性
1935
+ * @returns 区块 JSX
1936
+ */
1937
+ declare function GlassCardContent(props: GlassCardSectionProps): import("react").JSX.Element;
1938
+ /**
1939
+ * GlassCardFooter:卡片底部区块
1940
+ *
1941
+ * @param props - 组件属性
1942
+ * @returns 区块 JSX
1943
+ */
1944
+ declare function GlassCardFooter(props: GlassCardSectionProps): import("react").JSX.Element;
1945
+ //#endregion
1946
+ //#region src/glass-navbar.d.ts
1947
+ /**
1948
+ * 导航栏海拔状态
1949
+ */
1950
+ type GlassNavbarElevation = 'base' | 'scrolled';
1951
+ /**
1952
+ * 导航栏尺寸
1953
+ */
1954
+ type GlassNavbarSize = 'lg' | 'md' | 'sm';
1955
+ /**
1956
+ * GlassNavbar 属性
1957
+ */
1958
+ type GlassNavbarProps = Omit<HTMLAttributes<HTMLElement>, 'children'> & {
1959
+ /**
1960
+ * 导航内容
1961
+ */
1962
+ children?: ReactNode;
1963
+ /**
1964
+ * 受控海拔状态(不传则按滚动自动切换)
1965
+ */
1966
+ elevation?: GlassNavbarElevation;
1967
+ /**
1968
+ * 滚动判定阈值(px,默认 8)
1969
+ */
1970
+ scrollThreshold?: number;
1971
+ /**
1972
+ * 禁用滚动跟踪(保持 base 海拔)
1973
+ */
1974
+ disableScrollTracking?: boolean;
1975
+ /**
1976
+ * 高度档位(默认 'md')
1977
+ */
1978
+ size?: GlassNavbarSize;
1979
+ };
1980
+ /**
1981
+ * GlassNavbar:滚动响应式玻璃导航栏
1982
+ *
1983
+ * @param props - 组件属性
1984
+ * @returns 导航 JSX
1985
+ */
1986
+ declare function GlassNavbar(props: GlassNavbarProps): import("react").JSX.Element;
1987
+ //#endregion
1988
+ //#region src/glass-toggle.d.ts
1989
+ /**
1990
+ * 开关尺寸
1991
+ */
1992
+ type GlassToggleSize = 'lg' | 'md' | 'sm';
1993
+ /**
1994
+ * GlassToggle 属性
1995
+ */
1996
+ type GlassToggleProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange'> & {
1997
+ /**
1998
+ * 受控选中态
1999
+ */
2000
+ checked?: boolean;
2001
+ /**
2002
+ * 非受控初始选中态(默认 false)
2003
+ */
2004
+ defaultChecked?: boolean;
2005
+ /**
2006
+ * 选中态变化回调
2007
+ */
2008
+ onCheckedChange?: (checked: boolean) => void;
2009
+ /**
2010
+ * 尺寸档位(默认 'md')
2011
+ */
2012
+ size?: GlassToggleSize;
2013
+ /**
2014
+ * 自定义选中色(CSS 颜色值)
2015
+ */
2016
+ activeColor?: string;
2017
+ };
2018
+ /**
2019
+ * GlassToggle:液态填充玻璃开关
2020
+ *
2021
+ * @param props - 组件属性
2022
+ * @returns 开关 JSX
2023
+ */
2024
+ declare function GlassToggle(props: GlassToggleProps): import("react").JSX.Element;
2025
+ //#endregion
2026
+ //#region src/glow-border.d.ts
2027
+ /**
2028
+ * GlowBorder 属性
2029
+ */
2030
+ type GlowBorderProps = HTMLAttributes<HTMLDivElement> & {
2031
+ /**
2032
+ * 旋转周期(秒,默认 4)
2033
+ */
2034
+ duration?: number;
2035
+ /**
2036
+ * 辉光颜色(默认 var(--color-accent))
2037
+ */
2038
+ glowColor?: string;
2039
+ /**
2040
+ * 辉光扩散(px,默认 2)
2041
+ */
2042
+ glowSize?: number;
2043
+ /**
2044
+ * 圆角(默认 var(--radius-lg))
2045
+ */
2046
+ borderRadius?: string;
2047
+ /**
2048
+ * 包裹的内容
2049
+ */
2050
+ children?: ReactNode;
2051
+ /**
2052
+ * 容器 ref(React 19 ref-as-prop)
2053
+ */
2054
+ ref?: Ref<HTMLDivElement>;
2055
+ };
2056
+ /**
2057
+ * GlowBorder:旋转辉光边框容器
2058
+ *
2059
+ * @param props - 组件属性
2060
+ * @returns 辉光边框 JSX
2061
+ */
2062
+ declare function GlowBorder(props: GlowBorderProps): import("react").JSX.Element;
2063
+ //#endregion
2064
+ //#region src/gradient-mesh.d.ts
2065
+ /**
2066
+ * GradientMesh 属性
2067
+ */
2068
+ type GradientMeshProps = HTMLAttributes<HTMLDivElement> & {
2069
+ /**
2070
+ * 渐变配色(每色一层)
2071
+ */
2072
+ colors?: string[];
2073
+ /**
2074
+ * 基础动画周期(秒,默认 10,逐层递增 2)
2075
+ */
2076
+ duration?: number;
2077
+ /**
2078
+ * 模糊强度(px,默认 60)
2079
+ */
2080
+ blur?: number;
2081
+ /**
2082
+ * 整体强度/不透明度 0-1(默认 0.6)
2083
+ */
2084
+ intensity?: number;
2085
+ /**
2086
+ * 叠加层之上的内容
2087
+ */
2088
+ children?: ReactNode;
2089
+ /**
2090
+ * 叠加层 ref(React 19 ref-as-prop)
2091
+ */
2092
+ ref?: Ref<HTMLDivElement>;
2093
+ };
2094
+ /**
2095
+ * GradientMesh:多层渐变网格氛围背景
2096
+ *
2097
+ * @param props - 组件属性
2098
+ * @returns 渐变网格 JSX
2099
+ */
2100
+ declare function GradientMesh(props: GradientMeshProps): import("react").JSX.Element;
2101
+ //#endregion
2102
+ //#region src/heading.d.ts
2103
+ /**
2104
+ * 标题层级
2105
+ */
2106
+ type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
2107
+ /**
2108
+ * Heading 属性
2109
+ */
2110
+ type HeadingProps = HTMLAttributes<HTMLHeadingElement> & {
2111
+ /**
2112
+ * 语义层级(默认 2)
2113
+ */
2114
+ level?: HeadingLevel;
2115
+ /**
2116
+ * 标题内容
2117
+ */
2118
+ children?: ReactNode;
2119
+ };
2120
+ /**
2121
+ * Heading:语义标题
2122
+ *
2123
+ * @param props - 组件属性
2124
+ * @returns 标题 JSX
2125
+ */
2126
+ declare function Heading(props: HeadingProps): import("react").JSX.Element;
2127
+ //#endregion
2128
+ //#region src/hover-card.d.ts
2129
+ /**
2130
+ * HoverCard:悬停卡片根
2131
+ */
2132
+ declare const HoverCard: import("react").FC<HoverCardPrimitive.HoverCardProps>;
2133
+ /**
2134
+ * HoverCardTrigger:悬停触发器
2135
+ */
2136
+ declare const HoverCardTrigger: import("react").ForwardRefExoticComponent<HoverCardPrimitive.HoverCardTriggerProps & import("react").RefAttributes<HTMLAnchorElement>>;
2137
+ /**
2138
+ * HoverCardContent 属性
2139
+ */
2140
+ type HoverCardContentProps = ComponentPropsWithoutRef<typeof HoverCardPrimitive.Content> & {
2141
+ /**
2142
+ * 内容 ref
2143
+ */
2144
+ ref?: Ref<HTMLDivElement>;
2145
+ };
2146
+ /**
2147
+ * HoverCardContent:悬停预览面板(portal 挂载)
2148
+ *
2149
+ * @param props - 组件属性
2150
+ * @returns 面板 JSX
2151
+ */
2152
+ declare function HoverCardContent(props: HoverCardContentProps): import("react").JSX.Element;
2153
+ //#endregion
2154
+ //#region src/icon-frame.d.ts
2155
+ /**
2156
+ * 图标框尺寸
2157
+ */
2158
+ type IconFrameSize = 'lg' | 'md' | 'sm' | 'xl';
2159
+ /**
2160
+ * IconFrame 属性
2161
+ */
2162
+ type IconFrameProps = HTMLAttributes<HTMLSpanElement> & {
2163
+ /**
2164
+ * 尺寸档位(默认 'md')
2165
+ */
2166
+ size?: IconFrameSize;
2167
+ /**
2168
+ * 是否圆形(默认 false 圆角方形)
2169
+ */
2170
+ circle?: boolean;
2171
+ /**
2172
+ * 图标内容
2173
+ */
2174
+ children?: ReactNode;
2175
+ };
2176
+ /**
2177
+ * IconFrame:图标玻璃容器
2178
+ *
2179
+ * @param props - 组件属性
2180
+ * @returns 图标框 JSX
2181
+ */
2182
+ declare function IconFrame(props: IconFrameProps): import("react").JSX.Element;
2183
+ //#endregion
2184
+ //#region src/input.d.ts
2185
+ /**
2186
+ * 输入框视觉变体
2187
+ */
2188
+ type InputVariant = 'default' | 'filled' | 'frosted' | 'ghost' | 'glass' | 'liquid' | 'matte' | 'outline' | 'underline';
2189
+ /**
2190
+ * 输入框尺寸
2191
+ */
2192
+ type InputSize = 'lg' | 'md' | 'sm';
2193
+ /**
2194
+ * Input 属性
2195
+ */
2196
+ type InputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'size'> & {
2197
+ /**
2198
+ * 视觉变体(默认 'default')
2199
+ */
2200
+ variant?: InputVariant;
2201
+ /**
2202
+ * 尺寸档位(默认 'md')
2203
+ */
2204
+ size?: InputSize;
2205
+ };
2206
+ /**
2207
+ * Input:玻璃质感文本输入框
2208
+ *
2209
+ * @param props - 组件属性
2210
+ * @returns 输入框 JSX
2211
+ */
2212
+ declare function Input(props: InputProps): import("react").JSX.Element;
2213
+ //#endregion
2214
+ //#region src/kbd.d.ts
2215
+ /**
2216
+ * Kbd 属性
2217
+ */
2218
+ type KbdProps = HTMLAttributes<HTMLElement> & {
2219
+ /**
2220
+ * 键位内容
2221
+ */
2222
+ children?: ReactNode;
2223
+ };
2224
+ /**
2225
+ * Kbd:键位提示
2226
+ *
2227
+ * @param props - 组件属性
2228
+ * @returns 键位 JSX
2229
+ */
2230
+ declare function Kbd(props: KbdProps): import("react").JSX.Element;
2231
+ //#endregion
2232
+ //#region src/label.d.ts
2233
+ /**
2234
+ * Label 属性
2235
+ */
2236
+ type LabelProps = LabelHTMLAttributes<HTMLLabelElement> & {
2237
+ /**
2238
+ * 标签内容
2239
+ */
2240
+ children?: ReactNode;
2241
+ };
2242
+ /**
2243
+ * Label:表单标签
2244
+ *
2245
+ * @param props - 组件属性
2246
+ * @returns 标签 JSX
2247
+ */
2248
+ declare function Label(props: LabelProps): import("react").JSX.Element;
2249
+ //#endregion
2250
+ //#region src/light-leak.d.ts
2251
+ /**
2252
+ * LightLeak 属性
2253
+ */
2254
+ type LightLeakProps = HTMLAttributes<HTMLDivElement> & {
2255
+ /**
2256
+ * 漏光层数(默认 3)
2257
+ */
2258
+ count?: number;
2259
+ /**
2260
+ * 漏光颜色列表(按层循环取用)
2261
+ */
2262
+ colors?: string[];
2263
+ /**
2264
+ * 基础动画时长(秒,默认 6)
2265
+ */
2266
+ duration?: number;
2267
+ /**
2268
+ * 强度/不透明度(0–1,默认 0.3)
2269
+ */
2270
+ intensity?: number;
2271
+ /**
2272
+ * 模糊量(px,默认 60)
2273
+ */
2274
+ blur?: number;
2275
+ };
2276
+ /**
2277
+ * LightLeak:漏光漂移叠加层
2278
+ *
2279
+ * @param props - 组件属性
2280
+ * @returns 漏光 JSX
2281
+ */
2282
+ declare function LightLeak(props: LightLeakProps): import("react").JSX.Element;
2283
+ //#endregion
2284
+ //#region src/link.d.ts
2285
+ /**
2286
+ * Link 属性
2287
+ */
2288
+ type LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
2289
+ /**
2290
+ * 链接内容
2291
+ */
2292
+ children?: ReactNode;
2293
+ };
2294
+ /**
2295
+ * Link:链接
2296
+ *
2297
+ * @param props - 组件属性
2298
+ * @returns 链接 JSX
2299
+ */
2300
+ declare function Link(props: LinkProps): import("react").JSX.Element;
2301
+ //#endregion
2302
+ //#region src/liquid-button.d.ts
2303
+ /**
2304
+ * 液态强度
2305
+ */
2306
+ type LiquidButtonIntensity = 'soft' | 'strong';
2307
+ /**
2308
+ * LiquidButton 属性
2309
+ */
2310
+ type LiquidButtonProps = ButtonProps & {
2311
+ /**
2312
+ * 液态强度(默认 'soft')
2313
+ */
2314
+ intensity?: LiquidButtonIntensity;
2315
+ };
2316
+ /**
2317
+ * LiquidButton:流体悬停玻璃按钮
2318
+ *
2319
+ * @param props - 组件属性
2320
+ * @returns 按钮 JSX
2321
+ */
2322
+ declare function LiquidButton(props: LiquidButtonProps): import("react").JSX.Element;
2323
+ //#endregion
2324
+ //#region src/magnetic-cta.d.ts
2325
+ /**
2326
+ * MagneticCTA 属性
2327
+ */
2328
+ type MagneticCTAProps = ButtonProps & {
2329
+ /**
2330
+ * 包裹容器类名
2331
+ */
2332
+ containerClassName?: string;
2333
+ /**
2334
+ * 最大偏移量(px,默认 8)
2335
+ */
2336
+ maxOffset?: number;
2337
+ /**
2338
+ * 磁吸半径(px,默认 140)
2339
+ */
2340
+ magnetRadius?: number;
2341
+ };
2342
+ /**
2343
+ * MagneticCTA:光标磁吸按钮
2344
+ *
2345
+ * @param props - 组件属性
2346
+ * @returns 按钮 JSX
2347
+ */
2348
+ declare function MagneticCTA(props: MagneticCTAProps): import("react").JSX.Element;
2349
+ //#endregion
2350
+ //#region src/marquee.d.ts
2351
+ /**
2352
+ * 跑马灯方向
2353
+ */
2354
+ type MarqueeDirection = 'down' | 'left' | 'right' | 'up';
2355
+ /**
2356
+ * Marquee 属性
2357
+ */
2358
+ type MarqueeProps = HTMLAttributes<HTMLDivElement> & {
2359
+ /**
2360
+ * 滚动方向(默认 'left';'right'/'down' 天然反向)
2361
+ */
2362
+ direction?: MarqueeDirection;
2363
+ /**
2364
+ * 单轨滚动一屏耗时(秒,值越大越慢,默认 30)
2365
+ */
2366
+ speed?: number;
2367
+ /**
2368
+ * 悬停时暂停滚动(默认 false)
2369
+ */
2370
+ pauseOnHover?: boolean;
2371
+ /**
2372
+ * 相邻内容间距(px,默认 16)
2373
+ */
2374
+ gap?: number;
2375
+ /**
2376
+ * 反向滚动(默认 false)
2377
+ */
2378
+ reverse?: boolean;
2379
+ };
2380
+ /**
2381
+ * Marquee:无缝循环跑马灯
2382
+ *
2383
+ * @param props - 组件属性
2384
+ * @returns 跑马灯 JSX
2385
+ */
2386
+ declare function Marquee(props: MarqueeProps): import("react").JSX.Element;
2387
+ //#endregion
2388
+ //#region src/meteor-shower.d.ts
2389
+ /**
2390
+ * MeteorShower 属性
2391
+ */
2392
+ type MeteorShowerProps = HTMLAttributes<HTMLDivElement> & {
2393
+ /**
2394
+ * 流星数量(默认 12)
2395
+ */
2396
+ count?: number;
2397
+ /**
2398
+ * 坠落角度(deg,默认 215)
2399
+ */
2400
+ angle?: number;
2401
+ /**
2402
+ * 最短坠落时长(秒,默认 2)
2403
+ */
2404
+ minDuration?: number;
2405
+ /**
2406
+ * 最长坠落时长(秒,默认 5)
2407
+ */
2408
+ maxDuration?: number;
2409
+ /**
2410
+ * 最小起始延迟(秒,默认 0)
2411
+ */
2412
+ minDelay?: number;
2413
+ /**
2414
+ * 最大起始延迟(秒,默认 4)
2415
+ */
2416
+ maxDelay?: number;
2417
+ };
2418
+ /**
2419
+ * MeteorShower:流星雨叠加层
2420
+ *
2421
+ * @param props - 组件属性
2422
+ * @returns 流星雨 JSX
2423
+ */
2424
+ declare function MeteorShower(props: MeteorShowerProps): import("react").JSX.Element | null;
2425
+ //#endregion
2426
+ //#region src/modal.d.ts
2427
+ /**
2428
+ * Modal 视觉变体
2429
+ */
2430
+ type ModalVariant = 'default' | 'frosted' | 'glass' | 'matte';
2431
+ /**
2432
+ * Modal 尺寸
2433
+ */
2434
+ type ModalSize = 'lg' | 'md' | 'sm';
2435
+ /**
2436
+ * Modal:对话框根(open 受控入口)
2437
+ */
2438
+ declare const Modal: import("react").FC<DialogPrimitive.DialogProps>;
2439
+ /**
2440
+ * ModalTrigger:对话框触发器
2441
+ */
2442
+ declare const ModalTrigger: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
2443
+ /**
2444
+ * ModalClose:对话框关闭触发器
2445
+ */
2446
+ declare const ModalClose: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & import("react").RefAttributes<HTMLButtonElement>>;
2447
+ /**
2448
+ * ModalPortal 属性
2449
+ */
2450
+ type ModalPortalProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Portal>;
2451
+ /**
2452
+ * ModalPortal:传送门容器
2453
+ *
2454
+ * @param props - 组件属性
2455
+ * @returns 传送门 JSX
2456
+ */
2457
+ declare function ModalPortal(props: ModalPortalProps): import("react").JSX.Element;
2458
+ /**
2459
+ * ModalOverlay 属性
2460
+ */
2461
+ type ModalOverlayProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>;
2462
+ /**
2463
+ * ModalOverlay:遮罩层(径向渐变 + 轻模糊)
2464
+ *
2465
+ * @param props - 组件属性
2466
+ * @returns 遮罩 JSX
2467
+ */
2468
+ declare function ModalOverlay(props: ModalOverlayProps): import("react").JSX.Element;
2469
+ /**
2470
+ * ModalContent 属性
2471
+ */
2472
+ type ModalContentProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Content> & {
2473
+ /**
2474
+ * 视觉变体(默认 'glass')
2475
+ */
2476
+ variant?: ModalVariant;
2477
+ /**
2478
+ * 尺寸档位(默认 'md')
2479
+ */
2480
+ size?: ModalSize;
2481
+ /**
2482
+ * 是否隐藏内建关闭按钮(默认 false)
2483
+ */
2484
+ hideClose?: boolean;
2485
+ /**
2486
+ * 内容
2487
+ */
2488
+ children?: ReactNode;
2489
+ /**
2490
+ * 内容节点 ref(React 19 ref-as-prop)
2491
+ */
2492
+ ref?: Ref<React.ComponentRef<typeof DialogPrimitive.Content>>;
2493
+ };
2494
+ /**
2495
+ * ModalContent:对话框内容(含遮罩与关闭按钮)
2496
+ *
2497
+ * @param props - 组件属性
2498
+ * @returns 内容 JSX
2499
+ */
2500
+ declare function ModalContent(props: ModalContentProps): import("react").JSX.Element;
2501
+ /**
2502
+ * ModalHeader 属性
2503
+ */
2504
+ type ModalHeaderProps = ComponentPropsWithoutRef<'div'>;
2505
+ /**
2506
+ * ModalHeader:对话框头部
2507
+ *
2508
+ * @param props - 组件属性
2509
+ * @returns 头部 JSX
2510
+ */
2511
+ declare function ModalHeader(props: ModalHeaderProps): import("react").JSX.Element;
2512
+ /**
2513
+ * ModalFooter 属性
2514
+ */
2515
+ type ModalFooterProps = ComponentPropsWithoutRef<'div'>;
2516
+ /**
2517
+ * ModalFooter:对话框底部操作区
2518
+ *
2519
+ * @param props - 组件属性
2520
+ * @returns 底部 JSX
2521
+ */
2522
+ declare function ModalFooter(props: ModalFooterProps): import("react").JSX.Element;
2523
+ /**
2524
+ * ModalTitle 属性
2525
+ */
2526
+ type ModalTitleProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Title>;
2527
+ /**
2528
+ * ModalTitle:对话框标题
2529
+ *
2530
+ * @param props - 组件属性
2531
+ * @returns 标题 JSX
2532
+ */
2533
+ declare function ModalTitle(props: ModalTitleProps): import("react").JSX.Element;
2534
+ /**
2535
+ * ModalDescription 属性
2536
+ */
2537
+ type ModalDescriptionProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Description>;
2538
+ /**
2539
+ * ModalDescription:对话框描述文本
2540
+ *
2541
+ * @param props - 组件属性
2542
+ * @returns 描述 JSX
2543
+ */
2544
+ declare function ModalDescription(props: ModalDescriptionProps): import("react").JSX.Element;
2545
+ //#endregion
2546
+ //#region src/morphing-tabs.d.ts
2547
+ /**
2548
+ * 选项卡项
2549
+ */
2550
+ type MorphingTabItem = {
2551
+ /**
2552
+ * 项标识
2553
+ */
2554
+ id: string;
2555
+ /**
2556
+ * 项文本
2557
+ */
2558
+ label: ReactNode;
2559
+ /**
2560
+ * 禁用态
2561
+ */
2562
+ disabled?: boolean;
2563
+ };
2564
+ /**
2565
+ * 选项卡变体
2566
+ */
2567
+ type MorphingTabsVariant = 'glass' | 'solid' | 'underline';
2568
+ /**
2569
+ * 选项卡尺寸
2570
+ */
2571
+ type MorphingTabsSize = 'lg' | 'md' | 'sm';
2572
+ /**
2573
+ * MorphingTabs 属性
2574
+ */
2575
+ type MorphingTabsProps = Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'children'> & {
2576
+ /**
2577
+ * 选项卡项列表
2578
+ */
2579
+ items: MorphingTabItem[];
2580
+ /**
2581
+ * 受控激活项标识
2582
+ */
2583
+ activeId?: string;
2584
+ /**
2585
+ * 非受控初始激活项标识(缺省取首项)
2586
+ */
2587
+ defaultActiveId?: string;
2588
+ /**
2589
+ * 激活项变化回调
2590
+ */
2591
+ onTabChange?: (id: string) => void;
2592
+ /**
2593
+ * 视觉变体(默认 'glass')
2594
+ */
2595
+ variant?: MorphingTabsVariant;
2596
+ /**
2597
+ * 尺寸档位(默认 'md')
2598
+ */
2599
+ size?: MorphingTabsSize;
2600
+ };
2601
+ /**
2602
+ * MorphingTabs:滑动指示器选项卡
2603
+ *
2604
+ * @param props - 组件属性
2605
+ * @returns 选项卡 JSX
2606
+ */
2607
+ declare function MorphingTabs(props: MorphingTabsProps): import("react").JSX.Element;
2608
+ //#endregion
2609
+ //#region src/number-ticker.d.ts
2610
+ /**
2611
+ * NumberTicker 属性
2612
+ */
2613
+ type NumberTickerProps = HTMLAttributes<HTMLSpanElement> & {
2614
+ /**
2615
+ * 目标数值
2616
+ */
2617
+ value: number;
2618
+ /**
2619
+ * 起始数值(默认 0)
2620
+ */
2621
+ from?: number;
2622
+ /**
2623
+ * 滚动时长(秒,默认 1.5)
2624
+ */
2625
+ duration?: number;
2626
+ /**
2627
+ * 起始延迟(秒,默认 0)
2628
+ */
2629
+ delay?: number;
2630
+ /**
2631
+ * 小数位数(默认 0,formatOptions 缺省时生效)
2632
+ */
2633
+ decimals?: number;
2634
+ /**
2635
+ * Intl 数字格式化选项(提供时优先于 decimals)
2636
+ */
2637
+ formatOptions?: Intl.NumberFormatOptions;
2638
+ /**
2639
+ * 容器 ref(React 19 ref-as-prop)
2640
+ */
2641
+ ref?: Ref<HTMLSpanElement>;
2642
+ };
2643
+ /**
2644
+ * NumberTicker:视口触发的滚动计数器
2645
+ *
2646
+ * @param props - 组件属性
2647
+ * @returns 计数 JSX
2648
+ */
2649
+ declare function NumberTicker(props: NumberTickerProps): import("react").JSX.Element;
2650
+ //#endregion
2651
+ //#region src/orbiting-circles.d.ts
2652
+ /**
2653
+ * 环绕项视觉变体
2654
+ */
2655
+ type OrbitingCirclesVariant = '3d' | 'default' | 'glass';
2656
+ /**
2657
+ * OrbitingCircles 属性
2658
+ */
2659
+ type OrbitingCirclesProps = HTMLAttributes<HTMLDivElement> & {
2660
+ /**
2661
+ * 轨道半径(px,默认 100)
2662
+ */
2663
+ radius?: number;
2664
+ /**
2665
+ * 一圈环绕时长(秒,默认 20)
2666
+ */
2667
+ duration?: number;
2668
+ /**
2669
+ * 动画延迟(秒,默认 0)
2670
+ */
2671
+ delay?: number;
2672
+ /**
2673
+ * 反向环绕(默认 false)
2674
+ */
2675
+ reverse?: boolean;
2676
+ /**
2677
+ * 是否显示轨道虚线环(默认 false)
2678
+ */
2679
+ path?: boolean;
2680
+ /**
2681
+ * 起始角度(deg,默认 0)
2682
+ */
2683
+ startAngle?: number;
2684
+ /**
2685
+ * 视觉变体(默认 'default')
2686
+ */
2687
+ variant?: OrbitingCirclesVariant;
2688
+ /**
2689
+ * 环绕项尺寸(px,默认 32)
2690
+ */
2691
+ iconSize?: number;
2692
+ /**
2693
+ * 环绕项 ref(React 19 ref-as-prop)
2694
+ */
2695
+ ref?: Ref<HTMLDivElement>;
2696
+ };
2697
+ /**
2698
+ * OrbitingCircles:轨道环绕元素
2699
+ *
2700
+ * @param props - 组件属性
2701
+ * @returns 环绕 JSX
2702
+ */
2703
+ declare function OrbitingCircles(props: OrbitingCirclesProps): import("react").JSX.Element;
2704
+ //#endregion
2705
+ //#region src/particle-field.d.ts
2706
+ /**
2707
+ * 粒子形状
2708
+ */
2709
+ type ParticleFieldShape = 'circle' | 'square';
2710
+ /**
2711
+ * ParticleField 属性
2712
+ */
2713
+ type ParticleFieldProps = HTMLAttributes<HTMLDivElement> & {
2714
+ /**
2715
+ * 粒子数量(默认 30)
2716
+ */
2717
+ count?: number;
2718
+ /**
2719
+ * 粒子颜色(缺省 currentColor)
2720
+ */
2721
+ color?: string;
2722
+ /**
2723
+ * 最小粒径(px,默认 2)
2724
+ */
2725
+ minSize?: number;
2726
+ /**
2727
+ * 最大粒径(px,默认 5)
2728
+ */
2729
+ maxSize?: number;
2730
+ /**
2731
+ * 基础上浮时长(秒,默认 5)
2732
+ */
2733
+ duration?: number;
2734
+ /**
2735
+ * 上浮距离(px,默认 200)
2736
+ */
2737
+ distance?: number;
2738
+ /**
2739
+ * 粒子形状(默认 'circle')
2740
+ */
2741
+ shape?: ParticleFieldShape;
2742
+ };
2743
+ /**
2744
+ * ParticleField:上浮粒子背景层
2745
+ *
2746
+ * @param props - 组件属性
2747
+ * @returns 粒子场 JSX
2748
+ */
2749
+ declare function ParticleField(props: ParticleFieldProps): import("react").JSX.Element;
2750
+ //#endregion
2751
+ //#region src/popover.d.ts
2752
+ /**
2753
+ * Popover:弹出层根
2754
+ */
2755
+ declare const Popover: import("react").FC<PopoverPrimitive.PopoverProps>;
2756
+ /**
2757
+ * PopoverTrigger:弹出层触发器
2758
+ */
2759
+ declare const PopoverTrigger: import("react").ForwardRefExoticComponent<PopoverPrimitive.PopoverTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
2760
+ /**
2761
+ * PopoverAnchor:弹出层锚点(不渲染触发器时定位用)
2762
+ */
2763
+ declare const PopoverAnchor: import("react").ForwardRefExoticComponent<PopoverPrimitive.PopoverAnchorProps & import("react").RefAttributes<HTMLDivElement>>;
2764
+ /**
2765
+ * PopoverClose:弹出层关闭触发器
2766
+ */
2767
+ declare const PopoverClose: import("react").ForwardRefExoticComponent<PopoverPrimitive.PopoverCloseProps & import("react").RefAttributes<HTMLButtonElement>>;
2768
+ /**
2769
+ * PopoverContent 属性
2770
+ */
2771
+ type PopoverContentProps = ComponentPropsWithoutRef<typeof PopoverPrimitive.Content> & {
2772
+ /**
2773
+ * 内容 ref
2774
+ */
2775
+ ref?: Ref<HTMLDivElement>;
2776
+ };
2777
+ /**
2778
+ * PopoverContent:弹出层内容面板(portal 挂载,可交互)
2779
+ *
2780
+ * @param props - 组件属性
2781
+ * @returns 面板 JSX
2782
+ */
2783
+ declare function PopoverContent(props: PopoverContentProps): import("react").JSX.Element;
2784
+ //#endregion
2785
+ //#region src/prism-border.d.ts
2786
+ /**
2787
+ * PrismBorder 属性
2788
+ */
2789
+ type PrismBorderProps = HTMLAttributes<HTMLDivElement> & {
2790
+ /**
2791
+ * 渐变流动时长(秒,默认 3)
2792
+ */
2793
+ duration?: number;
2794
+ /**
2795
+ * 边框宽度(px,默认 2)
2796
+ */
2797
+ borderWidth?: number;
2798
+ /**
2799
+ * 圆角(CSS 长度值,默认 '0.75rem')
2800
+ */
2801
+ borderRadius?: string;
2802
+ /**
2803
+ * 渐变配色(按 90deg 线性渐变排列)
2804
+ */
2805
+ colors?: string[];
2806
+ /**
2807
+ * 内容
2808
+ */
2809
+ children?: ReactNode;
2810
+ /**
2811
+ * 容器 ref(React 19 ref-as-prop)
2812
+ */
2813
+ ref?: Ref<HTMLDivElement>;
2814
+ };
2815
+ /**
2816
+ * PrismBorder:流动渐变描边容器
2817
+ *
2818
+ * @param props - 组件属性
2819
+ * @returns 棱镜边框 JSX
2820
+ */
2821
+ declare function PrismBorder(props: PrismBorderProps): import("react").JSX.Element;
2822
+ //#endregion
2823
+ //#region src/progress.d.ts
2824
+ /**
2825
+ * Progress 属性
2826
+ */
2827
+ type ProgressProps = ComponentPropsWithoutRef<typeof ProgressPrimitive.Root> & {
2828
+ /**
2829
+ * 根节点 ref
2830
+ */
2831
+ ref?: Ref<HTMLDivElement>;
2832
+ };
2833
+ /**
2834
+ * Progress:线性进度条容器
2835
+ *
2836
+ * @param props - 组件属性
2837
+ * @returns 进度条 JSX
2838
+ */
2839
+ declare function Progress(props: ProgressProps): import("react").JSX.Element;
2840
+ /**
2841
+ * GlassProgressRing 属性
2842
+ */
2843
+ type GlassProgressRingProps = Omit<ComponentPropsWithoutRef<'div'>, 'children'> & {
2844
+ /**
2845
+ * 进度值(0–100,缺省 indeterminate)
2846
+ */
2847
+ value?: number;
2848
+ /**
2849
+ * 环粗(px,默认 8)
2850
+ */
2851
+ thickness?: number;
2852
+ /**
2853
+ * 环直径(px,默认 64)
2854
+ */
2855
+ size?: number;
2856
+ /**
2857
+ * 环内内容
2858
+ */
2859
+ children?: ComponentPropsWithoutRef<'div'>['children'];
2860
+ /**
2861
+ * 根节点 ref
2862
+ */
2863
+ ref?: Ref<HTMLDivElement>;
2864
+ };
2865
+ /**
2866
+ * GlassProgressRing:环形进度(SVG 圆环,indeterminate 时旋转)
2867
+ *
2868
+ * @param props - 组件属性
2869
+ * @returns 环形进度 JSX
2870
+ */
2871
+ declare function GlassProgressRing(props: GlassProgressRingProps): import("react").JSX.Element;
2872
+ //#endregion
2873
+ //#region src/pulsating-button.d.ts
2874
+ /**
2875
+ * 脉冲按钮视觉变体
2876
+ */
2877
+ type PulsatingButtonVariant = 'accent' | 'default' | 'glass';
2878
+ /**
2879
+ * 脉冲按钮尺寸
2880
+ */
2881
+ type PulsatingButtonSize = 'lg' | 'md' | 'sm';
2882
+ /**
2883
+ * PulsatingButton 属性
2884
+ */
2885
+ type PulsatingButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & {
2886
+ /**
2887
+ * 视觉变体(默认 'default')
2888
+ */
2889
+ variant?: PulsatingButtonVariant;
2890
+ /**
2891
+ * 尺寸(默认 'md')
2892
+ */
2893
+ size?: PulsatingButtonSize;
2894
+ /**
2895
+ * 自定义脉冲色(CSS 颜色值,缺省随变体取色)
2896
+ */
2897
+ pulseColor?: string;
2898
+ /**
2899
+ * 脉冲周期(秒,默认 2)
2900
+ */
2901
+ pulseDuration?: number;
2902
+ /**
2903
+ * 按钮内容
2904
+ */
2905
+ children?: ReactNode;
2906
+ /**
2907
+ * 按钮 ref(React 19 ref-as-prop)
2908
+ */
2909
+ ref?: Ref<HTMLButtonElement>;
2910
+ };
2911
+ /**
2912
+ * PulsatingButton:脉冲光环按钮
2913
+ *
2914
+ * @param props - 组件属性
2915
+ * @returns 按钮 JSX
2916
+ */
2917
+ declare function PulsatingButton(props: PulsatingButtonProps): import("react").JSX.Element;
2918
+ //#endregion
2919
+ //#region src/radio-group.d.ts
2920
+ /**
2921
+ * RadioGroup 属性
2922
+ */
2923
+ type RadioGroupProps = ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Root> & {
2924
+ /**
2925
+ * 组 ref
2926
+ */
2927
+ ref?: Ref<HTMLDivElement>;
2928
+ };
2929
+ /**
2930
+ * RadioGroup:单选组容器
2931
+ *
2932
+ * @param props - 组件属性
2933
+ * @returns 单选组 JSX
2934
+ */
2935
+ declare function RadioGroup(props: RadioGroupProps): import("react").JSX.Element;
2936
+ /**
2937
+ * RadioGroupItem 属性
2938
+ */
2939
+ type RadioGroupItemProps = ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Item> & {
2940
+ /**
2941
+ * 选项 ref
2942
+ */
2943
+ ref?: Ref<HTMLButtonElement>;
2944
+ };
2945
+ /**
2946
+ * RadioGroupItem:单选项(内建圆点指示器)
2947
+ *
2948
+ * @param props - 组件属性
2949
+ * @returns 选项 JSX
2950
+ */
2951
+ declare function RadioGroupItem(props: RadioGroupItemProps): import("react").JSX.Element;
2952
+ //#endregion
2953
+ //#region src/retro-grid.d.ts
2954
+ /**
2955
+ * RetroGrid 属性
2956
+ */
2957
+ type RetroGridProps = HTMLAttributes<HTMLDivElement> & {
2958
+ /**
2959
+ * 透视倾角(deg,默认 65)
2960
+ */
2961
+ angle?: number;
2962
+ /**
2963
+ * 网格线颜色(CSS 颜色值,缺省 currentColor)
2964
+ */
2965
+ lineColor?: string;
2966
+ /**
2967
+ * 网格线不透明度(0–1,默认 0.3)
2968
+ */
2969
+ lineOpacity?: number;
2970
+ /**
2971
+ * 网格单元尺寸(px,默认 60)
2972
+ */
2973
+ cellSize?: number;
2974
+ /**
2975
+ * 根节点 ref(React 19 ref-as-prop)
2976
+ */
2977
+ ref?: Ref<HTMLDivElement>;
2978
+ };
2979
+ /**
2980
+ * RetroGrid:透视滚动复古网格背景
2981
+ *
2982
+ * @param props - 组件属性
2983
+ * @returns 网格背景 JSX
2984
+ */
2985
+ declare function RetroGrid(props: RetroGridProps): import("react").JSX.Element;
2986
+ //#endregion
2987
+ //#region src/reveal-text.d.ts
2988
+ /**
2989
+ * 显现方向
2990
+ */
2991
+ type RevealTextDirection = 'bottom' | 'left' | 'right' | 'top';
2992
+ /**
2993
+ * RevealText 属性
2994
+ */
2995
+ type RevealTextProps = HTMLAttributes<HTMLSpanElement> & {
2996
+ /**
2997
+ * 待显现文本
2998
+ */
2999
+ text: string;
3000
+ /**
3001
+ * 动画时长(秒,默认 0.8)
3002
+ */
3003
+ duration?: number;
3004
+ /**
3005
+ * 起始延迟(毫秒,默认 0)
3006
+ */
3007
+ delay?: number;
3008
+ /**
3009
+ * 显现方向(默认 'left')
3010
+ */
3011
+ direction?: RevealTextDirection;
3012
+ /**
3013
+ * 是否进入视口时触发(默认 true,否则挂载即触发)
3014
+ */
3015
+ triggerOnView?: boolean;
3016
+ /**
3017
+ * IntersectionObserver 阈值(默认 0.5)
3018
+ */
3019
+ threshold?: number;
3020
+ /**
3021
+ * 根节点 ref(React 19 ref-as-prop)
3022
+ */
3023
+ ref?: Ref<HTMLSpanElement>;
3024
+ };
3025
+ /**
3026
+ * RevealText:裁切显现文本
3027
+ *
3028
+ * @param props - 组件属性
3029
+ * @returns 显现文本 JSX
3030
+ */
3031
+ declare function RevealText(props: RevealTextProps): import("react").JSX.Element;
3032
+ //#endregion
3033
+ //#region src/ripple.d.ts
3034
+ /**
3035
+ * 涟漪环变体
3036
+ */
3037
+ type RippleVariant = 'accent' | 'default' | 'glass';
3038
+ /**
3039
+ * Ripple 属性
3040
+ */
3041
+ type RippleProps = HTMLAttributes<HTMLDivElement> & {
3042
+ /**
3043
+ * 涟漪环数量(默认 3)
3044
+ */
3045
+ count?: number;
3046
+ /**
3047
+ * 单环扩散时长(秒,默认 2)
3048
+ */
3049
+ duration?: number;
3050
+ /**
3051
+ * 相邻环动画延迟步长(秒,默认 0.4)
3052
+ */
3053
+ delay?: number;
3054
+ /**
3055
+ * 环描边变体(默认 'default')
3056
+ */
3057
+ variant?: RippleVariant;
3058
+ /**
3059
+ * 叠加内容
3060
+ */
3061
+ children?: ReactNode;
3062
+ /**
3063
+ * 根节点 ref(React 19 ref-as-prop)
3064
+ */
3065
+ ref?: Ref<HTMLDivElement>;
3066
+ };
3067
+ /**
3068
+ * Ripple:同心圆环涟漪背景
3069
+ *
3070
+ * @param props - 组件属性
3071
+ * @returns 涟漪背景 JSX
3072
+ */
3073
+ declare function Ripple(props: RippleProps): import("react").JSX.Element;
3074
+ //#endregion
3075
+ //#region src/ripple-button.d.ts
3076
+ /**
3077
+ * 涟漪按钮变体(复用 Button 变体系的子集)
3078
+ */
3079
+ type RippleButtonVariant = 'default' | 'frosted' | 'glass' | 'outline';
3080
+ /**
3081
+ * 涟漪按钮尺寸
3082
+ */
3083
+ type RippleButtonSize = 'lg' | 'md' | 'sm';
3084
+ /**
3085
+ * RippleButton 属性
3086
+ */
3087
+ type RippleButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children'> & {
3088
+ /**
3089
+ * 涟漪颜色(CSS 颜色值,缺省按变体取默认)
3090
+ */
3091
+ rippleColor?: string;
3092
+ /**
3093
+ * 视觉变体(默认 'default')
3094
+ */
3095
+ variant?: RippleButtonVariant;
3096
+ /**
3097
+ * 尺寸档位(默认 'md')
3098
+ */
3099
+ size?: RippleButtonSize;
3100
+ /**
3101
+ * 按钮内容
3102
+ */
3103
+ children?: ReactNode;
3104
+ };
3105
+ /**
3106
+ * RippleButton:液态涟漪按钮
3107
+ *
3108
+ * @param props - 组件属性
3109
+ * @returns 按钮 JSX
3110
+ */
3111
+ declare function RippleButton(props: RippleButtonProps): import("react").JSX.Element;
3112
+ //#endregion
3113
+ //#region src/select.d.ts
3114
+ /**
3115
+ * 下拉选择视觉变体
3116
+ */
3117
+ type SelectVariant = 'default' | 'filled' | 'frosted' | 'glass' | 'outline';
3118
+ /**
3119
+ * Select 属性
3120
+ */
3121
+ type SelectProps = Omit<SelectHTMLAttributes<HTMLSelectElement>, 'size'> & {
3122
+ /**
3123
+ * 视觉变体(默认 'default')
3124
+ */
3125
+ variant?: SelectVariant;
3126
+ /**
3127
+ * 占位选项文案(提供时渲染 disabled 首项)
3128
+ */
3129
+ placeholder?: string;
3130
+ };
3131
+ /**
3132
+ * Select:原生玻璃下拉选择
3133
+ *
3134
+ * @param props - 组件属性
3135
+ * @returns 下选 JSX
3136
+ */
3137
+ declare function Select(props: SelectProps): import("react").JSX.Element;
3138
+ //#endregion
3139
+ //#region src/separator.d.ts
3140
+ /**
3141
+ * 分隔线方向
3142
+ */
3143
+ type SeparatorOrientation = 'horizontal' | 'vertical';
3144
+ /**
3145
+ * 分隔线样式
3146
+ */
3147
+ type SeparatorStyle = 'dashed' | 'dotted' | 'glass' | 'gradient' | 'solid';
3148
+ /**
3149
+ * Separator 属性
3150
+ */
3151
+ type SeparatorProps = Omit<HTMLAttributes<HTMLDivElement>, 'children'> & {
3152
+ /**
3153
+ * 方向(默认 'horizontal')
3154
+ */
3155
+ orientation?: SeparatorOrientation;
3156
+ /**
3157
+ * 样式(默认 'solid')
3158
+ */
3159
+ separatorStyle?: SeparatorStyle;
3160
+ /**
3161
+ * 标签内容(提供时渲染带标签分隔线)
3162
+ */
3163
+ label?: ReactNode;
3164
+ /**
3165
+ * 是否装饰性(默认 true;无标签时对屏幕阅读器隐藏)
3166
+ */
3167
+ decorative?: boolean;
3168
+ };
3169
+ /**
3170
+ * Separator:分隔线
3171
+ *
3172
+ * @param props - 组件属性
3173
+ * @returns 分隔线 JSX
3174
+ */
3175
+ declare function Separator(props: SeparatorProps): import("react").JSX.Element;
3176
+ //#endregion
3177
+ //#region src/sheet.d.ts
3178
+ /**
3179
+ * 侧滑面板视觉变体
3180
+ */
3181
+ type SheetVariant = 'default' | 'frosted' | 'glass';
3182
+ /**
3183
+ * 侧滑面板尺寸
3184
+ */
3185
+ type SheetSize = 'lg' | 'md' | 'sm';
3186
+ /**
3187
+ * 侧滑方向
3188
+ */
3189
+ type SheetSide = 'bottom' | 'left' | 'right' | 'top';
3190
+ /**
3191
+ * Sheet:侧滑面板根
3192
+ */
3193
+ declare const Sheet: import("react").FC<DialogPrimitive.DialogProps>;
3194
+ /**
3195
+ * Drawer:Sheet 别名
3196
+ */
3197
+ declare const Drawer: import("react").FC<DialogPrimitive.DialogProps>;
3198
+ /**
3199
+ * SheetTrigger:侧滑触发器
3200
+ */
3201
+ declare const SheetTrigger: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
3202
+ /**
3203
+ * SheetClose:侧滑关闭触发器
3204
+ */
3205
+ declare const SheetClose: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & import("react").RefAttributes<HTMLButtonElement>>;
3206
+ /**
3207
+ * SheetPortal 属性
3208
+ */
3209
+ type SheetPortalProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Portal>;
3210
+ /**
3211
+ * SheetPortal:传送门容器
3212
+ *
3213
+ * @param props - 组件属性
3214
+ * @returns 传送门 JSX
3215
+ */
3216
+ declare function SheetPortal(props: SheetPortalProps): import("react").JSX.Element;
3217
+ /**
3218
+ * SheetOverlay 属性
3219
+ */
3220
+ type SheetOverlayProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>;
3221
+ /**
3222
+ * SheetOverlay:遮罩层
3223
+ *
3224
+ * @param props - 组件属性
3225
+ * @returns 遮罩 JSX
3226
+ */
3227
+ declare function SheetOverlay(props: SheetOverlayProps): import("react").JSX.Element;
3228
+ /**
3229
+ * SheetContent 属性
3230
+ */
3231
+ type SheetContentProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Content> & {
3232
+ /**
3233
+ * 视觉变体(默认 'default')
3234
+ */
3235
+ variant?: SheetVariant;
3236
+ /**
3237
+ * 尺寸档位(默认 'md')
3238
+ */
3239
+ size?: SheetSize;
3240
+ /**
3241
+ * 滑入方向(默认 'right')
3242
+ */
3243
+ side?: SheetSide;
3244
+ /**
3245
+ * 是否隐藏内建关闭按钮(默认 false)
3246
+ */
3247
+ hideClose?: boolean;
3248
+ /**
3249
+ * 内容
3250
+ */
3251
+ children?: ReactNode;
3252
+ /**
3253
+ * 内容 ref
3254
+ */
3255
+ ref?: Ref<HTMLDivElement>;
3256
+ };
3257
+ /**
3258
+ * SheetContent:侧滑内容面板(含遮罩与关闭按钮)
3259
+ *
3260
+ * @param props - 组件属性
3261
+ * @returns 内容 JSX
3262
+ */
3263
+ declare function SheetContent(props: SheetContentProps): import("react").JSX.Element;
3264
+ /**
3265
+ * SheetHeader 属性
3266
+ */
3267
+ type SheetHeaderProps = ComponentPropsWithoutRef<'div'>;
3268
+ /**
3269
+ * SheetHeader:侧滑面板头部
3270
+ *
3271
+ * @param props - 组件属性
3272
+ * @returns 头部 JSX
3273
+ */
3274
+ declare function SheetHeader(props: SheetHeaderProps): import("react").JSX.Element;
3275
+ /**
3276
+ * SheetFooter 属性
3277
+ */
3278
+ type SheetFooterProps = ComponentPropsWithoutRef<'div'>;
3279
+ /**
3280
+ * SheetFooter:侧滑面板底部操作区
3281
+ *
3282
+ * @param props - 组件属性
3283
+ * @returns 底部 JSX
3284
+ */
3285
+ declare function SheetFooter(props: SheetFooterProps): import("react").JSX.Element;
3286
+ /**
3287
+ * SheetTitle 属性
3288
+ */
3289
+ type SheetTitleProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Title>;
3290
+ /**
3291
+ * SheetTitle:侧滑面板标题
3292
+ *
3293
+ * @param props - 组件属性
3294
+ * @returns 标题 JSX
3295
+ */
3296
+ declare function SheetTitle(props: SheetTitleProps): import("react").JSX.Element;
3297
+ /**
3298
+ * SheetDescription 属性
3299
+ */
3300
+ type SheetDescriptionProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Description>;
3301
+ /**
3302
+ * SheetDescription:侧滑面板描述文本
3303
+ *
3304
+ * @param props - 组件属性
3305
+ * @returns 描述 JSX
3306
+ */
3307
+ declare function SheetDescription(props: SheetDescriptionProps): import("react").JSX.Element;
3308
+ //#endregion
3309
+ //#region src/shimmer-button.d.ts
3310
+ /**
3311
+ * 微光按钮变体
3312
+ */
3313
+ type ShimmerButtonVariant = 'accent' | 'default' | 'glass';
3314
+ /**
3315
+ * 微光按钮尺寸
3316
+ */
3317
+ type ShimmerButtonSize = 'lg' | 'md' | 'sm';
3318
+ /**
3319
+ * ShimmerButton 属性
3320
+ */
3321
+ type ShimmerButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & {
3322
+ /**
3323
+ * 微光颜色(CSS 颜色值,默认半透明白)
3324
+ */
3325
+ shimmerColor?: string;
3326
+ /**
3327
+ * 微光扫过时长(秒,默认 2)
3328
+ */
3329
+ shimmerDuration?: number;
3330
+ /**
3331
+ * 视觉变体(默认 'default')
3332
+ */
3333
+ variant?: ShimmerButtonVariant;
3334
+ /**
3335
+ * 尺寸档位(默认 'md')
3336
+ */
3337
+ size?: ShimmerButtonSize;
3338
+ /**
3339
+ * 按钮内容
3340
+ */
3341
+ children?: ReactNode;
3342
+ /**
3343
+ * 按钮 ref(React 19 ref-as-prop)
3344
+ */
3345
+ ref?: Ref<HTMLButtonElement>;
3346
+ };
3347
+ /**
3348
+ * ShimmerButton:微光扫过按钮
3349
+ *
3350
+ * @param props - 组件属性
3351
+ * @returns 按钮 JSX
3352
+ */
3353
+ declare function ShimmerButton(props: ShimmerButtonProps): import("react").JSX.Element;
3354
+ //#endregion
3355
+ //#region src/skeleton.d.ts
3356
+ /**
3357
+ * 骨架屏变体
3358
+ */
3359
+ type SkeletonVariant = 'circle' | 'rect' | 'text';
3360
+ /**
3361
+ * Skeleton 属性
3362
+ */
3363
+ type SkeletonProps = HTMLAttributes<HTMLDivElement> & {
3364
+ /**
3365
+ * 变体(默认 'rect')
3366
+ */
3367
+ variant?: SkeletonVariant;
3368
+ /**
3369
+ * 尺寸(px;circle 时作直径,text 时作行高)
3370
+ */
3371
+ size?: number;
3372
+ };
3373
+ /**
3374
+ * Skeleton:加载骨架占位
3375
+ *
3376
+ * @param props - 组件属性
3377
+ * @returns 骨架 JSX
3378
+ */
3379
+ declare function Skeleton(props: SkeletonProps): import("react").JSX.Element;
3380
+ //#endregion
3381
+ //#region src/slider.d.ts
3382
+ /**
3383
+ * Slider 属性
3384
+ */
3385
+ type SliderProps = ComponentPropsWithoutRef<typeof SliderPrimitive.Root> & {
3386
+ /**
3387
+ * 根节点 ref
3388
+ */
3389
+ ref?: Ref<HTMLSpanElement>;
3390
+ };
3391
+ /**
3392
+ * Slider:玻璃质感滑块
3393
+ *
3394
+ * @param props - 组件属性
3395
+ * @returns 滑块 JSX
3396
+ */
3397
+ declare function Slider(props: SliderProps): import("react").JSX.Element;
3398
+ //#endregion
3399
+ //#region src/spotlight.d.ts
3400
+ /**
3401
+ * Spotlight 属性
3402
+ */
3403
+ type SpotlightProps = HTMLAttributes<HTMLDivElement> & {
3404
+ /**
3405
+ * 是否激活(默认 true,false 时不渲染)
3406
+ */
3407
+ active?: boolean;
3408
+ /**
3409
+ * 聚光中心横坐标(px 或 %,默认 '50%')
3410
+ */
3411
+ x?: number | string;
3412
+ /**
3413
+ * 聚光中心纵坐标(px 或 %,默认 '50%')
3414
+ */
3415
+ y?: number | string;
3416
+ /**
3417
+ * 聚光半径(px,默认 150)
3418
+ */
3419
+ size?: number;
3420
+ /**
3421
+ * 遮罩颜色(CSS 颜色值,默认半透明黑)
3422
+ */
3423
+ overlayColor?: string;
3424
+ /**
3425
+ * 点击遮罩关闭回调
3426
+ */
3427
+ onDismiss?: () => void;
3428
+ /**
3429
+ * 是否启用脉冲环(默认 false)
3430
+ */
3431
+ pulse?: boolean;
3432
+ /**
3433
+ * 遮罩内容
3434
+ */
3435
+ children?: ReactNode;
3436
+ /**
3437
+ * 根节点 ref(React 19 ref-as-prop)
3438
+ */
3439
+ ref?: Ref<HTMLDivElement>;
3440
+ };
3441
+ /**
3442
+ * Spotlight:整页聚光遮罩
3443
+ *
3444
+ * @param props - 组件属性
3445
+ * @returns 聚光遮罩 JSX
3446
+ */
3447
+ declare function Spotlight(props: SpotlightProps): import("react").JSX.Element | null;
3448
+ //#endregion
3449
+ //#region src/spotlight-card.d.ts
3450
+ /**
3451
+ * SpotlightCard 属性
3452
+ */
3453
+ type SpotlightCardProps = GlassCardProps & {
3454
+ /**
3455
+ * 聚光叠加层类名
3456
+ */
3457
+ spotlightClassName?: string;
3458
+ };
3459
+ /**
3460
+ * SpotlightCard:光标追踪聚光玻璃卡片
3461
+ *
3462
+ * @param props - 组件属性
3463
+ * @returns 卡片 JSX
3464
+ */
3465
+ declare function SpotlightCard(props: SpotlightCardProps): import("react").JSX.Element;
3466
+ //#endregion
3467
+ //#region src/status-dot.d.ts
3468
+ /**
3469
+ * 状态点状态
3470
+ */
3471
+ type StatusDotStatus = 'away' | 'busy' | 'offline' | 'online';
3472
+ /**
3473
+ * StatusDot 属性
3474
+ */
3475
+ type StatusDotProps = Omit<HTMLAttributes<HTMLSpanElement>, 'children'> & {
3476
+ /**
3477
+ * 状态(默认 'online')
3478
+ */
3479
+ status?: StatusDotStatus;
3480
+ /**
3481
+ * 自定义状态色(CSS 颜色值,优先于 status)
3482
+ */
3483
+ color?: string;
3484
+ /**
3485
+ * 是否脉冲动画(默认 true)
3486
+ */
3487
+ pulse?: boolean;
3488
+ };
3489
+ /**
3490
+ * StatusDot:状态指示点
3491
+ *
3492
+ * @param props - 组件属性
3493
+ * @returns 状态点 JSX
3494
+ */
3495
+ declare function StatusDot(props: StatusDotProps): import("react").JSX.Element;
3496
+ //#endregion
3497
+ //#region src/switch.d.ts
3498
+ /**
3499
+ * 开关视觉变体
3500
+ */
3501
+ type SwitchVariant = 'default' | 'frosted' | 'glass' | 'liquid' | 'matte';
3502
+ /**
3503
+ * Switch 属性
3504
+ */
3505
+ type SwitchProps = ComponentPropsWithoutRef<typeof SwitchPrimitive.Root> & {
3506
+ /**
3507
+ * 视觉变体(默认 'default')
3508
+ */
3509
+ variant?: SwitchVariant;
3510
+ /**
3511
+ * 根节点 ref
3512
+ */
3513
+ ref?: Ref<HTMLButtonElement>;
3514
+ };
3515
+ /**
3516
+ * Switch:玻璃质感开关
3517
+ *
3518
+ * @param props - 组件属性
3519
+ * @returns 开关 JSX
3520
+ */
3521
+ declare function Switch(props: SwitchProps): import("react").JSX.Element;
3522
+ //#endregion
3523
+ //#region src/tabs.d.ts
3524
+ /**
3525
+ * 选项卡视觉变体
3526
+ */
3527
+ type TabsVariant = 'default' | 'ghost' | 'glass' | 'liquid' | 'matte' | 'outline';
3528
+ /**
3529
+ * 选项卡尺寸
3530
+ */
3531
+ type TabsSize = 'lg' | 'md' | 'sm';
3532
+ /**
3533
+ * Tabs:选项卡根
3534
+ */
3535
+ declare const Tabs: import("react").ForwardRefExoticComponent<TabsPrimitive.TabsProps & import("react").RefAttributes<HTMLDivElement>>;
3536
+ /**
3537
+ * TabsList 属性
3538
+ */
3539
+ type TabsListProps = ComponentPropsWithoutRef<typeof TabsPrimitive.List> & {
3540
+ /**
3541
+ * 视觉变体(默认 'default')
3542
+ */
3543
+ variant?: TabsVariant;
3544
+ /**
3545
+ * 尺寸档位(默认 'md')
3546
+ */
3547
+ size?: TabsSize;
3548
+ /**
3549
+ * 列表 ref
3550
+ */
3551
+ ref?: Ref<HTMLDivElement>;
3552
+ };
3553
+ /**
3554
+ * TabsList:选项卡列表容器
3555
+ *
3556
+ * @param props - 组件属性
3557
+ * @returns 列表 JSX
3558
+ */
3559
+ declare function TabsList(props: TabsListProps): import("react").JSX.Element;
3560
+ /**
3561
+ * TabsTrigger 属性
3562
+ */
3563
+ type TabsTriggerProps = ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger> & {
3564
+ /**
3565
+ * 视觉变体(默认 'default')
3566
+ */
3567
+ variant?: TabsVariant;
3568
+ /**
3569
+ * 尺寸档位(默认 'md')
3570
+ */
3571
+ size?: TabsSize;
3572
+ /**
3573
+ * 触发器 ref
3574
+ */
3575
+ ref?: Ref<HTMLButtonElement>;
3576
+ };
3577
+ /**
3578
+ * TabsTrigger:选项卡触发器
3579
+ *
3580
+ * @param props - 组件属性
3581
+ * @returns 触发器 JSX
3582
+ */
3583
+ declare function TabsTrigger(props: TabsTriggerProps): import("react").JSX.Element;
3584
+ /**
3585
+ * TabsContent 属性
3586
+ */
3587
+ type TabsContentProps = ComponentPropsWithoutRef<typeof TabsPrimitive.Content> & {
3588
+ /**
3589
+ * 视觉变体(默认 'default')
3590
+ */
3591
+ variant?: TabsVariant;
3592
+ /**
3593
+ * 尺寸档位(默认 'md')
3594
+ */
3595
+ size?: TabsSize;
3596
+ /**
3597
+ * 内容 ref
3598
+ */
3599
+ ref?: Ref<HTMLDivElement>;
3600
+ };
3601
+ /**
3602
+ * TabsContent:选项卡内容面板
3603
+ *
3604
+ * @param props - 组件属性
3605
+ * @returns 内容 JSX
3606
+ */
3607
+ declare function TabsContent(props: TabsContentProps): import("react").JSX.Element;
3608
+ //#endregion
3609
+ //#region src/text.d.ts
3610
+ /**
3611
+ * 文本尺寸
3612
+ */
3613
+ type TextSize = 'lg' | 'md' | 'sm' | 'xl' | 'xs';
3614
+ /**
3615
+ * 文本着色
3616
+ */
3617
+ type TextTone = 'default' | 'muted' | 'primary';
3618
+ /**
3619
+ * Text 属性
3620
+ */
3621
+ type TextProps = HTMLAttributes<HTMLParagraphElement> & {
3622
+ /**
3623
+ * 尺寸档位(默认 'md')
3624
+ */
3625
+ size?: TextSize;
3626
+ /**
3627
+ * 字重档位
3628
+ */
3629
+ weight?: 'medium' | 'normal' | 'semibold';
3630
+ /**
3631
+ * 着色(默认 'default')
3632
+ */
3633
+ tone?: TextTone;
3634
+ /**
3635
+ * 文本内容
3636
+ */
3637
+ children?: ReactNode;
3638
+ };
3639
+ /**
3640
+ * Text:正文文本
3641
+ *
3642
+ * @param props - 组件属性
3643
+ * @returns 文本 JSX
3644
+ */
3645
+ declare function Text(props: TextProps): import("react").JSX.Element;
3646
+ //#endregion
3647
+ //#region src/text-reveal.d.ts
3648
+ /**
3649
+ * TextReveal 属性
3650
+ */
3651
+ type TextRevealProps = HTMLAttributes<HTMLDivElement> & {
3652
+ /**
3653
+ * 待显现文本(按空格分词)
3654
+ */
3655
+ text: string;
3656
+ /**
3657
+ * 根节点 ref(React 19 ref-as-prop)
3658
+ */
3659
+ ref?: Ref<HTMLDivElement>;
3660
+ };
3661
+ /**
3662
+ * TextReveal:滚动逐词显现文本
3663
+ *
3664
+ * @param props - 组件属性
3665
+ * @returns 显现文本 JSX
3666
+ */
3667
+ declare function TextReveal(props: TextRevealProps): import("react").JSX.Element;
3668
+ //#endregion
3669
+ //#region src/textarea.d.ts
3670
+ /**
3671
+ * 多行输入视觉变体
3672
+ */
3673
+ type TextareaVariant = 'default' | 'filled' | 'frosted' | 'glass' | 'outline';
3674
+ /**
3675
+ * Textarea 属性
3676
+ */
3677
+ type TextareaProps = TextareaHTMLAttributes<HTMLTextAreaElement> & {
3678
+ /**
3679
+ * 视觉变体(默认 'default')
3680
+ */
3681
+ variant?: TextareaVariant;
3682
+ /**
3683
+ * 是否自适应内容高度(默认 false)
3684
+ */
3685
+ autoHeight?: boolean;
3686
+ };
3687
+ /**
3688
+ * Textarea:玻璃质感多行输入
3689
+ *
3690
+ * @param props - 组件属性
3691
+ * @returns 输入 JSX
3692
+ */
3693
+ declare function Textarea(props: TextareaProps): import("react").JSX.Element;
3694
+ //#endregion
3695
+ //#region src/toast.d.ts
3696
+ /**
3697
+ * ToastProvider:轻提示上下文提供者
3698
+ */
3699
+ declare const ToastProvider: import("react").FC<ToastPrimitive.ToastProviderProps>;
3700
+ /**
3701
+ * ToastViewport 属性
3702
+ */
3703
+ type ToastViewportProps = ComponentPropsWithoutRef<typeof ToastPrimitive.Viewport> & {
3704
+ /**
3705
+ * 视口 ref
3706
+ */
3707
+ ref?: Ref<HTMLOListElement>;
3708
+ };
3709
+ /**
3710
+ * ToastViewport:轻提示视口(固定右下角堆叠)
3711
+ *
3712
+ * @param props - 组件属性
3713
+ * @returns 视口 JSX
3714
+ */
3715
+ declare function ToastViewport(props: ToastViewportProps): import("react").JSX.Element;
3716
+ /**
3717
+ * Toast 属性
3718
+ */
3719
+ type ToastProps = ComponentPropsWithoutRef<typeof ToastPrimitive.Root> & {
3720
+ /**
3721
+ * 语义变体(默认 'default')
3722
+ */
3723
+ severity?: 'danger' | 'default' | 'success' | 'warning';
3724
+ /**
3725
+ * 根节点 ref
3726
+ */
3727
+ ref?: Ref<HTMLLIElement>;
3728
+ };
3729
+ /**
3730
+ * Toast:单条轻提示
3731
+ *
3732
+ * @param props - 组件属性
3733
+ * @returns 提示 JSX
3734
+ */
3735
+ declare function Toast(props: ToastProps): import("react").JSX.Element;
3736
+ /**
3737
+ * ToastTitle 属性
3738
+ */
3739
+ type ToastTitleProps = ComponentPropsWithoutRef<typeof ToastPrimitive.Title>;
3740
+ /**
3741
+ * ToastTitle:提示标题
3742
+ *
3743
+ * @param props - 组件属性
3744
+ * @returns 标题 JSX
3745
+ */
3746
+ declare function ToastTitle(props: ToastTitleProps): import("react").JSX.Element;
3747
+ /**
3748
+ * ToastDescription 属性
3749
+ */
3750
+ type ToastDescriptionProps = ComponentPropsWithoutRef<typeof ToastPrimitive.Description>;
3751
+ /**
3752
+ * ToastDescription:提示描述文本
3753
+ *
3754
+ * @param props - 组件属性
3755
+ * @returns 描述 JSX
3756
+ */
3757
+ declare function ToastDescription(props: ToastDescriptionProps): import("react").JSX.Element;
3758
+ /**
3759
+ * ToastAction 属性
3760
+ */
3761
+ type ToastActionProps = ComponentPropsWithoutRef<typeof ToastPrimitive.Action>;
3762
+ /**
3763
+ * ToastAction:提示内操作按钮
3764
+ *
3765
+ * @param props - 组件属性
3766
+ * @returns 按钮 JSX
3767
+ */
3768
+ declare function ToastAction(props: ToastActionProps): import("react").JSX.Element;
3769
+ /**
3770
+ * ToastClose 属性
3771
+ */
3772
+ type ToastCloseProps = ComponentPropsWithoutRef<typeof ToastPrimitive.Close>;
3773
+ /**
3774
+ * ToastClose:提示关闭按钮
3775
+ *
3776
+ * @param props - 组件属性
3777
+ * @returns 按钮 JSX
3778
+ */
3779
+ declare function ToastClose(props: ToastCloseProps): import("react").JSX.Element;
3780
+ //#endregion
3781
+ //#region src/tooltip.d.ts
3782
+ /**
3783
+ * TooltipProvider:提示上下文提供者
3784
+ */
3785
+ declare const TooltipProvider: import("react").FC<TooltipPrimitive.TooltipProviderProps>;
3786
+ /**
3787
+ * Tooltip:提示根
3788
+ */
3789
+ declare const Tooltip: import("react").FC<TooltipPrimitive.TooltipProps>;
3790
+ /**
3791
+ * TooltipTrigger:提示触发器
3792
+ */
3793
+ declare const TooltipTrigger: import("react").ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
3794
+ /**
3795
+ * TooltipContent 属性
3796
+ */
3797
+ type TooltipContentProps = ComponentPropsWithoutRef<typeof TooltipPrimitive.Content> & {
3798
+ /**
3799
+ * 内容 ref
3800
+ */
3801
+ ref?: Ref<HTMLDivElement>;
3802
+ };
3803
+ /**
3804
+ * TooltipContent:提示气泡(portal 挂载)
3805
+ *
3806
+ * @param props - 组件属性
3807
+ * @returns 气泡 JSX
3808
+ */
3809
+ declare function TooltipContent(props: TooltipContentProps): import("react").JSX.Element;
3810
+ //#endregion
3811
+ //#region src/tree.d.ts
3812
+ /**
3813
+ * 树视觉变体
3814
+ */
3815
+ type TreeVariant = 'default' | 'ghost' | 'glass' | 'outline';
3816
+ /**
3817
+ * 徽标颜色变体
3818
+ */
3819
+ type TreeBadgeVariant = 'default' | 'destructive' | 'info' | 'success' | 'warning';
3820
+ /**
3821
+ * 树节点(children 非空视为目录)
3822
+ */
3823
+ type TreeNode = {
3824
+ /**
3825
+ * 展示标签
3826
+ */
3827
+ label: string;
3828
+ /**
3829
+ * 链接地址(提供时渲染为链接)
3830
+ */
3831
+ href?: string;
3832
+ /**
3833
+ * 是否新标签页打开链接
3834
+ */
3835
+ external?: boolean;
3836
+ /**
3837
+ * 标签后的徽标文本
3838
+ */
3839
+ badge?: string;
3840
+ /**
3841
+ * 徽标颜色变体(默认 'default')
3842
+ */
3843
+ badgeVariant?: TreeBadgeVariant;
3844
+ /**
3845
+ * 嵌套子节点(非空数组视为目录)
3846
+ */
3847
+ children?: TreeNode[];
3848
+ /**
3849
+ * 叶子图标自定义覆盖
3850
+ */
3851
+ icon?: ReactNode;
3852
+ };
3853
+ /**
3854
+ * Tree 属性
3855
+ */
3856
+ type TreeProps = HTMLAttributes<HTMLDivElement> & {
3857
+ /**
3858
+ * 视觉变体(默认 'default')
3859
+ */
3860
+ variant?: TreeVariant;
3861
+ /**
3862
+ * 树数据
3863
+ */
3864
+ nodes: TreeNode[];
3865
+ /**
3866
+ * 目录默认是否展开(默认 true)
3867
+ */
3868
+ defaultExpanded?: boolean;
3869
+ /**
3870
+ * 树根 ref(React 19 ref-as-prop)
3871
+ */
3872
+ ref?: Ref<HTMLDivElement>;
3873
+ };
3874
+ /**
3875
+ * 叶子徽标信息(buildFileTree 的 getBadge 回调产出)
3876
+ */
3877
+ type TreeBadgeInfo = {
3878
+ /**
3879
+ * 徽标文本
3880
+ */
3881
+ badge: string;
3882
+ /**
3883
+ * 徽标颜色变体
3884
+ */
3885
+ badgeVariant?: TreeBadgeVariant;
3886
+ };
3887
+ /**
3888
+ * buildFileTree 选项
3889
+ */
3890
+ type BuildFileTreeOptions = {
3891
+ /**
3892
+ * 叶子节点 href 前缀
3893
+ */
3894
+ hrefPrefix?: string;
3895
+ /**
3896
+ * 按文件路径生成徽标的函数
3897
+ */
3898
+ getBadge?: (path: string) => TreeBadgeInfo | null;
3899
+ };
3900
+ /**
3901
+ * Tree:文件树
3902
+ *
3903
+ * @param props - 组件属性
3904
+ * @returns 文件树 JSX
3905
+ */
3906
+ declare function Tree(props: TreeProps): import("react").JSX.Element;
3907
+ /**
3908
+ * buildFileTree:由扁平文件路径列表构建树节点
3909
+ *
3910
+ * @param paths - 文件路径列表(以 / 分段)
3911
+ * @param options - 构建选项(href 前缀/徽标生成)
3912
+ * @returns 树节点列表
3913
+ */
3914
+ declare function buildFileTree(paths: string[], options?: BuildFileTreeOptions): TreeNode[];
3915
+ //#endregion
3916
+ //#region src/typewriter.d.ts
3917
+ /**
3918
+ * 打字机阶段
3919
+ */
3920
+ type TypewriterPhase = 'deleting' | 'idle' | 'pausing' | 'typing';
3921
+ /**
3922
+ * Typewriter 属性
3923
+ */
3924
+ type TypewriterProps = HTMLAttributes<HTMLSpanElement> & {
3925
+ /**
3926
+ * 待打出的文本(单文本模式)
3927
+ */
3928
+ text?: string;
3929
+ /**
3930
+ * 词组列表(多词轮播模式,优先于 text)
3931
+ */
3932
+ words?: string[];
3933
+ /**
3934
+ * 打字每字耗时(毫秒,默认 50)
3935
+ */
3936
+ speed?: number;
3937
+ /**
3938
+ * 删字每字耗时(毫秒,默认 30)
3939
+ */
3940
+ deleteSpeed?: number;
3941
+ /**
3942
+ * 起始延迟(毫秒,默认 0)
3943
+ */
3944
+ delay?: number;
3945
+ /**
3946
+ * 是否显示光标(默认 true)
3947
+ */
3948
+ cursor?: boolean;
3949
+ /**
3950
+ * 光标字符(默认 '|')
3951
+ */
3952
+ cursorChar?: string;
3953
+ /**
3954
+ * 是否循环(默认 false)
3955
+ */
3956
+ loop?: boolean;
3957
+ /**
3958
+ * 词尾停顿时长(毫秒,默认 1500)
3959
+ */
3960
+ pauseDuration?: number;
3961
+ /**
3962
+ * 单词打完回调(每轮触发一次)
3963
+ */
3964
+ onComplete?: () => void;
3965
+ /**
3966
+ * 根节点 ref(React 19 ref-as-prop)
3967
+ */
3968
+ ref?: Ref<HTMLSpanElement>;
3969
+ };
3970
+ /**
3971
+ * Typewriter:逐字打字文本
3972
+ *
3973
+ * @param props - 组件属性
3974
+ * @returns 打字文本 JSX
3975
+ */
3976
+ declare function Typewriter(props: TypewriterProps): import("react").JSX.Element;
3977
+ //#endregion
3978
+ //#region src/use-prefers-reduced-motion.hooks.d.ts
3979
+ /**
3980
+ * usePrefersReducedMotion:读取系统降级动效偏好
3981
+ *
3982
+ * @returns 是否偏好降级动效(SSR 首帧恒为 false)
3983
+ */
3984
+ declare function usePrefersReducedMotion(): boolean;
3985
+ //#endregion
3986
+ //#region src/word-rotate.d.ts
3987
+ /**
3988
+ * 词进出场动画状态
3989
+ */
3990
+ type WordRotateAnimState = 'idle' | 'in' | 'out';
3991
+ /**
3992
+ * WordRotate 属性
3993
+ */
3994
+ type WordRotateProps = HTMLAttributes<HTMLSpanElement> & {
3995
+ /**
3996
+ * 待轮播词组
3997
+ */
3998
+ words: string[];
3999
+ /**
4000
+ * 每词停留时长(毫秒,默认 2500)
4001
+ */
4002
+ duration?: number;
4003
+ /**
4004
+ * 进出场动画时长(毫秒,默认 300)
4005
+ */
4006
+ animationDuration?: number;
4007
+ /**
4008
+ * 根节点 ref(React 19 ref-as-prop)
4009
+ */
4010
+ ref?: Ref<HTMLSpanElement>;
4011
+ };
4012
+ /**
4013
+ * WordRotate:词组循环轮换
4014
+ *
4015
+ * @param props - 组件属性
4016
+ * @returns 轮播词 JSX
4017
+ */
4018
+ declare function WordRotate(props: WordRotateProps): import("react").JSX.Element;
4019
+ //#endregion
4020
+ export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionSize, AccordionTrigger, type AccordionTriggerProps, type AccordionVariant, Alert, AlertDescription, type AlertDescriptionProps, AlertDialog, AlertDialogAction, type AlertDialogActionProps, AlertDialogCancel, type AlertDialogCancelProps, AlertDialogContent, type AlertDialogContentProps, AlertDialogDescription, type AlertDialogDescriptionProps, AlertDialogFooter, type AlertDialogFooterProps, AlertDialogHeader, type AlertDialogHeaderProps, AlertDialogOverlay, type AlertDialogOverlayProps, AlertDialogPortal, type AlertDialogPortalProps, AlertDialogTitle, type AlertDialogTitleProps, AlertDialogTrigger, type AlertProps, AlertTitle, type AlertTitleProps, type AlertVariant, AnimatedGradient, type AnimatedGradientProps, type AnimatedGradientVariant, AuroraBackground, type AuroraBackgroundProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, AvatarStatusDot, type AvatarStatusDotProps, Badge, type BadgeProps, type BadgeSize, type BadgeVariant, BlurFade, type BlurFadeProps, BlurSpotlight, type BlurSpotlightProps, BorderBeam, type BorderBeamProps, type BuildFileTreeOptions, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, type CardTitleProps, Checkbox, type CheckboxProps, type CheckboxSize, type CheckboxVariant, Chip, type ChipProps, type ChipSize, type ChromaticChannelColors, ChromaticText, type ChromaticTextProps, Code, type CodeProps, Command, CommandDialog, type CommandDialogProps, CommandEmpty, type CommandEmptyProps, CommandGroup, type CommandGroupProps, CommandInput, type CommandInputProps, CommandItem, type CommandItemProps, CommandList, type CommandListProps, CommandSeparator, type CommandSeparatorProps, Counter, type CounterProps, DataTable, type DataTableAccessor, type DataTableCellContext, type DataTableColumn, type DataTableProps, type DataTableSortState, DepthCard, type DepthCardProps, DotPattern, type DotPatternProps, Drawer, DropdownMenu, DropdownMenuCheckboxItem, type DropdownMenuCheckboxItemProps, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuRadioGroup, DropdownMenuRadioItem, type DropdownMenuRadioItemProps, DropdownMenuSeparator, type DropdownMenuSeparatorProps, DropdownMenuShortcut, type DropdownMenuShortcutProps, type DropdownMenuSize, DropdownMenuSub, DropdownMenuSubContent, type DropdownMenuSubContentProps, DropdownMenuSubTrigger, type DropdownMenuSubTriggerProps, DropdownMenuTrigger, type DropdownMenuTriggerProps, type DropdownMenuVariant, FloatingPanel, type FloatingPanelProps, GlassBreadcrumb, type GlassBreadcrumbItem, type GlassBreadcrumbProps, GlassCard, GlassCardContent, GlassCardFooter, GlassCardHeader, type GlassCardProps, type GlassCardSectionProps, type GlassCardSize, GlassNavbar, type GlassNavbarElevation, type GlassNavbarProps, type GlassNavbarSize, GlassProgressRing, type GlassProgressRingProps, GlassToggle, type GlassToggleProps, type GlassToggleSize, GlowBorder, type GlowBorderProps, GradientMesh, type GradientMeshProps, Heading, type HeadingLevel, type HeadingProps, HoverCard, HoverCardContent, type HoverCardContentProps, HoverCardTrigger, IconFrame, type IconFrameProps, type IconFrameSize, Input, type InputProps, type InputSize, type InputVariant, Kbd, type KbdProps, Label, type LabelProps, LightLeak, type LightLeakProps, Link, type LinkProps, LiquidButton, type LiquidButtonIntensity, type LiquidButtonProps, MagneticCTA, type MagneticCTAProps, Marquee, type MarqueeDirection, type MarqueeProps, MeteorShower, type MeteorShowerProps, Modal, ModalClose, ModalContent, type ModalContentProps, ModalDescription, type ModalDescriptionProps, ModalFooter, type ModalFooterProps, ModalHeader, type ModalHeaderProps, ModalOverlay, type ModalOverlayProps, ModalPortal, type ModalPortalProps, type ModalSize, ModalTitle, type ModalTitleProps, ModalTrigger, type ModalVariant, type MorphingTabItem, MorphingTabs, type MorphingTabsProps, type MorphingTabsSize, type MorphingTabsVariant, NumberTicker, type NumberTickerProps, OrbitingCircles, type OrbitingCirclesProps, type OrbitingCirclesVariant, ParticleField, type ParticleFieldProps, type ParticleFieldShape, Popover, PopoverAnchor, PopoverClose, PopoverContent, type PopoverContentProps, PopoverTrigger, PrismBorder, type PrismBorderProps, Progress, type ProgressProps, PulsatingButton, type PulsatingButtonProps, type PulsatingButtonSize, type PulsatingButtonVariant, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, RetroGrid, type RetroGridProps, RevealText, type RevealTextDirection, type RevealTextProps, Ripple, RippleButton, type RippleButtonProps, type RippleButtonSize, type RippleButtonVariant, type RippleProps, type RippleVariant, Select, type SelectProps, type SelectVariant, Separator, type SeparatorOrientation, type SeparatorProps, type SeparatorStyle, Sheet, SheetClose, SheetContent, type SheetContentProps, SheetDescription, type SheetDescriptionProps, SheetFooter, type SheetFooterProps, SheetHeader, type SheetHeaderProps, SheetOverlay, type SheetOverlayProps, SheetPortal, type SheetPortalProps, type SheetSide, type SheetSize, SheetTitle, type SheetTitleProps, SheetTrigger, type SheetVariant, ShimmerButton, type ShimmerButtonProps, type ShimmerButtonSize, type ShimmerButtonVariant, Skeleton, type SkeletonProps, type SkeletonVariant, Slider, type SliderProps, Spotlight, SpotlightCard, type SpotlightCardProps, type SpotlightProps, StatusDot, type StatusDotProps, type StatusDotStatus, Switch, type SwitchProps, type SwitchVariant, Table, type TableAlign, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, type TableContextValue, TableEmpty, type TableEmptyProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableLayout, type TableProps, TableRow, type TableRowProps, type TableRowTone, type TableSize, type TableVariant, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsSize, TabsTrigger, type TabsTriggerProps, type TabsVariant, Text, type TextProps, TextReveal, type TextRevealProps, type TextSize, type TextTone, Textarea, type TextareaProps, type TextareaVariant, Toast, ToastAction, type ToastActionProps, ToastClose, type ToastCloseProps, ToastDescription, type ToastDescriptionProps, type ToastProps, ToastProvider, ToastTitle, type ToastTitleProps, ToastViewport, type ToastViewportProps, Tooltip, TooltipContent, type TooltipContentProps, TooltipProvider, TooltipTrigger, Tree, type TreeBadgeInfo, type TreeBadgeVariant, type TreeNode, type TreeProps, type TreeVariant, Typewriter, type TypewriterPhase, type TypewriterProps, WordRotate, type WordRotateAnimState, type WordRotateProps, buildFileTree, cn, usePrefersReducedMotion };