idea-react 3.0.0-alpha.0 → 3.0.0-alpha.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.
Files changed (60) hide show
  1. package/AGENTS.md +31 -10
  2. package/ReadMe.md +42 -35
  3. package/dist/index.d.mts +301 -100
  4. package/dist/index.d.ts +301 -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 +4 -7
  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 +26 -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/Grid.tsx +92 -0
  20. package/source/HorizontalMarquee/index.tsx +4 -10
  21. package/source/Image.tsx +15 -0
  22. package/source/ListGroup.tsx +103 -0
  23. package/source/LiveTSX.tsx +1 -1
  24. package/source/Loading.tsx +4 -3
  25. package/source/Menu.tsx +99 -1
  26. package/source/MonthCalendar.tsx +60 -22
  27. package/source/NativeDialog/index.tsx +37 -1
  28. package/source/Nav.tsx +52 -0
  29. package/source/Navbar.tsx +48 -1
  30. package/source/Overlay.ts +22 -0
  31. package/source/OverlayBox.tsx +200 -32
  32. package/source/PageNav.tsx +56 -32
  33. package/source/Popover.tsx +36 -0
  34. package/source/ScrollNav/Scroller.tsx +107 -0
  35. package/source/ScrollNav/index.tsx +12 -99
  36. package/source/Select.tsx +66 -55
  37. package/source/ShareBox.tsx +5 -11
  38. package/source/Spinner.tsx +30 -0
  39. package/source/SpinnerButton.tsx +8 -10
  40. package/source/Table.tsx +59 -0
  41. package/source/TableSpinner.tsx +7 -5
  42. package/source/{TextTruncate.tsx → TextTruncate/Content.tsx} +24 -20
  43. package/source/TextTruncate/index.tsx +25 -0
  44. package/source/Time.tsx +7 -33
  45. package/source/TimeDistance.tsx +1 -1
  46. package/source/Timeline/index.tsx +7 -7
  47. package/source/Toast.tsx +114 -29
  48. package/source/ToggleButton.tsx +47 -0
  49. package/source/Tooltip.tsx +32 -0
  50. package/source/TypeEcho/Content.tsx +58 -0
  51. package/source/TypeEcho/index.tsx +14 -0
  52. package/source/UserRank/index.module.less +9 -20
  53. package/source/UserRank/index.tsx +35 -32
  54. package/source/VerticalMarquee/index.module.less +0 -1
  55. package/source/VerticalMarquee/index.tsx +3 -5
  56. package/source/ZodiacBar.tsx +1 -1
  57. package/source/animate.ts +4 -2
  58. package/source/color.ts +3 -5
  59. package/source/index.ts +13 -0
  60. 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, 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,20 @@ 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 CardHeader: FC<ComponentPropsWithRef<'div'>>;
67
+ export declare const CardBody: FC<ComponentPropsWithRef<'div'>>;
68
+ export declare const CardFooter: FC<ComponentPropsWithRef<'div'>>;
69
+ export declare const CardTitle: FC<ComponentPropsWithRef<'h3'>>;
70
+ export declare const CardText: FC<ComponentPropsWithRef<'p'>>;
46
71
  export type ClickBoundaryProps = PropsWithChildren<{
47
- onInnerClick?: (event: MouseEvent) => any;
48
- onOuterClick?: (event: MouseEvent) => any;
72
+ onInnerClick?: (event: MouseEvent) => unknown;
73
+ onOuterClick?: (event: MouseEvent) => unknown;
49
74
  } & DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
