idea-react 3.0.0-alpha.0 → 3.0.0-beta.0

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.
Files changed (76) hide show
  1. package/AGENTS.md +31 -10
  2. package/ReadMe.md +75 -41
  3. package/dist/index.d.mts +451 -100
  4. package/dist/index.d.ts +451 -100
  5. package/dist/index.js +16 -16
  6. package/dist/index.mjs +15 -15
  7. package/dist/style.css +5 -5
  8. package/package.json +7 -8
  9. package/source/Avatar.tsx +65 -12
  10. package/source/Button.tsx +13 -4
  11. package/source/ButtonGroup.tsx +28 -0
  12. package/source/Card.tsx +34 -0
  13. package/source/ClickBoundary.tsx +6 -5
  14. package/source/CloseButton.tsx +23 -0
  15. package/source/CodeBlock.tsx +5 -3
  16. package/source/Countdown.tsx +2 -0
  17. package/source/Drawer.tsx +62 -0
  18. package/source/Editor.tsx +5 -8
  19. package/source/Form/Adorn.tsx +38 -0
  20. package/source/Form/Checkbox.tsx +73 -0
  21. package/source/Form/Chips.tsx +51 -0
  22. package/source/Form/Combobox.tsx +109 -0
  23. package/source/Form/Control.tsx +59 -0
  24. package/source/Form/DatePicker.tsx +89 -0
  25. package/source/Form/Feedback.tsx +29 -0
  26. package/source/Form/FloatingLabel.tsx +15 -0
  27. package/source/Form/InputGroup.tsx +23 -0
  28. package/source/Form/OTP.tsx +48 -0
  29. package/source/Form/PasswordStrength.tsx +157 -0
  30. package/source/Form/Primitives.tsx +46 -0
  31. package/source/Form/Radio.tsx +51 -0
  32. package/source/Form/Range.tsx +65 -0
  33. package/source/Form/Switch.tsx +35 -0
  34. package/source/Form/index.ts +15 -0
  35. package/source/Grid.tsx +92 -0
  36. package/source/HorizontalMarquee/index.tsx +4 -10
  37. package/source/Image.tsx +15 -0
  38. package/source/ListGroup.tsx +103 -0
  39. package/source/LiveTSX.tsx +1 -1
  40. package/source/Loading.tsx +4 -3
  41. package/source/Menu.tsx +99 -1
  42. package/source/MonthCalendar.tsx +60 -22
  43. package/source/NativeDialog/index.tsx +37 -1
  44. package/source/Nav.tsx +52 -0
  45. package/source/Navbar.tsx +58 -1
  46. package/source/Overlay.ts +22 -0
  47. package/source/OverlayBox.tsx +200 -32
  48. package/source/PageNav.tsx +56 -32
  49. package/source/Popover.tsx +36 -0
  50. package/source/ScrollNav/Scroller.tsx +107 -0
  51. package/source/ScrollNav/index.tsx +12 -99
  52. package/source/Select.tsx +66 -55
  53. package/source/ShareBox.tsx +5 -11
  54. package/source/Spinner.tsx +30 -0
  55. package/source/SpinnerButton.tsx +8 -10
  56. package/source/Table.tsx +59 -0
  57. package/source/TableSpinner.tsx +7 -5
  58. package/source/{TextTruncate.tsx → TextTruncate/Content.tsx} +24 -20
  59. package/source/TextTruncate/index.tsx +25 -0
  60. package/source/Time.tsx +7 -33
  61. package/source/TimeDistance.tsx +1 -1
  62. package/source/Timeline/index.tsx +7 -7
  63. package/source/Toast.tsx +120 -29
  64. package/source/ToggleButton.tsx +47 -0
  65. package/source/Tooltip.tsx +32 -0
  66. package/source/TypeEcho/Content.tsx +58 -0
  67. package/source/TypeEcho/index.tsx +14 -0
  68. package/source/UserRank/index.module.less +9 -20
  69. package/source/UserRank/index.tsx +35 -32
  70. package/source/VerticalMarquee/index.module.less +0 -1
  71. package/source/VerticalMarquee/index.tsx +3 -5
  72. package/source/ZodiacBar.tsx +1 -1
  73. package/source/animate.ts +4 -2
  74. package/source/color.ts +3 -5
  75. package/source/index.ts +14 -0
  76. package/source/TypeEcho.tsx +0 -49
package/dist/index.d.mts CHANGED
@@ -1,22 +1,16 @@
1
- import { Component, ComponentPropsWithRef, DetailedHTMLProps, DialogHTMLAttributes, FC, FocusEvent, HTMLAttributes, ImgHTMLAttributes, InputHTMLAttributes, KeyboardEvent, MouseEvent as MouseEvent$1, PropsWithChildren, PropsWithRef, PropsWithoutRef, PureComponent, ReactNode, RefCallback, SyntheticEvent, TimeHTMLAttributes } from "react";
1
+ import { ButtonHTMLAttributes, Component, ComponentPropsWithRef, ComponentPropsWithoutRef, DetailedHTMLProps, DialogHTMLAttributes, FC, FocusEvent, HTMLAttributes, InputHTMLAttributes, KeyboardEvent, MouseEvent as MouseEvent$1, PropsWithChildren, PropsWithRef, PropsWithoutRef, PureComponent, ReactElement, ReactNode, RefCallback, SyntheticEvent, TimeHTMLAttributes } from "react";
2
2
  import { ObservedComponent } from "mobx-react-helper";
3
3
  import { TimeData, Timestamp } from "web-utility";
4
4
  import { Defer } from "iterable-observer";
5
5
  import { LiveProvider } from "react-live";
6
- import { ButtonProps as ButtonProps$1, DropdownButtonProps, DropdownItemProps, NavProps, OverlayTriggerProps, RowProps, SpinnerProps, TableProps, ToastContainerProps } from "react-bootstrap";
7
- import { Color, Variant } from "react-bootstrap/esm/types";
8
6
  import { WrapperProps } from "@react-editor-js/core";