50
75
  export declare class ClickBoundary extends PureComponent<ClickBoundaryProps> {
51
76
  root: import("react").RefObject<HTMLDivElement>;
@@ -54,13 +79,17 @@ export declare class ClickBoundary extends PureComponent<ClickBoundaryProps> {
54
79
  componentWillUnmount(): void;
55
80
  render(): import("react").JSX.Element;
56
81
  }
82
+ export interface CloseButtonProps extends ComponentPropsWithRef<'button'> {
83
+ dismiss?: string;
84
+ }
85
+ export declare const CloseButton: FC<CloseButtonProps>;
57
86
  export interface CodeBlockProps extends HTMLAttributes<HTMLPreElement> {
58
87
  language: string;
59
88
  }
60
89
  export declare const CodeBlock: FC<CodeBlockProps>;
61
- export type VariantColor = Exclude<Color, 'white' | 'muted'>;
90
+ export type VariantColor = ComponentTheme;
62
91
  export declare const VariantColors: VariantColor[];
63
- export declare function text2color(raw: string, excludeColors?: VariantColor[]): VariantColor;
92
+ export declare function text2color(raw: string, excludeColors?: VariantColor[]): ComponentTheme;
64
93
  export interface TimeUnit {
65
94
  scale: number;
66
95
  label: string;
@@ -104,6 +133,45 @@ export declare class Dialog<I extends object = {}, O = any> {
104
133
  constructor(Factory: FC<I & DialogProps<O>>);
105
134
  open(input?: I): Promise<O>;
106
135
  }
136
+ export interface NativeDialogProps extends Omit<DialogHTMLAttributes<HTMLDialogElement>, 'open'> {
137
+ modal?: boolean;
138
+ dialog?: boolean;
139
+ theme?: 'light' | 'dark';
140
+ keyboard?: boolean;
141
+ backdrop?: boolean | 'static';
142
+ open?: boolean;
143
+ }
144
+ export declare const DialogHeader: FC<ComponentPropsWithRef<'div'>>;
145
+ export declare const DialogTitle: FC<ComponentPropsWithRef<'h1'>>;
146
+ export declare const DialogBody: FC<ComponentPropsWithRef<'div'>>;
147
+ export declare const DialogFooter: FC<ComponentPropsWithRef<'div'>>;
148
+ export declare class NativeDialog extends Component<NativeDialogProps> {
149
+ element: import("react").RefObject<HTMLDialogElement>;
150
+ returnFocus?: HTMLElement;
151
+ get open(): boolean;
152
+ componentDidMount(): void;
153
+ componentDidUpdate({ open }: NativeDialogProps): void;
154
+ show: () => void;
155
+ close: () => void;
156
+ componentWillUnmount(): void;
157
+ handleCancel: (event: SyntheticEvent<HTMLDialogElement>) => void;
158
+ handleKeyDown: (event: KeyboardEvent<HTMLDialogElement>) => void;
159
+ handleClick: (event: MouseEvent$1<HTMLDialogElement>) => void;
160
+ render(): import("react").JSX.Element;
161
+ }
162
+ export type DrawerPlacement = 'start' | 'end' | 'top' | 'bottom';
163
+ export declare const DrawerHeader: FC<ComponentPropsWithRef<'div'>>;
164
+ export declare const DrawerTitle: FC<ComponentPropsWithRef<'h5'>>;
165
+ export declare const DrawerBody: FC<ComponentPropsWithRef<'div'>>;
166
+ export declare const DrawerFooter: FC<ComponentPropsWithRef<'div'>>;
167
+ export interface DrawerProps extends Omit<NativeDialogProps, 'dialog' | 'onClose' | 'title'> {
168
+ title?: ReactNode;
169
+ placement?: DrawerPlacement;
170
+ footer?: ReactNode;
171
+ bodyClassName?: string;
172
+ onDismiss?: () => void;
173
+ }
174
+ export declare const Drawer: FC<DrawerProps>;
107
175
  export type EditorProps = PropsWithoutRef<WrapperProps & Pick<InputHTMLAttributes<HTMLInputElement>, 'name' | 'required'>>;
108
176
  export declare class Editor extends Component<EditorProps> {
109
177
  static displayName: string;
@@ -120,6 +188,33 @@ export interface EditorHTMLProps extends HTMLAttributes<HTMLDivElement> {
120
188
  data: OutputData;
121
189
  }
122
190
  export declare const EditorHTML: FC<EditorHTMLProps>;
191
+ export type Breakpoint = 'sm' | 'md' | 'lg' | 'xl' | '2xl';
192
+ export type ColSize = number | 'auto';
193
+ export type BreakpointColSize = ColSize | true;
194
+ export interface ContainerProps extends ComponentPropsWithRef<'div'> {
195
+ fluid?: boolean;
196
+ breakpoint?: Breakpoint;
197
+ }
198
+ export declare const Container: FC<ContainerProps>;
199
+ export type RowCols = number | 'auto';
200
+ export interface RowProps extends ComponentPropsWithRef<'div'> {
201
+ cols?: RowCols;
202
+ sm?: RowCols;
203
+ md?: RowCols;
204
+ lg?: RowCols;
205
+ xl?: RowCols;
206
+ '2xl'?: RowCols;
207
+ }
208
+ export declare const Row: FC<RowProps>;
209
+ export interface ColProps extends ComponentPropsWithRef<'div'> {
210
+ span?: ColSize;
211
+ sm?: BreakpointColSize;
212
+ md?: BreakpointColSize;
213
+ lg?: BreakpointColSize;
214
+ xl?: BreakpointColSize;
215
+ '2xl'?: BreakpointColSize;
216
+ }
217
+ export declare const Col: FC<ColProps>;
123
218
  export type HorizontalMarqueeProps = HTMLAttributes<HTMLDivElement> & Partial<Record<'maxWidth' | 'duration' | 'height', string>>;
124
219
  export declare const HorizontalMarquee: FC<HorizontalMarqueeProps>;
125
220
  export declare const HorizontalMarqueeBox: FC<HorizontalMarqueeProps>;
@@ -128,11 +223,62 @@ export type IconProps = PropsWithRef<HTMLAttributes<HTMLSpanElement> & {
128
223
  size?: number;
129
224
  }>;
130
225
  export declare const Icon: FC<IconProps>;
226
+ export interface ImageProps extends ComponentPropsWithRef<'img'> {
227
+ fluid?: boolean;
228
+ thumbnail?: boolean;
229
+ }
230
+ export declare const Image: FC<ImageProps>;
231
+ export type ListGroupHorizontal = boolean | Breakpoint;
232
+ export interface ListGroupProps extends ComponentPropsWithRef<'ul'> {
233
+ flush?: boolean;
234
+ numbered?: boolean;
235
+ horizontal?: ListGroupHorizontal;
236
+ }
237
+ export declare const ListGroup: FC<ListGroupProps>;
238
+ interface ListGroupItemStyleProps {
239
+ theme?: ComponentTheme;
240
+ action?: boolean;
241
+ active?: boolean;
242
+ disabled?: boolean;
243
+ }
244
+ type ListGroupItemLinkAttributes = ComponentPropsWithRef<'a'> & {
245
+ href: string;
246
+ };
247
+ type ListGroupItemButtonAttributes = ComponentPropsWithRef<'button'> & {
248
+ href?: never;
249
+ };
250
+ type ListGroupItemAttributes = ComponentPropsWithRef<'li'> & {
251
+ href?: never;
252
+ type?: never;
253
+ };
254
+ type ListGroupItemElementAttributes = ListGroupItemLinkAttributes | ListGroupItemButtonAttributes | ListGroupItemAttributes;
255
+ export type ListGroupItemProps = ListGroupItemStyleProps & ListGroupItemElementAttributes;
256
+ export declare const ListGroupItem: FC<ListGroupItemProps>;
131
257
  export type LiveTSXProps = Pick<Parameters<typeof LiveProvider>[0], 'scope' | 'children'>;
132
258
  export declare const LiveTSX: FC<LiveTSXProps>;
133
259
  export type LoadingProps = HTMLAttributes<HTMLDivElement>;
134
260
  export declare const Loading: FC<LoadingProps>;
135
261
  export declare const MenuItem: FC<ButtonProps>;
262
+ export declare const MenuPanel: FC<HTMLAttributes<HTMLDivElement>>;
263
+ export declare const MenuText: FC<HTMLAttributes<HTMLSpanElement>>;
264
+ export declare const MenuHeader: FC<HTMLAttributes<HTMLHeadingElement>>;
265
+ export declare const MenuDivider: FC<HTMLAttributes<HTMLHRElement>>;
266
+ export declare const MenuItemContent: FC<HTMLAttributes<HTMLSpanElement>>;
267
+ export declare const MenuItemDescription: FC<HTMLAttributes<HTMLElement>>;
268
+ export interface MenuSubmenuProps extends PropsWithChildren {
269
+ label: ReactNode;
270
+ className?: string;
271
+ }
272
+ export declare class MenuSubmenu extends Component<MenuSubmenuProps> {
273
+ accessor open: boolean;
274
+ panel: import("react").RefObject<HTMLDivElement>;
275
+ setOpen: (open: boolean) => void;
276
+ handleClick: () => void;
277
+ handleMouseEnter: () => void;
278
+ handleMouseLeave: () => void;
279
+ handleKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
280
+ render(): import("react").JSX.Element;
281
+ }
136
282
  export interface MenuProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
137
283
  label: ReactNode;
138
284
  autoClose?: boolean | 'inside' | 'outside';
@@ -164,11 +310,12 @@ export interface DateData {
164
310
  content: ReactNode;
165
311
  link?: string;
166
312
  }
167
- export interface MonthCalendarProps extends Omit<TableProps, 'variant' | 'onChange' | 'onSelect'>, Pick<ButtonProps$1, 'variant'> {
313
+ export interface MonthCalendarProps extends Omit<HTMLAttributes<HTMLTableElement>, 'onChange' | 'onSelect'> {
168
314
  locale?: Navigator['language'];
315
+ theme?: ComponentTheme;
169
316
  value?: DateData[];
170
- onSelect?: (value: DateData) => any;
171
- onChange?: (date: Date) => any;
317
+ onSelect?: (value: DateData) => unknown;
318
+ onChange?: (date: Date) => void;
172
319
  }
173
320
  /**
174
321
  * Re-implement from https://github.com/EasyWebApp/BootCell/blob/3d30027a97fe0a8c4ab8fabc8dfef22aede04de7/source/Calendar/MonthCalendar.tsx
@@ -179,6 +326,9 @@ export declare class MonthCalendar extends ObservedComponent<MonthCalendarProps>
179
326
  accessor currentDate: Date;
180
327
  get dateGrid(): Date[][];
181
328
  changeMonth(delta: number): void;
329
+ changePreviousMonth: () => void;
330
+ changeNextMonth: () => void;
331
+ handleCellClick: ({ target, currentTarget }: MouseEvent$1<HTMLTableCellElement>) => void;
182
332
  renderDate: (date: Date) => import("react").JSX.Element;
183
333
  render(): import("react").JSX.Element;
184
334
  }
@@ -187,39 +337,77 @@ export type NameplateProps = PropsWithoutRef<{
187
337
  name: string;
188
338
  }>;
189
339
  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;
340
+ export interface NavProps extends ComponentPropsWithRef<'nav'> {
341
+ variant?: 'tabs' | 'pills' | 'underline';
342
+ vertical?: boolean;
343
+ fill?: boolean;
344
+ justified?: boolean;
345
+ }
346
+ export declare const Nav: FC<NavProps>;
347
+ export declare const NavItem: FC<ComponentPropsWithRef<'li'>>;
348
+ export interface NavLinkProps extends ComponentPropsWithRef<'a'> {
349
+ disabled?: boolean;
206
350
  }
351
+ export declare const NavLink: FC<NavLinkProps>;
207
352
  export interface NavbarProps extends ComponentPropsWithRef<'nav'> {
353
+ theme?: 'light' | 'dark';
208
354
  expand?: boolean | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
209
355
  }
210
356
  export declare const Navbar: FC<NavbarProps>;
211
- export interface OverlayBoxProps extends Omit<OverlayTriggerProps, 'overlay'> {
357
+ export declare const NavbarBrand: FC<ComponentPropsWithRef<'a'>>;
358
+ export declare const NavbarNav: FC<ComponentPropsWithRef<'ul'>>;
359
+ export declare const NavbarText: FC<ComponentPropsWithRef<'span'>>;
360
+ export interface NavbarTogglerProps extends Omit<ComponentPropsWithRef<'button'>, 'children' | 'type'> {
361
+ expanded?: boolean;
362
+ }
363
+ export declare const NavbarToggler: FC<NavbarTogglerProps>;
364
+ type OverlayPlacement = 'top' | 'right' | 'bottom' | 'left';
365
+ interface OverlayTriggerProps extends ComponentPropsWithRef<'div'> {
366
+ placement?: OverlayPlacement;
367
+ show?: boolean;
368
+ }
369
+ export type OverlayTrigger = 'click' | 'focus' | 'hover';
370
+ export interface OverlayBoxProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'children' | 'title'> {
212
371
  title: ReactNode;
213
372
  detail?: ReactNode;
373
+ placement?: OverlayPlacement;
374
+ trigger?: OverlayTrigger | OverlayTrigger[];
375
+ delay?: number | {
376
+ show: number;
377
+ hide: number;
378
+ };
379
+ overlayClassName?: string;
380
+ children: ReactElement<{
381
+ 'aria-describedby'?: string;
382
+ }>;
383
+ }
384
+ export declare class OverlayBox extends Component<OverlayBoxProps> {
385
+ static displayName: string;
386
+ accessor open: boolean;
387
+ id: string;
388
+ root: import("react").RefObject<HTMLSpanElement>;
389
+ timer?: ReturnType<typeof setTimeout>;
390
+ setOpen: (open: boolean) => boolean;
391
+ hide: () => void;
392
+ setOpenAfterDelay: (open: boolean) => boolean;
393
+ componentWillUnmount(): void;
394
+ componentDidMount(): void;
395
+ hasTrigger: (trigger: OverlayTrigger) => boolean;
396
+ handleMouseEnter: (event: MouseEvent$1<HTMLSpanElement>) => void;
397
+ handleMouseLeave: (event: MouseEvent$1<HTMLSpanElement>) => void;
398
+ handleFocus: (event: FocusEvent<HTMLSpanElement>) => void;
399
+ handleBlur: (event: FocusEvent<HTMLSpanElement>) => void;
400
+ handleClick: (event: MouseEvent$1<HTMLSpanElement>) => void;
401
+ handleOutside: ({ target }: PointerEvent) => void;
402
+ handleKeyDown: (event: KeyboardEvent<HTMLSpanElement>) => void;
403
+ render(): import("react").JSX.Element;
214
404
  }
215
- /**
216
- * ToDo: {@link https://react-bootstrap.github.io/docs/components/overlays#disabled-elements}
217
- */
218
- export declare const OverlayBox: FC<OverlayBoxProps>;
219
405
  type HeadingMeta = Record<'id' | 'text', string> & Record<'level' | 'top', number>;
220
406
  export interface PageNavProps extends NavProps {
221
407
  depth?: number;
222
- onItemClick?: (item: HeadingMeta) => any;
408
+ minDepth?: number;
409
+ rootSelector?: string;
410
+ onItemClick?: (item: HeadingMeta) => void;
223
411
  }
224
412
  export declare class PageNav extends Component<PageNavProps> {
225
413
  static displayName: string;
@@ -228,11 +416,17 @@ export declare class PageNav extends Component<PageNavProps> {
228
416
  get currentActiveId(): string;
229
417
  updateScrollY: () => number;
230
418
  componentDidMount(): void;
419
+ static slugOf(text: string): string;
420
+ initList(): void;
231
421
  componentWillUnmount(): void;
232
422
  scrollTo: (meta: HeadingMeta) => () => void;
233
423
  renderLink: ({ id, level, text, top }: HeadingMeta) => import("react").JSX.Element;
234
424
  render(): import("react").JSX.Element;
235
425
  }
426
+ export interface PopoverProps extends Omit<OverlayTriggerProps, 'title'> {
427
+ title?: ReactNode;
428
+ }
429
+ export declare const Popover: FC<PopoverProps>;
236
430
  export type ScrollNavProps = NavProps;
237
431
  /**
238
432
  * A horizontal scrolling navigation bar based on Bootstrap's `nav-scroller` pattern.
@@ -240,29 +434,18 @@ export type ScrollNavProps = NavProps;
240
434
  *
241
435
  * @see {@link https://github.com/twbs/bootstrap/blob/main/site/src/assets/examples/offcanvas-navbar/index.astro#L50-L65}
242
436
  */
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 {
437
+ export declare const ScrollNav: FC<ScrollNavProps>;
438
+ export interface OptionProps extends ButtonHTMLAttributes<HTMLButtonElement> {
259
439
  value?: string;
260
440
  }
261
441
  export declare const Option: FC<OptionProps>;
262
- export interface SelectProps extends Omit<OptionProps, 'onChange'>, Pick<DropdownButtonProps, 'variant' | 'menuVariant'> {
263
- onChange?: (value: string) => any;
442
+ export type SelectProps = Pick<ButtonProps, 'className' | 'style' | 'size' | 'theme' | 'variant' | 'disabled' | 'children'> & {
443
+ align?: 'start' | 'end';
444
+ menuClassName?: string;
445
+ value?: string;
446
+ onChange?: (value: string) => void;
264
447
  valueRender?: (value: string) => ReactNode;
265
- }
448
+ };
266
449
  export declare const Select: FC<SelectProps>;
267
450
  export declare function elementToImage(element: HTMLElement, type?: string, quality?: number): Promise<string>;
268
451
  export type ShareBoxProps = HTMLAttributes<HTMLDivElement> & ShareData;
@@ -277,11 +460,28 @@ export declare class ShareBox extends Component<ShareBoxProps> {
277
460
  share: (event: MouseEvent$1<HTMLImageElement>) => Promise<void>;
278
461
  render(): import("react").JSX.Element;
279
462
  }
280
- export interface SpinnerButtonProps extends ButtonProps$1, Pick<SpinnerProps, 'animation'> {
281
- loading?: boolean;
463
+ export type SpinnerAnimation = 'border' | 'grow';
464
+ export interface SpinnerProps extends ComponentPropsWithRef<'span'> {
465
+ animation?: SpinnerAnimation;
466
+ size?: 'sm';
467
+ theme?: ComponentTheme;
282
468
  }
469
+ export declare const Spinner: FC<SpinnerProps>;
470
+ export type SpinnerButtonProps = ButtonProps & Pick<SpinnerProps, 'animation'> & {
471
+ loading?: boolean;
472
+ };
283
473
  export declare const SpinnerButton: FC<SpinnerButtonProps>;
284
- export interface TableSpinnerProps extends HTMLAttributes<HTMLTableRowElement>, Pick<SpinnerProps, 'animation' | 'variant' | 'size'> {
474
+ export interface TableProps extends ComponentPropsWithRef<'table'> {
475
+ striped?: boolean;
476
+ stripedColumns?: boolean;
477
+ hover?: boolean;
478
+ bordered?: boolean;
479
+ borderless?: boolean;
480
+ small?: boolean;
481
+ responsive?: boolean | Breakpoint;
482
+ }
483
+ export declare const Table: FC<TableProps>;
484
+ export interface TableSpinnerProps extends HTMLAttributes<HTMLTableRowElement>, Pick<SpinnerProps, 'animation' | 'theme' | 'size'> {
285
485
  colSpan: number;
286
486
  }
287
487
  export declare const TableSpinner: FC<TableSpinnerProps>;
@@ -290,29 +490,12 @@ export interface TextTruncateProps extends HTMLAttributes<HTMLDivElement> {
290
490
  expandText?: ReactNode;
291
491
  collapseText?: ReactNode;
292
492
  }
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
- }
493
+ export declare const TextTruncate: FC<TextTruncateProps>;
305
494
  export interface TimeProps extends Omit<TimeHTMLAttributes<HTMLTimeElement>, 'dateTime'> {
306
495
  dateTime: TimeData;
307
496
  format?: string;
308
497
  }
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
- }
498
+ export declare const Time: FC<TimeProps>;
316
499
  export interface TimeDistanceProps extends HTMLAttributes<HTMLTimeElement> {
317
500
  date: TimeData;
318
501
  unitWords?: Record<string, string>;
@@ -335,37 +518,60 @@ export interface TimelineProps extends HTMLAttributes<HTMLOListElement> {
335
518
  * @see {@link https://mdbootstrap.com/docs/standard/extended/timeline/#section-timeline-gradient-bg}
336
519
  */
337
520
  export declare const Timeline: FC<TimelineProps>;
521
+ export type ToastPosition = 'top-start' | 'top-center' | 'top-end' | 'middle-start' | 'middle-center' | 'middle-end' | 'bottom-start' | 'bottom-center' | 'bottom-end';
338
522
  export interface ToastMessage {
339
523
  id?: string;
340
524
  title?: ReactNode;
341
525
  body: ReactNode;
342
- variant?: Variant;
526
+ theme?: ComponentTheme;
343
527
  delay?: number;
344
528
  }
345
- interface ToastItem extends ToastMessage {
529
+ interface ToastEntry extends ToastMessage {
346
530
  openedAt: number;
347
531
  closedAt?: number;
348
- resolve?: (value: ToastItem) => void;
532
+ timer?: ReturnType<typeof setTimeout>;
533
+ resolve?: (value: ToastEntry) => void;
349
534
  }
535
+ export interface ToastContainerProps extends ComponentPropsWithRef<'div'> {
536
+ position?: ToastPosition;
537
+ }
538
+ export declare const ToastContainer: FC<ToastContainerProps>;
539
+ export interface ToastItemProps extends ComponentPropsWithRef<'div'> {
540
+ theme?: ComponentTheme;
541
+ }
542
+ export declare const ToastItem: FC<ToastItemProps>;
543
+ export declare const ToastHeader: FC<ComponentPropsWithRef<'div'>>;
544
+ export declare const ToastBody: FC<ComponentPropsWithRef<'div'>>;
350
545
  export declare class Toast {
351
546
  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;
547
+ accessor messages: ToastEntry[];
548
+ Component: FC<{
549
+ position?: ToastPosition;
550
+ }>;
551
+ renderMessage: ({ id, openedAt, title, body, theme, delay }: ToastEntry) => import("react").JSX.Element;
552
+ handleDismiss: ({ target }: MouseEvent$1<HTMLDivElement>) => void;
355
553
  constructor(TimeScalar?: typeof Timestamp);
356
- open(message: ToastMessage): Promise<ToastItem>;
554
+ open(message: ToastMessage): Promise<ToastEntry>;
357
555
  close(id: string): void;
358
556
  }
557
+ export interface ToggleButtonProps extends Omit<ComponentPropsWithRef<'label'>, 'onChange'> {
558
+ type?: 'checkbox' | 'radio';
559
+ variant?: 'solid' | 'outline' | 'subtle' | 'text';
560
+ theme?: ComponentTheme;
561
+ name?: string;
562
+ value?: string;
563
+ checked?: boolean;
564
+ defaultChecked?: boolean;
565
+ disabled?: boolean;
566
+ }
567
+ export declare const ToggleButton: FC<ToggleButtonProps>;
568
+ export type TooltipProps = OverlayTriggerProps;
569
+ export declare const Tooltip: FC<TooltipProps>;
359
570
  export interface TypeEchoProps extends HTMLAttributes<HTMLPreElement> {
360
571
  text: string;
361
572
  intervals?: number;
362
573
  }
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
- }
574
+ export declare const TypeEcho: FC<TypeEchoProps>;
369
575
  type UserAddressProps = Partial<Record<'email' | 'website', string>>;
370
576
  export interface UserRank extends UserAddressProps {
371
577
  id: number | string;
@@ -373,17 +579,12 @@ export interface UserRank extends UserAddressProps {
373
579
  avatar?: string;
374
580
  score: number;
375
581
  }
376
- export interface UserRankViewProps extends RowProps {
582
+ export interface UserRankViewProps extends HTMLAttributes<HTMLDivElement> {
377
583
  title: string;
378
584
  rank: UserRank[];
379
585
  linkOf?: (user: UserRank) => string;
380
586
  }
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
- }
587
+ export declare const UserRankView: FC<UserRankViewProps>;
387
588
  export interface VerticalMarqueeProps extends HTMLAttributes<HTMLDivElement> {
388
589
  duration?: string;
389
590
  }