9
7
  import { OutputData } from "@editorjs/editorjs";
10
8
  export declare function animate(name: string): RefCallback<Element>;
11
- export interface AvatarProps extends ImgHTMLAttributes<HTMLImageElement> {
12
- size?: number;
13
- }
14
- export declare const Avatar: FC<AvatarProps>;
15
- export type ComponentTheme = 'primary' | 'accent' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'inverse';
9
+ export type ComponentTheme = 'primary' | 'accent' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'dark' | 'light' | 'inverse';
16
10
  interface ButtonStyleProps {
17
- variant?: 'solid' | 'outline' | 'subtle' | 'text';
11
+ variant?: 'solid' | 'outline' | 'subtle' | 'text' | 'link';
18
12
  theme?: ComponentTheme;
19
- size?: 'sm' | 'lg';
13
+ size?: 'xs' | 'sm' | 'lg';
20
14
  icon?: boolean;
21
15
  styled?: boolean;
22
16
  disabled?: boolean;
@@ -30,6 +24,26 @@ type ButtonAttributes = ComponentPropsWithRef<'button'> & {
30
24
  type ButtonElementAttributes = ButtonAttributes | ButtonLinkAttributes;
31
25
  export type ButtonProps = ButtonStyleProps & ButtonElementAttributes;
32
26
  export declare const Button: FC<ButtonProps>;
27
+ export type AvatarSize = 'xs' | 'sm' | 'lg' | 'xl';
28
+ export type AvatarStatus = 'online' | 'offline' | 'busy' | 'away';
29
+ export interface AvatarProps extends HTMLAttributes<HTMLSpanElement> {
30
+ /**
31
+ * Official size class name suffix, or a custom size in `rem`
32
+ * applied through the `--bs-avatar-size` CSS variable
33
+ */
34
+ size?: AvatarSize | number;
35
+ theme?: ComponentTheme;
36
+ subtle?: boolean;
37
+ src?: string;
38
+ alt?: string;
39
+ status?: AvatarStatus;
40
+ statusLabel?: string;
41
+ }
42
+ export declare const Avatar: FC<AvatarProps>;
43
+ export interface AvatarStackProps extends HTMLAttributes<HTMLDivElement> {
44
+ size?: AvatarSize;
45
+ }
46
+ export declare const AvatarStack: FC<AvatarStackProps>;
33
47
  interface BadgeStyleProps {
34
48
  variant?: 'solid' | 'subtle' | 'outline';
35
49
  theme?: ComponentTheme;
@@ -43,9 +57,22 @@ type BadgeElementAttributes = (ComponentPropsWithRef<'span'> & {
43
57
  }) | BadgeLinkAttributes;
44
58
  export type BadgeProps = BadgeStyleProps & BadgeElementAttributes;
45
59
  export declare const Badge: FC<BadgeProps>;
60
+ export interface ButtonGroupProps extends ComponentPropsWithRef<'div'> {
61
+ vertical?: boolean;
62
+ }
63
+ export declare const ButtonGroup: FC<ButtonGroupProps>;
64
+ export declare const ButtonToolbar: FC<ComponentPropsWithRef<'div'>>;
65
+ export declare const Card: FC<ComponentPropsWithRef<'div'>>;
66
+ export declare const CardGroup: FC<ComponentPropsWithRef<'div'>>;
67
+ export declare const CardImageOverlay: FC<ComponentPropsWithRef<'div'>>;
68
+ export declare const CardHeader: FC<ComponentPropsWithRef<'div'>>;
69
+ export declare const CardBody: FC<ComponentPropsWithRef<'div'>>;
70
+ export declare const CardFooter: FC<ComponentPropsWithRef<'div'>>;
71
+ export declare const CardTitle: FC<ComponentPropsWithRef<'h3'>>;
72
+ export declare const CardText: FC<ComponentPropsWithRef<'p'>>;
46
73
  export type ClickBoundaryProps = PropsWithChildren<{
47
- onInnerClick?: (event: MouseEvent) => any;
48
- onOuterClick?: (event: MouseEvent) => any;
74
+ onInnerClick?: (event: MouseEvent) => unknown;
75
+ onOuterClick?: (event: MouseEvent) => unknown;
49
76
  } & DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
50
77
  export declare class ClickBoundary extends PureComponent<ClickBoundaryProps> {
51
78
  root: import("react").RefObject<HTMLDivElement>;
@@ -54,13 +81,17 @@ export declare class ClickBoundary extends PureComponent<ClickBoundaryProps> {
54
81
  componentWillUnmount(): void;
55
82
  render(): import("react").JSX.Element;
56
83
  }
84
+ export interface CloseButtonProps extends ComponentPropsWithRef<'button'> {
85
+ dismiss?: string;
86
+ }
87
+ export declare const CloseButton: FC<CloseButtonProps>;
57
88
  export interface CodeBlockProps extends HTMLAttributes<HTMLPreElement> {
58
89
  language: string;
59
90
  }
60
91
  export declare const CodeBlock: FC<CodeBlockProps>;
61
- export type VariantColor = Exclude<Color, 'white' | 'muted'>;
92
+ export type VariantColor = ComponentTheme;
62
93
  export declare const VariantColors: VariantColor[];
63
- export declare function text2color(raw: string, excludeColors?: VariantColor[]): VariantColor;
94
+ export declare function text2color(raw: string, excludeColors?: VariantColor[]): ComponentTheme;
64
95
  export interface TimeUnit {
65
96
  scale: number;
66
97
  label: string;
@@ -104,6 +135,45 @@ export declare class Dialog<I extends object = {}, O = any> {
104
135
  constructor(Factory: FC<I & DialogProps<O>>);
105
136
  open(input?: I): Promise<O>;
106
137
  }
138
+ export interface NativeDialogProps extends Omit<DialogHTMLAttributes<HTMLDialogElement>, 'open'> {
139
+ modal?: boolean;
140
+ dialog?: boolean;
141
+ theme?: 'light' | 'dark';
142
+ keyboard?: boolean;
143
+ backdrop?: boolean | 'static';
144
+ open?: boolean;
145
+ }
146
+ export declare const DialogHeader: FC<ComponentPropsWithRef<'div'>>;
147
+ export declare const DialogTitle: FC<ComponentPropsWithRef<'h1'>>;
148
+ export declare const DialogBody: FC<ComponentPropsWithRef<'div'>>;
149
+ export declare const DialogFooter: FC<ComponentPropsWithRef<'div'>>;
150
+ export declare class NativeDialog extends Component<NativeDialogProps> {
151
+ element: import("react").RefObject<HTMLDialogElement>;
152
+ returnFocus?: HTMLElement;
153
+ get open(): boolean;
154
+ componentDidMount(): void;
155
+ componentDidUpdate({ open }: NativeDialogProps): void;
156
+ show: () => void;
157
+ close: () => void;
158
+ componentWillUnmount(): void;
159
+ handleCancel: (event: SyntheticEvent<HTMLDialogElement>) => void;
160
+ handleKeyDown: (event: KeyboardEvent<HTMLDialogElement>) => void;
161
+ handleClick: (event: MouseEvent$1<HTMLDialogElement>) => void;
162
+ render(): import("react").JSX.Element;
163
+ }
164
+ export type DrawerPlacement = 'start' | 'end' | 'top' | 'bottom';
165
+ export declare const DrawerHeader: FC<ComponentPropsWithRef<'div'>>;
166
+ export declare const DrawerTitle: FC<ComponentPropsWithRef<'h5'>>;
167
+ export declare const DrawerBody: FC<ComponentPropsWithRef<'div'>>;
168
+ export declare const DrawerFooter: FC<ComponentPropsWithRef<'div'>>;
169
+ export interface DrawerProps extends Omit<NativeDialogProps, 'dialog' | 'onClose' | 'title'> {
170
+ title?: ReactNode;
171
+ placement?: DrawerPlacement;
172
+ footer?: ReactNode;
173
+ bodyClassName?: string;
174
+ onDismiss?: () => void;
175
+ }
176
+ export declare const Drawer: FC<DrawerProps>;
107
177
  export type EditorProps = PropsWithoutRef<WrapperProps & Pick<InputHTMLAttributes<HTMLInputElement>, 'name' | 'required'>>;
108
178
  export declare class Editor extends Component<EditorProps> {
109
179
  static displayName: string;
@@ -120,6 +190,176 @@ export interface EditorHTMLProps extends HTMLAttributes<HTMLDivElement> {
120
190
  data: OutputData;
121
191
  }
122
192
  export declare const EditorHTML: FC<EditorHTMLProps>;
193
+ export type FormAdornmentProps = Omit<ComponentPropsWithRef<'label'>, 'htmlFor'> & {
194
+ end?: boolean;
195
+ size?: 'sm' | 'lg';
196
+ htmlFor?: string;
197
+ };
198
+ export declare const FormAdornment: FC<FormAdornmentProps>;
199
+ export type FormAdornmentTextProps = ComponentPropsWithRef<'span'>;
200
+ export declare const FormAdornmentText: FC<FormAdornmentTextProps>;
201
+ export type FormGhostProps = ComponentPropsWithRef<'input'>;
202
+ export declare const FormGhost: FC<FormGhostProps>;
203
+ export type CheckboxProps = Omit<ComponentPropsWithoutRef<'input'>, 'type' | 'size'> & {
204
+ size?: 'sm' | 'lg';
205
+ theme?: ComponentTheme;
206
+ indeterminate?: boolean;
207
+ };
208
+ export declare const Checkbox: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "size" | "type"> & {
209
+ size?: "sm" | "lg";
210
+ theme?: ComponentTheme;
211
+ indeterminate?: boolean;
212
+ } & import("react").RefAttributes<HTMLInputElement>>;
213
+ export type ChipProps = ComponentPropsWithRef<'button'> & {
214
+ active?: boolean;
215
+ theme?: ComponentTheme;
216
+ };
217
+ export declare const Chip: FC<ChipProps>;
218
+ export type ChipInputProps = ComponentPropsWithRef<'div'> & {
219
+ theme?: ComponentTheme;
220
+ separator?: string;
221
+ allowDuplicates?: boolean;
222
+ maxChips?: number;
223
+ createOnBlur?: boolean;
224
+ };
225
+ export declare const ChipInput: FC<ChipInputProps>;
226
+ export interface ComboboxOptionProps extends ComponentPropsWithRef<'button'> {
227
+ value: string;
228
+ }
229
+ export declare const ComboboxOption: FC<ComboboxOptionProps>;
230
+ export interface ComboboxProps extends Omit<ComponentPropsWithRef<'div'>, 'onChange'> {
231
+ name: string;
232
+ value: string | string[];
233
+ placeholder?: string;
234
+ multiple?: boolean;
235
+ menuClassName?: string;
236
+ disabled?: boolean;
237
+ onChange?: (value: string | string[]) => unknown;
238
+ }
239
+ export declare const Combobox: FC<ComboboxProps>;
240
+ export type FormControlProps = ComponentPropsWithRef<'input'> & {
241
+ plaintext?: boolean;
242
+ ghost?: boolean;
243
+ caret?: boolean;
244
+ color?: boolean;
245
+ controlSize?: 'sm' | 'lg';
246
+ };
247
+ export declare const FormControl: FC<FormControlProps>;
248
+ export type FormTextAreaProps = ComponentPropsWithRef<'textarea'>;
249
+ export declare const FormTextArea: FC<FormTextAreaProps>;
250
+ export type FormSelectProps = ComponentPropsWithRef<'select'> & {
251
+ controlSize?: 'sm' | 'lg';
252
+ };
253
+ export declare const FormSelect: FC<FormSelectProps>;
254
+ export type DatePickerProps = Omit<ComponentPropsWithoutRef<'input'>, 'type'> & {
255
+ enhanced?: boolean;
256
+ inline?: boolean;
257
+ selectionMode?: 'single' | 'multiple' | 'multiple-ranged';
258
+ };
259
+ export declare const DatePicker: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "type"> & {
260
+ enhanced?: boolean;
261
+ inline?: boolean;
262
+ selectionMode?: "single" | "multiple" | "multiple-ranged";
263
+ } & import("react").RefAttributes<HTMLInputElement>>;
264
+ export type FormTextProps = ComponentPropsWithRef<'small'>;
265
+ export declare const FormText: FC<FormTextProps>;
266
+ export type FormFeedbackProps = Omit<ComponentPropsWithRef<'div'>, 'type'> & {
267
+ type?: 'valid' | 'invalid';
268
+ tooltip?: boolean;
269
+ };
270
+ export declare const FormFeedback: FC<FormFeedbackProps>;
271
+ export type FormFloatingLabelProps = ComponentPropsWithRef<'div'> & {
272
+ always?: boolean;
273
+ };
274
+ export declare const FormFloatingLabel: FC<FormFloatingLabelProps>;
275
+ export type InputGroupProps = ComponentPropsWithRef<'div'> & {
276
+ size?: 'sm' | 'lg';
277
+ };
278
+ export declare const InputGroup: FC<InputGroupProps>;
279
+ export type InputGroupTextProps = ComponentPropsWithRef<'span'>;
280
+ export declare const InputGroupText: FC<InputGroupTextProps>;
281
+ export type OTPInputProps = Omit<ComponentPropsWithRef<'input'>, 'type' | 'maxLength'> & {
282
+ length: number;
283
+ type?: 'numeric' | 'alphanumeric' | 'alpha';
284
+ mask?: boolean;
285
+ groups?: number[];
286
+ separator?: string;
287
+ connected?: boolean;
288
+ size?: 'sm' | 'lg';
289
+ };
290
+ export declare const OTPInput: FC<OTPInputProps>;
291
+ export type PasswordStrengthLevel = 'weak' | 'fair' | 'good' | 'strong';
292
+ export interface PasswordStrengthProps extends ComponentPropsWithoutRef<'div'> {
293
+ input?: string | HTMLInputElement | null;
294
+ variant?: 'segments' | 'bar';
295
+ minLength?: number;
296
+ messages?: Partial<Record<PasswordStrengthLevel, string>>;
297
+ weights?: Record<string, number>;
298
+ thresholds?: number[];
299
+ scorer?: (password: string) => number;
300
+ }
301
+ export declare const PasswordStrength: import("react").ForwardRefExoticComponent<PasswordStrengthProps & import("react").RefAttributes<HTMLDivElement>>;
302
+ export type FormProps = ComponentPropsWithRef<'form'>;
303
+ export declare const Form: FC<FormProps>;
304
+ export type FormFieldsetProps = ComponentPropsWithRef<'fieldset'>;
305
+ export declare const FormFieldset: FC<FormFieldsetProps>;
306
+ export type FormFieldProps = ComponentPropsWithRef<'div'>;
307
+ export declare const FormField: FC<FormFieldProps>;
308
+ export type FormGroupProps = ComponentPropsWithRef<'div'>;
309
+ export declare const FormGroup: FC<FormGroupProps>;
310
+ export type FormFieldContentProps = ComponentPropsWithRef<'div'>;
311
+ export declare const FormFieldContent: FC<FormFieldContentProps>;
312
+ export type FormLabelProps = ComponentPropsWithRef<'label'>;
313
+ export declare const FormLabel: FC<FormLabelProps>;
314
+ export type RadioProps = Omit<ComponentPropsWithRef<'input'>, 'type' | 'size'> & {
315
+ size?: 'sm' | 'lg';
316
+ theme?: ComponentTheme;
317
+ };
318
+ export declare const Radio: FC<RadioProps>;
319
+ export type FormCheckProps = Omit<ComponentPropsWithRef<'input'>, 'type' | 'size'> & {
320
+ type?: 'checkbox' | 'radio';
321
+ size?: 'sm' | 'lg';
322
+ theme?: ComponentTheme;
323
+ };
324
+ export declare const FormCheck: FC<FormCheckProps>;
325
+ export type FormRangeProps = Omit<ComponentPropsWithRef<'input'>, 'type'> & {
326
+ bubble?: boolean;
327
+ theme?: ComponentTheme;
328
+ };
329
+ export declare const FormRange: FC<FormRangeProps>;
330
+ export type FormSwitchProps = Omit<ComponentPropsWithRef<'label'>, 'children'> & PropsWithChildren<{
331
+ inputProps?: Omit<ComponentPropsWithRef<'input'>, 'type'>;
332
+ size?: 'sm' | 'lg';
333
+ theme?: ComponentTheme;
334
+ }>;
335
+ export declare const FormSwitch: FC<FormSwitchProps>;
336
+ export type Breakpoint = 'sm' | 'md' | 'lg' | 'xl' | '2xl';
337
+ export type ColSize = number | 'auto';
338
+ export type BreakpointColSize = ColSize | true;
339
+ export interface ContainerProps extends ComponentPropsWithRef<'div'> {
340
+ fluid?: boolean;
341
+ breakpoint?: Breakpoint;
342
+ }
343
+ export declare const Container: FC<ContainerProps>;
344
+ export type RowCols = number | 'auto';
345
+ export interface RowProps extends ComponentPropsWithRef<'div'> {
346
+ cols?: RowCols;
347
+ sm?: RowCols;
348
+ md?: RowCols;
349
+ lg?: RowCols;
350
+ xl?: RowCols;
351
+ '2xl'?: RowCols;
352
+ }
353
+ export declare const Row: FC<RowProps>;
354
+ export interface ColProps extends ComponentPropsWithRef<'div'> {
355
+ span?: ColSize;
356
+ sm?: BreakpointColSize;
357
+ md?: BreakpointColSize;
358
+ lg?: BreakpointColSize;
359
+ xl?: BreakpointColSize;
360
+ '2xl'?: BreakpointColSize;
361
+ }
362
+ export declare const Col: FC<ColProps>;
123
363
  export type HorizontalMarqueeProps = HTMLAttributes<HTMLDivElement> & Partial<Record<'maxWidth' | 'duration' | 'height', string>>;
124
364
  export declare const HorizontalMarquee: FC<HorizontalMarqueeProps>;
125
365
  export declare const HorizontalMarqueeBox: FC<HorizontalMarqueeProps>;
@@ -128,11 +368,62 @@ export type IconProps = PropsWithRef<HTMLAttributes<HTMLSpanElement> & {
128
368
  size?: number;
129
369
  }>;
130
370
  export declare const Icon: FC<IconProps>;
371
+ export interface ImageProps extends ComponentPropsWithRef<'img'> {
372
+ fluid?: boolean;
373
+ thumbnail?: boolean;
374
+ }
375
+ export declare const Image: FC<ImageProps>;
376
+ export type ListGroupHorizontal = boolean | Breakpoint;
377
+ export interface ListGroupProps extends ComponentPropsWithRef<'ul'> {
378
+ flush?: boolean;
379
+ numbered?: boolean;
380
+ horizontal?: ListGroupHorizontal;
381
+ }
382
+ export declare const ListGroup: FC<ListGroupProps>;
383
+ interface ListGroupItemStyleProps {
384
+ theme?: ComponentTheme;
385
+ action?: boolean;
386
+ active?: boolean;
387
+ disabled?: boolean;
388
+ }
389
+ type ListGroupItemLinkAttributes = ComponentPropsWithRef<'a'> & {
390
+ href: string;
391
+ };
392
+ type ListGroupItemButtonAttributes = ComponentPropsWithRef<'button'> & {
393
+ href?: never;
394
+ };
395
+ type ListGroupItemAttributes = ComponentPropsWithRef<'li'> & {
396
+ href?: never;
397
+ type?: never;
398
+ };
399
+ type ListGroupItemElementAttributes = ListGroupItemLinkAttributes | ListGroupItemButtonAttributes | ListGroupItemAttributes;
400
+ export type ListGroupItemProps = ListGroupItemStyleProps & ListGroupItemElementAttributes;
401
+ export declare const ListGroupItem: FC<ListGroupItemProps>;
131
402
  export type LiveTSXProps = Pick<Parameters<typeof LiveProvider>[0], 'scope' | 'children'>;
132
403
  export declare const LiveTSX: FC<LiveTSXProps>;
133
404
  export type LoadingProps = HTMLAttributes<HTMLDivElement>;
134
405
  export declare const Loading: FC<LoadingProps>;
135
406
  export declare const MenuItem: FC<ButtonProps>;
407
+ export declare const MenuPanel: FC<HTMLAttributes<HTMLDivElement>>;
408
+ export declare const MenuText: FC<HTMLAttributes<HTMLSpanElement>>;
409
+ export declare const MenuHeader: FC<HTMLAttributes<HTMLHeadingElement>>;
410
+ export declare const MenuDivider: FC<HTMLAttributes<HTMLHRElement>>;
411
+ export declare const MenuItemContent: FC<HTMLAttributes<HTMLSpanElement>>;
412
+ export declare const MenuItemDescription: FC<HTMLAttributes<HTMLElement>>;
413
+ export interface MenuSubmenuProps extends PropsWithChildren {
414
+ label: ReactNode;
415
+ className?: string;
416
+ }
417
+ export declare class MenuSubmenu extends Component<MenuSubmenuProps> {
418
+ accessor open: boolean;
419
+ panel: import("react").RefObject<HTMLDivElement>;
420
+ setOpen: (open: boolean) => void;
421
+ handleClick: () => void;
422
+ handleMouseEnter: () => void;
423
+ handleMouseLeave: () => void;
424
+ handleKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
425
+ render(): import("react").JSX.Element;
426
+ }
136
427
  export interface MenuProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
137
428
  label: ReactNode;
138
429
  autoClose?: boolean | 'inside' | 'outside';
@@ -164,11 +455,12 @@ export interface DateData {
164
455
  content: ReactNode;
165
456
  link?: string;
166
457
  }
167
- export interface MonthCalendarProps extends Omit<TableProps, 'variant' | 'onChange' | 'onSelect'>, Pick<ButtonProps$1, 'variant'> {
458
+ export interface MonthCalendarProps extends Omit<HTMLAttributes<HTMLTableElement>, 'onChange' | 'onSelect'> {
168
459
  locale?: Navigator['language'];
460
+ theme?: ComponentTheme;
169
461
  value?: DateData[];
170
- onSelect?: (value: DateData) => any;
171
- onChange?: (date: Date) => any;
462
+ onSelect?: (value: DateData) => unknown;
463
+ onChange?: (date: Date) => void;
172
464
  }
173
465
  /**
174
466
  * Re-implement from https://github.com/EasyWebApp/BootCell/blob/3d30027a97fe0a8c4ab8fabc8dfef22aede04de7/source/Calendar/MonthCalendar.tsx
@@ -179,6 +471,9 @@ export declare class MonthCalendar extends ObservedComponent<MonthCalendarProps>
179
471
  accessor currentDate: Date;
180
472
  get dateGrid(): Date[][];
181
473
  changeMonth(delta: number): void;
474
+ changePreviousMonth: () => void;
475
+ changeNextMonth: () => void;
476
+ handleCellClick: ({ target, currentTarget }: MouseEvent$1<HTMLTableCellElement>) => void;
182
477
  renderDate: (date: Date) => import("react").JSX.Element;
183
478
  render(): import("react").JSX.Element;
184
479
  }
@@ -187,39 +482,82 @@ export type NameplateProps = PropsWithoutRef<{
187
482
  name: string;
188
483
  }>;
189
484
  export declare const Nameplate: FC<NameplateProps>;
190
- export interface NativeDialogProps extends Omit<DialogHTMLAttributes<HTMLDialogElement>, 'open'> {
191
- modal?: boolean;
192
- keyboard?: boolean;
193
- backdrop?: boolean | 'static';
194
- }
195
- export declare class NativeDialog extends Component<NativeDialogProps> {
196
- element: import("react").RefObject<HTMLDialogElement>;
197
- returnFocus?: HTMLElement;
198
- get open(): boolean;
199
- show: () => void;
200
- close: () => void;
201
- componentWillUnmount(): void;
202
- handleCancel: (event: SyntheticEvent<HTMLDialogElement>) => void;
203
- handleKeyDown: (event: KeyboardEvent<HTMLDialogElement>) => void;
204
- handleClick: (event: MouseEvent$1<HTMLDialogElement>) => void;
205
- render(): import("react").JSX.Element;
485
+ export interface NavProps extends ComponentPropsWithRef<'nav'> {
486
+ variant?: 'tabs' | 'pills' | 'underline';
487
+ vertical?: boolean;
488
+ fill?: boolean;
489
+ justified?: boolean;
490
+ }
491
+ export declare const Nav: FC<NavProps>;
492
+ export declare const NavItem: FC<ComponentPropsWithRef<'li'>>;
493
+ export interface NavLinkProps extends ComponentPropsWithRef<'a'> {
494
+ disabled?: boolean;
206
495
  }
496
+ export declare const NavLink: FC<NavLinkProps>;
207
497
  export interface NavbarProps extends ComponentPropsWithRef<'nav'> {
498
+ theme?: 'light' | 'dark';
208
499
  expand?: boolean | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
209
500
  }
210
501
  export declare const Navbar: FC<NavbarProps>;
211
- export interface OverlayBoxProps extends Omit<OverlayTriggerProps, 'overlay'> {
502
+ export type NavbarBrandProps = (ComponentPropsWithRef<'a'> & {
503
+ as?: 'a';
504
+ }) | (ComponentPropsWithRef<'span'> & {
505
+ as: 'span';
506
+ });
507
+ export declare const NavbarBrand: FC<NavbarBrandProps>;
508
+ export declare const NavbarNav: FC<ComponentPropsWithRef<'ul'>>;
509
+ export declare const NavbarText: FC<ComponentPropsWithRef<'span'>>;
510
+ export interface NavbarTogglerProps extends Omit<ComponentPropsWithRef<'button'>, 'children' | 'type'> {
511
+ expanded?: boolean;
512
+ }
513
+ export declare const NavbarToggler: FC<NavbarTogglerProps>;
514
+ type OverlayPlacement = 'top' | 'right' | 'bottom' | 'left';
515
+ interface OverlayTriggerProps extends ComponentPropsWithRef<'div'> {
516
+ placement?: OverlayPlacement;
517
+ show?: boolean;
518
+ }
519
+ export type OverlayTrigger = 'click' | 'focus' | 'hover';
520
+ export interface OverlayBoxProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'children' | 'title'> {
212
521
  title: ReactNode;
213
522
  detail?: ReactNode;
523
+ placement?: OverlayPlacement;
524
+ trigger?: OverlayTrigger | OverlayTrigger[];
525
+ delay?: number | {
526
+ show: number;
527
+ hide: number;
528
+ };
529
+ overlayClassName?: string;
530
+ children: ReactElement<{
531
+ 'aria-describedby'?: string;
532
+ }>;
533
+ }
534
+ export declare class OverlayBox extends Component<OverlayBoxProps> {
535
+ static displayName: string;
536
+ accessor open: boolean;
537
+ id: string;
538
+ root: import("react").RefObject<HTMLSpanElement>;
539
+ timer?: ReturnType<typeof setTimeout>;
540
+ setOpen: (open: boolean) => boolean;
541
+ hide: () => void;
542
+ setOpenAfterDelay: (open: boolean) => boolean;
543
+ componentWillUnmount(): void;
544
+ componentDidMount(): void;
545
+ hasTrigger: (trigger: OverlayTrigger) => boolean;
546
+ handleMouseEnter: (event: MouseEvent$1<HTMLSpanElement>) => void;
547
+ handleMouseLeave: (event: MouseEvent$1<HTMLSpanElement>) => void;
548
+ handleFocus: (event: FocusEvent<HTMLSpanElement>) => void;
549
+ handleBlur: (event: FocusEvent<HTMLSpanElement>) => void;
550
+ handleClick: (event: MouseEvent$1<HTMLSpanElement>) => void;
551
+ handleOutside: ({ target }: PointerEvent) => void;
552
+ handleKeyDown: (event: KeyboardEvent<HTMLSpanElement>) => void;
553
+ render(): import("react").JSX.Element;
214
554
  }
215
- /**
216
- * ToDo: {@link https://react-bootstrap.github.io/docs/components/overlays#disabled-elements}
217
- */
218
- export declare const OverlayBox: FC<OverlayBoxProps>;
219
555
  type HeadingMeta = Record<'id' | 'text', string> & Record<'level' | 'top', number>;
220
556
  export interface PageNavProps extends NavProps {
221
557
  depth?: number;
222
- onItemClick?: (item: HeadingMeta) => any;
558
+ minDepth?: number;
559
+ rootSelector?: string;
560
+ onItemClick?: (item: HeadingMeta) => void;
223
561
  }
224
562
  export declare class PageNav extends Component<PageNavProps> {
225
563
  static displayName: string;
@@ -228,11 +566,17 @@ export declare class PageNav extends Component<PageNavProps> {
228
566
  get currentActiveId(): string;
229
567
  updateScrollY: () => number;
230
568
  componentDidMount(): void;
569
+ static slugOf(text: string): string;
570
+ initList(): void;
231
571
  componentWillUnmount(): void;
232
572
  scrollTo: (meta: HeadingMeta) => () => void;
233
573
  renderLink: ({ id, level, text, top }: HeadingMeta) => import("react").JSX.Element;
234
574
  render(): import("react").JSX.Element;
235
575
  }
576
+ export interface PopoverProps extends Omit<OverlayTriggerProps, 'title'> {
577
+ title?: ReactNode;
578
+ }
579
+ export declare const Popover: FC<PopoverProps>;
236
580
  export type ScrollNavProps = NavProps;
237
581
  /**
238
582
  * A horizontal scrolling navigation bar based on Bootstrap's `nav-scroller` pattern.
@@ -240,29 +584,18 @@ export type ScrollNavProps = NavProps;
240
584
  *
241
585
  * @see {@link https://github.com/twbs/bootstrap/blob/main/site/src/assets/examples/offcanvas-navbar/index.astro#L50-L65}
242
586
  */
243
- export declare class ScrollNav extends Component<ScrollNavProps> {
244
- static displayName: string;
245
- scrollerRef: import("react").RefObject<HTMLDivElement>;
246
- accessor scrollLeft: number;
247
- accessor scrollWidth: number;
248
- accessor clientWidth: number;
249
- get canScrollLeft(): boolean;
250
- get canScrollRight(): boolean;
251
- updateScroll: () => HTMLDivElement;
252
- private resizeObserver?;
253
- componentDidMount(): void;
254
- componentWillUnmount(): void;
255
- scrollBy: (direction: -1 | 1) => () => void;
256
- render(): import("react").JSX.Element;
257
- }
258
- export interface OptionProps extends DropdownItemProps {
587
+ export declare const ScrollNav: FC<ScrollNavProps>;
588
+ export interface OptionProps extends ButtonHTMLAttributes<HTMLButtonElement> {
259
589
  value?: string;
260
590
  }
261
591
  export declare const Option: FC<OptionProps>;
262
- export interface SelectProps extends Omit<OptionProps, 'onChange'>, Pick<DropdownButtonProps, 'variant' | 'menuVariant'> {
263
- onChange?: (value: string) => any;
592
+ export type SelectProps = Pick<ButtonProps, 'className' | 'style' | 'size' | 'theme' | 'variant' | 'disabled' | 'children'> & {
593
+ align?: 'start' | 'end';
594
+ menuClassName?: string;
595
+ value?: string;
596
+ onChange?: (value: string) => void;
264
597
  valueRender?: (value: string) => ReactNode;
265
- }
598
+ };
266
599
  export declare const Select: FC<SelectProps>;
267
600
  export declare function elementToImage(element: HTMLElement, type?: string, quality?: number): Promise<string>;
268
601
  export type ShareBoxProps = HTMLAttributes<HTMLDivElement> & ShareData;
@@ -277,11 +610,28 @@ export declare class ShareBox extends Component<ShareBoxProps> {
277
610
  share: (event: MouseEvent$1<HTMLImageElement>) => Promise<void>;
278
611
  render(): import("react").JSX.Element;
279
612
  }
280
- export interface SpinnerButtonProps extends ButtonProps$1, Pick<SpinnerProps, 'animation'> {
281
- loading?: boolean;
613
+ export type SpinnerAnimation = 'border' | 'grow';
614
+ export interface SpinnerProps extends ComponentPropsWithRef<'span'> {
615
+ animation?: SpinnerAnimation;
616
+ size?: 'sm';
617
+ theme?: ComponentTheme;
282
618
  }
619
+ export declare const Spinner: FC<SpinnerProps>;
620
+ export type SpinnerButtonProps = ButtonProps & Pick<SpinnerProps, 'animation'> & {
621
+ loading?: boolean;
622
+ };
283
623
  export declare const SpinnerButton: FC<SpinnerButtonProps>;
284
- export interface TableSpinnerProps extends HTMLAttributes<HTMLTableRowElement>, Pick<SpinnerProps, 'animation' | 'variant' | 'size'> {
624
+ export interface TableProps extends ComponentPropsWithRef<'table'> {
625
+ striped?: boolean;
626
+ stripedColumns?: boolean;
627
+ hover?: boolean;
628
+ bordered?: boolean;
629
+ borderless?: boolean;
630
+ small?: boolean;
631
+ responsive?: boolean | Breakpoint;
632
+ }
633
+ export declare const Table: FC<TableProps>;
634
+ export interface TableSpinnerProps extends HTMLAttributes<HTMLTableRowElement>, Pick<SpinnerProps, 'animation' | 'theme' | 'size'> {
285
635
  colSpan: number;
286
636
  }
287
637
  export declare const TableSpinner: FC<TableSpinnerProps>;
@@ -290,29 +640,12 @@ export interface TextTruncateProps extends HTMLAttributes<HTMLDivElement> {
290
640
  expandText?: ReactNode;
291
641
  collapseText?: ReactNode;
292
642
  }
293
- export declare class TextTruncate extends Component<TextTruncateProps> {
294
- static displayName: string;
295
- accessor expanded: boolean;
296
- accessor overflowed: boolean;
297
- contentRef: import("react").RefObject<HTMLParagraphElement>;
298
- componentDidMount(): void;
299
- componentDidUpdate({ rows, children }: TextTruncateProps): void;
300
- componentWillUnmount(): void;
301
- checkOverflow: () => void;
302
- toggle: () => void;
303
- render(): import("react").JSX.Element;
304
- }
643
+ export declare const TextTruncate: FC<TextTruncateProps>;
305
644
  export interface TimeProps extends Omit<TimeHTMLAttributes<HTMLTimeElement>, 'dateTime'> {
306
645
  dateTime: TimeData;
307
646
  format?: string;
308
647
  }
309
- export declare class Time extends ObservedComponent<TimeProps> {
310
- static displayName: string;
311
- updateText(): string;
312
- accessor timeText: string;
313
- componentDidMount(): void;
314
- render(): import("react").JSX.Element;
315
- }
648
+ export declare const Time: FC<TimeProps>;
316
649
  export interface TimeDistanceProps extends HTMLAttributes<HTMLTimeElement> {
317
650
  date: TimeData;
318
651
  unitWords?: Record<string, string>;
@@ -335,37 +668,60 @@ export interface TimelineProps extends HTMLAttributes<HTMLOListElement> {
335
668
  * @see {@link https://mdbootstrap.com/docs/standard/extended/timeline/#section-timeline-gradient-bg}
336
669
  */
337
670
  export declare const Timeline: FC<TimelineProps>;
671
+ export type ToastPosition = 'top-start' | 'top-center' | 'top-end' | 'middle-start' | 'middle-center' | 'middle-end' | 'bottom-start' | 'bottom-center' | 'bottom-end';
338
672
  export interface ToastMessage {
339
673
  id?: string;
340
674
  title?: ReactNode;
341
675
  body: ReactNode;
342
- variant?: Variant;
676
+ theme?: ComponentTheme;
343
677
  delay?: number;
344
678
  }
345
- interface ToastItem extends ToastMessage {
679
+ interface ToastEntry extends ToastMessage {
346
680
  openedAt: number;
347
681
  closedAt?: number;
348
- resolve?: (value: ToastItem) => void;
682
+ timer?: ReturnType<typeof setTimeout>;
683
+ resolve?: (value: ToastEntry) => void;
684
+ }
685
+ export interface ToastContainerProps extends ComponentPropsWithRef<'div'> {
686
+ position?: ToastPosition | 'static';
349
687
  }
688
+ export declare const ToastContainer: FC<ToastContainerProps>;
689
+ export interface ToastItemProps extends ComponentPropsWithRef<'div'> {
690
+ theme?: ComponentTheme;
691
+ }
692
+ export declare const ToastItem: FC<ToastItemProps>;
693
+ export declare const ToastHeader: FC<ComponentPropsWithRef<'div'>>;
694
+ export declare const ToastBody: FC<ComponentPropsWithRef<'div'>>;
350
695
  export declare class Toast {
351
696
  TimeScalar: typeof Timestamp;
352
- accessor messages: ToastItem[];
353
- Component: FC<Pick<ToastContainerProps, 'position'>>;
354
- renderMessage: ({ id, openedAt, title, body, variant, delay }: ToastItem) => import("react").JSX.Element;
697
+ accessor messages: ToastEntry[];
698
+ Component: FC<{
699
+ position?: ToastPosition;
700
+ }>;
701
+ renderMessage: ({ id, openedAt, title, body, theme, delay }: ToastEntry) => import("react").JSX.Element;
702
+ handleDismiss: ({ target }: MouseEvent$1<HTMLDivElement>) => void;
355
703
  constructor(TimeScalar?: typeof Timestamp);
356
- open(message: ToastMessage): Promise<ToastItem>;
704
+ open(message: ToastMessage): Promise<ToastEntry>;
357
705
  close(id: string): void;
358
706
  }
707
+ export interface ToggleButtonProps extends Omit<ComponentPropsWithRef<'label'>, 'onChange'> {
708
+ type?: 'checkbox' | 'radio';
709
+ variant?: 'solid' | 'outline' | 'subtle' | 'text';
710
+ theme?: ComponentTheme;
711
+ name?: string;
712
+ value?: string;
713
+ checked?: boolean;
714
+ defaultChecked?: boolean;
715
+ disabled?: boolean;
716
+ }
717
+ export declare const ToggleButton: FC<ToggleButtonProps>;
718
+ export type TooltipProps = OverlayTriggerProps;
719
+ export declare const Tooltip: FC<TooltipProps>;
359
720
  export interface TypeEchoProps extends HTMLAttributes<HTMLPreElement> {
360
721
  text: string;
361
722
  intervals?: number;
362
723
  }
363
- export declare class TypeEcho extends Component<TypeEchoProps> {
364
- static displayName: string;
365
- accessor echoed: string;
366
- init: RefCallback<HTMLPreElement>;
367
- render(): import("react").JSX.Element;
368
- }
724
+ export declare const TypeEcho: FC<TypeEchoProps>;
369
725
  type UserAddressProps = Partial<Record<'email' | 'website', string>>;
370
726
  export interface UserRank extends UserAddressProps {
371
727
  id: number | string;
@@ -373,17 +729,12 @@ export interface UserRank extends UserAddressProps {
373
729
  avatar?: string;
374
730
  score: number;
375
731
  }
376
- export interface UserRankViewProps extends RowProps {
732
+ export interface UserRankViewProps extends HTMLAttributes<HTMLDivElement> {
377
733
  title: string;
378
734
  rank: UserRank[];
379
735
  linkOf?: (user: UserRank) => string;
380
736
  }
381
- export declare class UserRankView extends PureComponent<UserRankViewProps> {
382
- static displayName: string;
383
- renderMedal: (user: UserRank) => import("react").JSX.Element;
384
- renderRow: (user: UserRank, index: number, { length }: UserRank[]) => import("react").JSX.Element;
385
- render(): import("react").JSX.Element;
386
- }
737
+ export declare const UserRankView: FC<UserRankViewProps>;
387
738
  export interface VerticalMarqueeProps extends HTMLAttributes<HTMLDivElement> {
388
739
  duration?: string;
389
740
  }