idea-react 3.0.0-beta.2 → 3.0.0-beta.4

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.
package/AGENTS.md CHANGED
@@ -188,6 +188,7 @@ export class MyComponent extends ObservedComponent<MyComponentProps> {
188
188
  类组件显式声明 `declare readonly props: PolymorphicClassProps<T, Props>`,避免 React 的
189
189
  `Readonly` 映射丢失目标属性的联合类型;内部按需使用类型收窄 getter。
190
190
  - 用通用组件替换原生元素或已有组件时,使用 `as` 指定原元素/组件,并保留其语义、属性、事件和行为;不因替换标签而丢失原有能力。优先复用组件已有的属性透传,避免重复包装。
191
+ - 表单组件的原生控件属性直接暴露为组件顶层 props,不封装在 `inputProps` 等嵌套对象中。
191
192
  - 组件 Props 优先用 `Pick`/`Omit`/`extends` 复用已有类型,不重复声明;按外观、内容、状态、行为的顺序分组排列。
192
193
  - JSX 属性按 `as`、HTML 通用静态属性、组件专属属性、状态属性、回调属性排序;相同键值的 props 可用对象字面量简写后展开。
193
194
  - 同一模块的类型与值合并为一条 import,不拆成 `import type` 与 `import` 两条。
@@ -224,7 +225,7 @@ export class MyComponent extends ObservedComponent<MyComponentProps> {
224
225
  - Markdown 正文中的链接采用文末数字引用:正文写 `[text][number]`,文末写 `[number]: URL`;图片链接同样使用引用形式。行末链接(如组件列表项)无需改为文末引用,可保留 `[text](URL)`。
225
226
  - 每篇文档的数字引用按首次出现顺序从 1 连续编号;重复链接复用同一编号,修改后同步整理正文与定义,移除未使用定义,不留跳号、重复或悬空引用。
226
227
  - 组件目录优先列出上游标准组件,再列扩展组件。
227
- - 静态站搜索优先采用最简单可用的方案,自动索引导出内容,不维护手写页面清单,不为索引格式或具体技术额外引入不必要的服务和框架。
228
+ - 静态站搜索优先采用最简单可用的方案,开发与生产共用 MDX 源码索引器并通过同一 JSON 地址加载,不依赖编译后的 HTML,不维护手写页面清单,不为索引格式或具体技术额外引入不必要的服务和框架。
228
229
 
229
230
  ## 测试与验证
230
231
 
@@ -249,7 +250,7 @@ pnpm build -r
249
250
  - `test` 使用 Node.js 原生 runner,需要 Node.js 22.18+,并做 TypeScript 检查。Lint 与格式检查针对本次修改文件运行。
250
251
  - 根目录 `pnpm build` 构建 TypeDoc、旧预览站与组件发布包;现有根构建、发布部署仍使用 `docs/`,不能将其误当作 ViNext 文档工作区的构建或部署。
251
252
  - 文档工作区单独构建,只部署 `document/dist/client/`;部署到子目录前配置 `document/next.config.ts` 的 `basePath`,并验证静态资源、搜索索引和结果链接。
252
- - 搜索索引在导出 HTML 后生成;验证搜索时先构建,再预览静态产物。
253
+ - 开发模式按请求从当前 MDX 文档生成搜索索引;生产模式用同一索引器生成静态 JSON,生产搜索需构建后预览静态产物。
253
254
  - 浏览器验证包括键盘交互、主题恢复、错误弹窗、失败后重试与不同视口;文档站不依赖 Node.js 或 Worker 运行时。
254
255
 
255
256
  ## 发布维护
package/dist/index.d.mts CHANGED
@@ -95,7 +95,7 @@ export declare class Alert<T extends ElementType | undefined = 'div'> extends Co
95
95
  static displayName: string;
96
96
  accessor hiding: boolean;
97
97
  accessor closed: boolean;
98
- root: import("react").RefObject<HTMLDivElement>;
98
+ root: import("react").RefObject<HTMLDivElement | null>;
99
99
  timer?: ReturnType<typeof setTimeout>;
100
100
  notified: boolean;
101
101
  componentDidUpdate(): void;
@@ -105,7 +105,7 @@ export declare class Alert<T extends ElementType | undefined = 'div'> extends Co
105
105
  static milliseconds: (value: string) => number;
106
106
  handleClose: (event: MouseEvent$1<HTMLButtonElement>) => void;
107
107
  handleTransitionEnd: (event: TransitionEvent<HTMLDivElement>) => void;
108
- render(): import("react").JSX.Element;
108
+ render(): import("react").JSX.Element | null;
109
109
  }
110
110
  export declare const AlertLink: PolymorphicComponent<import("react").DetailedHTMLProps<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>>;
111
111
  export declare const AlertHeading: PolymorphicComponent<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>>;
@@ -241,8 +241,8 @@ export interface CarouselProps extends Omit<ComponentPropsWithRef<'div'>, 'onCha
241
241
  export declare class Carousel<T extends ElementType | undefined = 'div'> extends Component<PolymorphicClassProps<T, CarouselProps>> {
242
242
  readonly props: PolymorphicClassProps<T, CarouselProps>;
243
243
  static displayName: string;
244
- root: import("react").RefObject<HTMLDivElement>;
245
- track: import("react").RefObject<HTMLDivElement>;
244
+ root: import("react").RefObject<HTMLDivElement | null>;
245
+ track: import("react").RefObject<HTMLDivElement | null>;
246
246
  store: CarouselModel;
247
247
  scroller: CarouselScroll;
248
248
  componentDidMount(): void;
@@ -261,9 +261,9 @@ export declare class Carousel<T extends ElementType | undefined = 'div'> extends
261
261
  handleClick: (event: MouseEvent$1<HTMLDivElement>) => void;
262
262
  scrollToActive: (index: number, from: number, direction?: -1 | 1) => void;
263
263
  renderSlide: (slide: ReactNode, index: number) => import("react").JSX.Element;
264
- renderControls: () => import("react").JSX.Element;
265
- renderIndicators: () => import("react").JSX.Element;
266
- renderPlayPause: () => import("react").JSX.Element;
264
+ renderControls: () => import("react").JSX.Element | null;
265
+ renderIndicators: () => import("react").JSX.Element | null;
266
+ renderPlayPause: () => false | import("react").JSX.Element | undefined;
267
267
  render(): import("react").JSX.Element;
268
268
  }
269
269
  export interface CloseButtonProps extends ComponentPropsWithRef<'button'> {
@@ -282,7 +282,7 @@ export declare class Collapse<T extends ElementType | undefined = 'div'> extends
282
282
  protected get componentProps(): Readonly<CollapseProps & AsProps>;
283
283
  static displayName: string;
284
284
  accessor expanded: boolean;
285
- root: import("react").RefObject<HTMLDivElement>;
285
+ root: import("react").RefObject<HTMLDivElement | null>;
286
286
  get isOpen(): boolean;
287
287
  componentDidMount(): void;
288
288
  componentDidUpdate(previous: CollapseProps): void;
@@ -320,13 +320,12 @@ export type Breakpoint = 'sm' | 'md' | 'lg' | 'xl' | '2xl';
320
320
  export type ColSize = number | 'auto';
321
321
  export type BreakpointColSize = ColSize | true;
322
322
  export interface ContainerProps extends ComponentPropsWithRef<'div'> {
323
- fluid?: boolean;
324
- breakpoint?: Breakpoint;
323
+ fluid?: boolean | Breakpoint;
325
324
  }
326
325
  export declare const Container: PolymorphicComponent<ContainerProps>;
327
326
  export type RowCols = number | 'auto';
328
327
  export interface RowProps extends ComponentPropsWithRef<'div'> {
329
- cols?: RowCols;
328
+ xs?: RowCols;
330
329
  sm?: RowCols;
331
330
  md?: RowCols;
332
331
  lg?: RowCols;
@@ -335,7 +334,7 @@ export interface RowProps extends ComponentPropsWithRef<'div'> {
335
334
  }
336
335
  export declare const Row: PolymorphicComponent<RowProps>;
337
336
  export interface ColProps extends ComponentPropsWithRef<'div'> {
338
- span?: ColSize;
337
+ xs?: BreakpointColSize;
339
338
  sm?: BreakpointColSize;
340
339
  md?: BreakpointColSize;
341
340
  lg?: BreakpointColSize;
@@ -365,7 +364,7 @@ export declare class NativeDialog<T extends ElementType | undefined = 'dialog'>
365
364
  protected get componentProps(): Readonly<NativeDialogProps & AsProps>;
366
365
  static scrollLocks: Set<NativeDialog<ElementType>>;
367
366
  static bodyOverflow: string;
368
- element: import("react").RefObject<HTMLDialogElement>;
367
+ element: import("react").RefObject<HTMLDialogElement | null>;
369
368
  returnFocus?: HTMLElement;
370
369
  switchingMode: boolean;
371
370
  closeTimer?: ReturnType<typeof setTimeout>;
@@ -406,7 +405,7 @@ export declare class Drawer<T extends ElementType | undefined = 'dialog'> extend
406
405
  protected get componentProps(): Readonly<DrawerProps & AsProps>;
407
406
  static displayName: string;
408
407
  accessor expanded: boolean;
409
- dialog: import("react").RefObject<NativeDialog<ElementType>>;
408
+ dialog: import("react").RefObject<NativeDialog<ElementType> | null>;
410
409
  media?: MediaQueryList;
411
410
  dismissed: boolean;
412
411
  componentDidMount(): void;
@@ -425,7 +424,7 @@ export type ClickBoundaryProps = PropsWithChildren<{
425
424
  export declare class ClickBoundary<T extends ElementType | undefined = 'div'> extends PureComponent<PolymorphicClassProps<T, ClickBoundaryProps>> {
426
425
  readonly props: PolymorphicClassProps<T, ClickBoundaryProps>;
427
426
  protected get componentProps(): Readonly<ClickBoundaryProps & AsProps>;
428
- root: import("react").RefObject<HTMLDivElement>;
427
+ root: import("react").RefObject<HTMLDivElement | null>;
429
428
  switchClick: (event: MouseEvent) => void;
430
429
  componentDidMount(): void;
431
430
  componentWillUnmount(): void;
@@ -487,8 +486,8 @@ export declare class Editor<T extends ElementType | undefined = 'div'> extends C
487
486
  protected get componentProps(): Readonly<EditorProps & AsProps>;
488
487
  static displayName: string;
489
488
  private core?;
490
- accessor innerValue: import("@editorjs/editorjs").OutputData;
491
- setInnerValue: (value: typeof this.innerValue) => import("@editorjs/editorjs").OutputData;
489
+ accessor innerValue: import("@editorjs/editorjs").OutputData | undefined;
490
+ setInnerValue: (value: typeof this.innerValue) => import("@editorjs/editorjs").OutputData | undefined;
492
491
  handleBlur: (event: FocusEvent<HTMLDivElement>) => Promise<void>;
493
492
  initialize: (core: EditorCore) => void;
494
493
  render(): import("react").JSX.Element;
@@ -607,13 +606,13 @@ export declare class OverlayBox<T extends ElementType | undefined = 'span'> exte
607
606
  static displayName: string;
608
607
  accessor open: boolean;
609
608
  id: string;
610
- root: import("react").RefObject<HTMLSpanElement>;
611
- overlay: import("react").RefObject<HTMLDivElement>;
609
+ root: import("react").RefObject<HTMLSpanElement | null>;
610
+ overlay: import("react").RefObject<HTMLDivElement | null>;
612
611
  position: FloatingPosition;
613
612
  timer?: ReturnType<typeof setTimeout>;
614
613
  setOpen: (open: boolean) => boolean;
615
614
  hide: () => void;
616
- setOpenAfterDelay: (open: boolean) => boolean;
615
+ setOpenAfterDelay: (open: boolean) => boolean | undefined;
617
616
  componentWillUnmount(): void;
618
617
  componentDidMount(): void;
619
618
  componentDidUpdate(previous: OverlayBoxProps): void;
@@ -663,7 +662,7 @@ export declare class PageNav<T extends ElementType | undefined = 'nav'> extends
663
662
  initList(): void;
664
663
  componentWillUnmount(): void;
665
664
  scrollTo: (meta: HeadingMeta) => () => void;
666
- renderLink: ({ id, level, text, top }: HeadingMeta) => import("react").JSX.Element;
665
+ renderLink: ({ id, level, text, top }: HeadingMeta) => false | import("react").JSX.Element;
667
666
  render(): import("react").JSX.Element;
668
667
  }
669
668
  export type ScrollNavProps = NavProps;
@@ -698,7 +697,7 @@ export declare function elementToImage(element: HTMLElement, type?: string, qual
698
697
  export type ShareBoxProps = HTMLAttributes<HTMLDivElement> & ShareData;
699
698
  export declare class ShareBox extends Component<ShareBoxProps> {
700
699
  static displayName: string;
701
- root: import("react").RefObject<HTMLDivElement>;
700
+ root: import("react").RefObject<HTMLDivElement | null>;
702
701
  accessor loading: boolean;
703
702
  accessor imageURI: string;
704
703
  componentDidMount(): void;
@@ -831,7 +830,7 @@ export type CheckboxProps = Omit<ComponentPropsWithoutRef<'input'>, 'type' | 'si
831
830
  theme?: ComponentTheme;
832
831
  indeterminate?: boolean;
833
832
  };
834
- export declare const Checkbox: PolymorphicComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "type" | "size"> & FormValidationProps & {
833
+ export declare const Checkbox: PolymorphicComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "size" | "type"> & FormValidationProps & {
835
834
  size?: "sm" | "lg";
836
835
  theme?: ComponentTheme;
837
836
  indeterminate?: boolean;
@@ -1015,8 +1014,8 @@ export declare class MenuSubmenu<T extends ElementType | undefined = 'div'> exte
1015
1014
  readonly props: PolymorphicClassProps<T, MenuSubmenuProps>;
1016
1015
  protected get componentProps(): Readonly<MenuSubmenuProps & AsProps>;
1017
1016
  accessor open: boolean;
1018
- panel: import("react").RefObject<HTMLDivElement>;
1019
- trigger: import("react").RefObject<HTMLButtonElement>;
1017
+ panel: import("react").RefObject<HTMLDivElement | null>;
1018
+ trigger: import("react").RefObject<HTMLButtonElement | null>;
1020
1019
  position: FloatingPosition;
1021
1020
  componentDidUpdate(): void;
1022
1021
  componentWillUnmount(): void;
@@ -1054,9 +1053,9 @@ export declare class Menu<T extends ElementType | undefined = 'div'> extends Com
1054
1053
  protected get componentProps(): Readonly<MenuProps & AsProps>;
1055
1054
  accessor open: boolean;
1056
1055
  accessor responsiveDirection: MenuPlacement | undefined;
1057
- root: import("react").RefObject<HTMLDivElement>;
1058
- trigger: import("react").RefObject<HTMLButtonElement>;
1059
- panel: import("react").RefObject<HTMLDivElement>;
1056
+ root: import("react").RefObject<HTMLDivElement | null>;
1057
+ trigger: import("react").RefObject<HTMLButtonElement | null>;
1058
+ panel: import("react").RefObject<HTMLDivElement | null>;
1060
1059
  media: {
1061
1060
  query: MediaQueryList;
1062
1061
  placement: MenuPlacement;
@@ -1066,7 +1065,7 @@ export declare class Menu<T extends ElementType | undefined = 'div'> extends Com
1066
1065
  componentDidUpdate({ responsivePlacement }: MenuProps): void;
1067
1066
  componentWillUnmount(): void;
1068
1067
  observePlacement: () => void;
1069
- handlePlacement: () => MenuPlacement;
1068
+ handlePlacement: () => MenuPlacement | undefined;
1070
1069
  setOpen: (open: boolean) => void;
1071
1070
  handleOutside: ({ target }: PointerEvent) => void;
1072
1071
  items(panel?: HTMLElement | null): HTMLElement[];
@@ -1118,7 +1117,7 @@ export type OTPInputProps = Omit<ComponentPropsWithoutRef<'input'>, 'type' | 'ma
1118
1117
  onComplete?: (value: string) => unknown;
1119
1118
  onValueChange?: (value: string) => unknown;
1120
1119
  };
1121
- export declare const OTPInput: PolymorphicComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "type" | "size" | "maxLength"> & FormValidationProps & {
1120
+ export declare const OTPInput: PolymorphicComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "size" | "type" | "maxLength"> & FormValidationProps & {
1122
1121
  length: number;
1123
1122
  type?: "numeric" | "alphanumeric" | "alpha";
1124
1123
  mask?: boolean;
@@ -1170,12 +1169,15 @@ export declare const FormRange: PolymorphicComponent<Omit<Omit<import("react").D
1170
1169
  } & {
1171
1170
  ref?: Ref<HTMLInputElement>;
1172
1171
  }>;
1173
- export type FormSwitchProps = Omit<ComponentPropsWithRef<'label'>, 'children'> & PropsWithChildren<FormValidationProps & {
1174
- inputProps?: Omit<ComponentPropsWithRef<'input'>, 'type'>;
1172
+ type NativeInputProps$1 = Omit<ComponentPropsWithRef<'input'>, 'ref' | 'type' | 'size'>;
1173
+ export type FormSwitchProps = Omit<ComponentPropsWithRef<'label'>, keyof NativeInputProps$1 | 'children'> & PropsWithChildren<NativeInputProps$1 & FormValidationProps & {
1175
1174
  size?: 'sm' | 'lg';
1176
1175
  theme?: ComponentTheme;
1177
- width?: string;
1178
1176
  indicatorWidth?: string;
1177
+ inputRef?: Ref<HTMLInputElement>;
1178
+ inputId?: string;
1179
+ inputClassName?: string;
1180
+ inputStyle?: CSSProperties;
1179
1181
  }>;
1180
1182
  export declare const FormSwitch: PolymorphicComponent<FormSwitchProps>;
1181
1183
  export interface ImageProps extends ComponentPropsWithRef<'img'> {
@@ -1263,9 +1265,9 @@ export declare class NavOverflow<T extends ElementType | undefined = 'div'> exte
1263
1265
  readonly props: PolymorphicClassProps<T, NavOverflowProps>;
1264
1266
  protected get componentProps(): Readonly<NavOverflowProps & AsProps>;
1265
1267
  static displayName: string;
1266
- root: import("react").RefObject<HTMLDivElement>;
1267
- nav: import("react").RefObject<HTMLElement>;
1268
- toggleButton: import("react").RefObject<HTMLButtonElement>;
1268
+ root: import("react").RefObject<HTMLDivElement | null>;
1269
+ nav: import("react").RefObject<HTMLElement | null>;
1270
+ toggleButton: import("react").RefObject<HTMLButtonElement | null>;
1269
1271
  store: NavOverflowModel;
1270
1272
  private resizeObserver?;
1271
1273
  componentDidMount(): void;
@@ -1323,9 +1325,9 @@ declare class ScrollSpyModel {
1323
1325
  accessor guides: (Record<'top' | 'left' | 'width' | 'height' | 'line', number> & {
1324
1326
  atBottom: boolean;
1325
1327
  }) | undefined;
1326
- setGuides: (guides: ScrollSpyModel["guides"]) => Record<"line" | "top" | "height" | "width" | "left", number> & {
1328
+ setGuides: (guides: ScrollSpyModel["guides"]) => (Record<"line" | "height" | "width" | "top" | "left", number> & {
1327
1329
  atBottom: boolean;
1328
- };
1330
+ }) | undefined;
1329
1331
  setActiveId: (id: string) => string;
1330
1332
  }
1331
1333
  export interface ScrollSpyProps extends Omit<ComponentPropsWithRef<'div'>, 'onChange' | 'children'> {
@@ -1343,7 +1345,7 @@ export declare class ScrollSpy<T extends ElementType | undefined = 'div'> extend
1343
1345
  readonly props: PolymorphicClassProps<T, ScrollSpyProps>;
1344
1346
  protected get componentProps(): Readonly<ScrollSpyProps & AsProps>;
1345
1347
  static displayName: string;
1346
- root: import("react").RefObject<HTMLDivElement>;
1348
+ root: import("react").RefObject<HTMLDivElement | null>;
1347
1349
  store: ScrollSpyModel;
1348
1350
  private entries;
1349
1351
  private observer?;
@@ -1351,15 +1353,15 @@ export declare class ScrollSpy<T extends ElementType | undefined = 'div'> extend
1351
1353
  private intersecting;
1352
1354
  private atBottom;
1353
1355
  private mounted;
1354
- sentinel: import("react").RefObject<HTMLDivElement>;
1356
+ sentinel: import("react").RefObject<HTMLDivElement | null>;
1355
1357
  componentDidMount(): void;
1356
1358
  componentDidUpdate(previous: ScrollSpyProps): void;
1357
1359
  componentWillUnmount(): void;
1358
1360
  refresh: () => void;
1359
1361
  handleResize: () => void;
1360
- handleScroll: () => Record<"line" | "top" | "height" | "width" | "left", number> & {
1362
+ handleScroll: () => (Record<"line" | "height" | "width" | "top" | "left", number> & {
1361
1363
  atBottom: boolean;
1362
- };
1364
+ }) | undefined;
1363
1365
  private getRootHeight;
1364
1366
  private getRootMargin;
1365
1367
  private rebuildObservers;
@@ -1367,7 +1369,7 @@ export declare class ScrollSpy<T extends ElementType | undefined = 'div'> extend
1367
1369
  private getActivationLine;
1368
1370
  private updateGuides;
1369
1371
  private updateActive;
1370
- renderDebug: () => import("react").ReactPortal;
1372
+ renderDebug: () => import("react").ReactPortal | null;
1371
1373
  render(): import("react").JSX.Element;
1372
1374
  }
1373
1375
  export type StackDirection = 'horizontal' | 'vertical';
@@ -1415,7 +1417,7 @@ export declare class Tabs<T extends ElementType | undefined = 'div'> extends Com
1415
1417
  readonly props: PolymorphicClassProps<T, TabsProps>;
1416
1418
  protected get componentProps(): Readonly<TabsProps & AsProps>;
1417
1419
  get tabs(): import("react").ReactElement<TabProps, string | import("react").JSXElementConstructor<any>>[];
1418
- root: import("react").RefObject<HTMLDivElement>;
1420
+ root: import("react").RefObject<HTMLDivElement | null>;
1419
1421
  accessor selectedKey: string;
1420
1422
  get activeKey(): string;
1421
1423
  handleClick: (event: MouseEvent$1<HTMLDivElement>) => void;
@@ -1475,20 +1477,16 @@ export declare class Toast {
1475
1477
  open(message: ToastMessage): Promise<ToastEntry>;
1476
1478
  close(id: string): void;
1477
1479
  }
1478
- export interface ToggleButtonProps extends Omit<ComponentPropsWithRef<'label'>, 'onChange'> {
1480
+ type NativeInputProps = Omit<ComponentPropsWithRef<'input'>, 'ref' | 'type' | 'size'>;
1481
+ export type ToggleButtonProps = Omit<ComponentPropsWithRef<'label'>, keyof NativeInputProps | 'onChange'> & NativeInputProps & {
1479
1482
  type?: 'checkbox' | 'radio';
1480
1483
  variant?: 'solid' | 'outline' | 'subtle' | 'text';
1481
1484
  theme?: ComponentTheme;
1482
- name?: string;
1483
- value?: string;
1484
- checked?: boolean;
1485
- defaultChecked?: boolean;
1486
- disabled?: boolean;
1487
- required?: boolean;
1488
1485
  size?: 'xs' | 'sm' | 'lg';
1489
- inputProps?: Omit<ComponentPropsWithRef<'input'>, 'type' | 'name' | 'value' | 'checked' | 'defaultChecked' | 'disabled' | 'required'>;
1490
- onChange?: ComponentPropsWithRef<'input'>['onChange'];
1491
- }
1486
+ inputRef?: Ref<HTMLInputElement>;
1487
+ inputClassName?: string;
1488
+ inputStyle?: CSSProperties;
1489
+ };
1492
1490
  export declare const ToggleButton: PolymorphicComponent<ToggleButtonProps>;
1493
1491
  export interface TogglerProps extends Omit<ButtonHTMLAttributes<HTMLElement>, 'value'> {
1494
1492
  as?: 'button' | 'div' | 'span';
package/dist/index.d.ts CHANGED
@@ -95,7 +95,7 @@ export declare class Alert<T extends ElementType | undefined = 'div'> extends Co
95
95
  static displayName: string;
96
96
  accessor hiding: boolean;
97
97
  accessor closed: boolean;
98
- root: import("react").RefObject<HTMLDivElement>;
98
+ root: import("react").RefObject<HTMLDivElement | null>;
99
99
  timer?: ReturnType<typeof setTimeout>;
100
100
  notified: boolean;
101
101
  componentDidUpdate(): void;
@@ -105,7 +105,7 @@ export declare class Alert<T extends ElementType | undefined = 'div'> extends Co
105
105
  static milliseconds: (value: string) => number;
106
106
  handleClose: (event: MouseEvent$1<HTMLButtonElement>) => void;
107
107
  handleTransitionEnd: (event: TransitionEvent<HTMLDivElement>) => void;
108
- render(): import("react").JSX.Element;
108
+ render(): import("react").JSX.Element | null;
109
109
  }
110
110
  export declare const AlertLink: PolymorphicComponent<import("react").DetailedHTMLProps<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>>;
111
111
  export declare const AlertHeading: PolymorphicComponent<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>>;
@@ -241,8 +241,8 @@ export interface CarouselProps extends Omit<ComponentPropsWithRef<'div'>, 'onCha
241
241
  export declare class Carousel<T extends ElementType | undefined = 'div'> extends Component<PolymorphicClassProps<T, CarouselProps>> {
242
242
  readonly props: PolymorphicClassProps<T, CarouselProps>;
243
243
  static displayName: string;
244
- root: import("react").RefObject<HTMLDivElement>;
245
- track: import("react").RefObject<HTMLDivElement>;
244
+ root: import("react").RefObject<HTMLDivElement | null>;
245
+ track: import("react").RefObject<HTMLDivElement | null>;
246
246
  store: CarouselModel;
247
247
  scroller: CarouselScroll;
248
248
  componentDidMount(): void;
@@ -261,9 +261,9 @@ export declare class Carousel<T extends ElementType | undefined = 'div'> extends
261
261
  handleClick: (event: MouseEvent$1<HTMLDivElement>) => void;
262
262
  scrollToActive: (index: number, from: number, direction?: -1 | 1) => void;
263
263
  renderSlide: (slide: ReactNode, index: number) => import("react").JSX.Element;
264
- renderControls: () => import("react").JSX.Element;
265
- renderIndicators: () => import("react").JSX.Element;
266
- renderPlayPause: () => import("react").JSX.Element;
264
+ renderControls: () => import("react").JSX.Element | null;
265
+ renderIndicators: () => import("react").JSX.Element | null;
266
+ renderPlayPause: () => false | import("react").JSX.Element | undefined;
267
267
  render(): import("react").JSX.Element;
268
268
  }
269
269
  export interface CloseButtonProps extends ComponentPropsWithRef<'button'> {
@@ -282,7 +282,7 @@ export declare class Collapse<T extends ElementType | undefined = 'div'> extends
282
282
  protected get componentProps(): Readonly<CollapseProps & AsProps>;
283
283
  static displayName: string;
284
284
  accessor expanded: boolean;
285
- root: import("react").RefObject<HTMLDivElement>;
285
+ root: import("react").RefObject<HTMLDivElement | null>;
286
286
  get isOpen(): boolean;
287
287
  componentDidMount(): void;
288
288
  componentDidUpdate(previous: CollapseProps): void;
@@ -320,13 +320,12 @@ export type Breakpoint = 'sm' | 'md' | 'lg' | 'xl' | '2xl';
320
320
  export type ColSize = number | 'auto';
321
321
  export type BreakpointColSize = ColSize | true;
322
322
  export interface ContainerProps extends ComponentPropsWithRef<'div'> {
323
- fluid?: boolean;
324
- breakpoint?: Breakpoint;
323
+ fluid?: boolean | Breakpoint;
325
324
  }
326
325
  export declare const Container: PolymorphicComponent<ContainerProps>;
327
326
  export type RowCols = number | 'auto';
328
327
  export interface RowProps extends ComponentPropsWithRef<'div'> {
329
- cols?: RowCols;
328
+ xs?: RowCols;
330
329
  sm?: RowCols;
331
330
  md?: RowCols;
332
331
  lg?: RowCols;
@@ -335,7 +334,7 @@ export interface RowProps extends ComponentPropsWithRef<'div'> {
335
334
  }
336
335
  export declare const Row: PolymorphicComponent<RowProps>;
337
336
  export interface ColProps extends ComponentPropsWithRef<'div'> {
338
- span?: ColSize;
337
+ xs?: BreakpointColSize;
339
338
  sm?: BreakpointColSize;
340
339
  md?: BreakpointColSize;
341
340
  lg?: BreakpointColSize;
@@ -365,7 +364,7 @@ export declare class NativeDialog<T extends ElementType | undefined = 'dialog'>
365
364
  protected get componentProps(): Readonly<NativeDialogProps & AsProps>;
366
365
  static scrollLocks: Set<NativeDialog<ElementType>>;
367
366
  static bodyOverflow: string;
368
- element: import("react").RefObject<HTMLDialogElement>;
367
+ element: import("react").RefObject<HTMLDialogElement | null>;
369
368
  returnFocus?: HTMLElement;
370
369
  switchingMode: boolean;
371
370
  closeTimer?: ReturnType<typeof setTimeout>;
@@ -406,7 +405,7 @@ export declare class Drawer<T extends ElementType | undefined = 'dialog'> extend
406
405
  protected get componentProps(): Readonly<DrawerProps & AsProps>;
407
406
  static displayName: string;
408
407
  accessor expanded: boolean;
409
- dialog: import("react").RefObject<NativeDialog<ElementType>>;
408
+ dialog: import("react").RefObject<NativeDialog<ElementType> | null>;
410
409
  media?: MediaQueryList;
411
410
  dismissed: boolean;
412
411
  componentDidMount(): void;
@@ -425,7 +424,7 @@ export type ClickBoundaryProps = PropsWithChildren<{
425
424
  export declare class ClickBoundary<T extends ElementType | undefined = 'div'> extends PureComponent<PolymorphicClassProps<T, ClickBoundaryProps>> {
426
425
  readonly props: PolymorphicClassProps<T, ClickBoundaryProps>;
427
426
  protected get componentProps(): Readonly<ClickBoundaryProps & AsProps>;
428
- root: import("react").RefObject<HTMLDivElement>;
427
+ root: import("react").RefObject<HTMLDivElement | null>;
429
428
  switchClick: (event: MouseEvent) => void;
430
429
  componentDidMount(): void;
431
430
  componentWillUnmount(): void;
@@ -487,8 +486,8 @@ export declare class Editor<T extends ElementType | undefined = 'div'> extends C
487
486
  protected get componentProps(): Readonly<EditorProps & AsProps>;
488
487
  static displayName: string;
489
488
  private core?;
490
- accessor innerValue: import("@editorjs/editorjs").OutputData;
491
- setInnerValue: (value: typeof this.innerValue) => import("@editorjs/editorjs").OutputData;
489
+ accessor innerValue: import("@editorjs/editorjs").OutputData | undefined;
490
+ setInnerValue: (value: typeof this.innerValue) => import("@editorjs/editorjs").OutputData | undefined;
492
491
  handleBlur: (event: FocusEvent<HTMLDivElement>) => Promise<void>;
493
492
  initialize: (core: EditorCore) => void;
494
493
  render(): import("react").JSX.Element;
@@ -607,13 +606,13 @@ export declare class OverlayBox<T extends ElementType | undefined = 'span'> exte
607
606
  static displayName: string;
608
607
  accessor open: boolean;
609
608
  id: string;
610
- root: import("react").RefObject<HTMLSpanElement>;
611
- overlay: import("react").RefObject<HTMLDivElement>;
609
+ root: import("react").RefObject<HTMLSpanElement | null>;
610
+ overlay: import("react").RefObject<HTMLDivElement | null>;
612
611
  position: FloatingPosition;
613
612
  timer?: ReturnType<typeof setTimeout>;
614
613
  setOpen: (open: boolean) => boolean;
615
614
  hide: () => void;
616
- setOpenAfterDelay: (open: boolean) => boolean;
615
+ setOpenAfterDelay: (open: boolean) => boolean | undefined;
617
616
  componentWillUnmount(): void;
618
617
  componentDidMount(): void;
619
618
  componentDidUpdate(previous: OverlayBoxProps): void;
@@ -663,7 +662,7 @@ export declare class PageNav<T extends ElementType | undefined = 'nav'> extends
663
662
  initList(): void;
664
663
  componentWillUnmount(): void;
665
664
  scrollTo: (meta: HeadingMeta) => () => void;
666
- renderLink: ({ id, level, text, top }: HeadingMeta) => import("react").JSX.Element;
665
+ renderLink: ({ id, level, text, top }: HeadingMeta) => false | import("react").JSX.Element;
667
666
  render(): import("react").JSX.Element;
668
667
  }
669
668
  export type ScrollNavProps = NavProps;
@@ -698,7 +697,7 @@ export declare function elementToImage(element: HTMLElement, type?: string, qual
698
697
  export type ShareBoxProps = HTMLAttributes<HTMLDivElement> & ShareData;
699
698
  export declare class ShareBox extends Component<ShareBoxProps> {
700
699
  static displayName: string;
701
- root: import("react").RefObject<HTMLDivElement>;
700
+ root: import("react").RefObject<HTMLDivElement | null>;
702
701
  accessor loading: boolean;
703
702
  accessor imageURI: string;
704
703
  componentDidMount(): void;
@@ -831,7 +830,7 @@ export type CheckboxProps = Omit<ComponentPropsWithoutRef<'input'>, 'type' | 'si
831
830
  theme?: ComponentTheme;
832
831
  indeterminate?: boolean;
833
832
  };
834
- export declare const Checkbox: PolymorphicComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "type" | "size"> & FormValidationProps & {
833
+ export declare const Checkbox: PolymorphicComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "size" | "type"> & FormValidationProps & {
835
834
  size?: "sm" | "lg";
836
835
  theme?: ComponentTheme;
837
836
  indeterminate?: boolean;
@@ -1015,8 +1014,8 @@ export declare class MenuSubmenu<T extends ElementType | undefined = 'div'> exte
1015
1014
  readonly props: PolymorphicClassProps<T, MenuSubmenuProps>;
1016
1015
  protected get componentProps(): Readonly<MenuSubmenuProps & AsProps>;
1017
1016
  accessor open: boolean;
1018
- panel: import("react").RefObject<HTMLDivElement>;
1019
- trigger: import("react").RefObject<HTMLButtonElement>;
1017
+ panel: import("react").RefObject<HTMLDivElement | null>;
1018
+ trigger: import("react").RefObject<HTMLButtonElement | null>;
1020
1019
  position: FloatingPosition;
1021
1020
  componentDidUpdate(): void;
1022
1021
  componentWillUnmount(): void;
@@ -1054,9 +1053,9 @@ export declare class Menu<T extends ElementType | undefined = 'div'> extends Com
1054
1053
  protected get componentProps(): Readonly<MenuProps & AsProps>;
1055
1054
  accessor open: boolean;
1056
1055
  accessor responsiveDirection: MenuPlacement | undefined;
1057
- root: import("react").RefObject<HTMLDivElement>;
1058
- trigger: import("react").RefObject<HTMLButtonElement>;
1059
- panel: import("react").RefObject<HTMLDivElement>;
1056
+ root: import("react").RefObject<HTMLDivElement | null>;
1057
+ trigger: import("react").RefObject<HTMLButtonElement | null>;
1058
+ panel: import("react").RefObject<HTMLDivElement | null>;
1060
1059
  media: {
1061
1060
  query: MediaQueryList;
1062
1061
  placement: MenuPlacement;
@@ -1066,7 +1065,7 @@ export declare class Menu<T extends ElementType | undefined = 'div'> extends Com
1066
1065
  componentDidUpdate({ responsivePlacement }: MenuProps): void;
1067
1066
  componentWillUnmount(): void;
1068
1067
  observePlacement: () => void;
1069
- handlePlacement: () => MenuPlacement;
1068
+ handlePlacement: () => MenuPlacement | undefined;
1070
1069
  setOpen: (open: boolean) => void;
1071
1070
  handleOutside: ({ target }: PointerEvent) => void;
1072
1071
  items(panel?: HTMLElement | null): HTMLElement[];
@@ -1118,7 +1117,7 @@ export type OTPInputProps = Omit<ComponentPropsWithoutRef<'input'>, 'type' | 'ma
1118
1117
  onComplete?: (value: string) => unknown;
1119
1118
  onValueChange?: (value: string) => unknown;
1120
1119
  };
1121
- export declare const OTPInput: PolymorphicComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "type" | "size" | "maxLength"> & FormValidationProps & {
1120
+ export declare const OTPInput: PolymorphicComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "size" | "type" | "maxLength"> & FormValidationProps & {
1122
1121
  length: number;
1123
1122
  type?: "numeric" | "alphanumeric" | "alpha";
1124
1123
  mask?: boolean;
@@ -1170,12 +1169,15 @@ export declare const FormRange: PolymorphicComponent<Omit<Omit<import("react").D
1170
1169
  } & {
1171
1170
  ref?: Ref<HTMLInputElement>;
1172
1171
  }>;
1173
- export type FormSwitchProps = Omit<ComponentPropsWithRef<'label'>, 'children'> & PropsWithChildren<FormValidationProps & {
1174
- inputProps?: Omit<ComponentPropsWithRef<'input'>, 'type'>;
1172
+ type NativeInputProps$1 = Omit<ComponentPropsWithRef<'input'>, 'ref' | 'type' | 'size'>;
1173
+ export type FormSwitchProps = Omit<ComponentPropsWithRef<'label'>, keyof NativeInputProps$1 | 'children'> & PropsWithChildren<NativeInputProps$1 & FormValidationProps & {
1175
1174
  size?: 'sm' | 'lg';
1176
1175
  theme?: ComponentTheme;
1177
- width?: string;
1178
1176
  indicatorWidth?: string;
1177
+ inputRef?: Ref<HTMLInputElement>;
1178
+ inputId?: string;
1179
+ inputClassName?: string;
1180
+ inputStyle?: CSSProperties;
1179
1181
  }>;
1180
1182
  export declare const FormSwitch: PolymorphicComponent<FormSwitchProps>;
1181
1183
  export interface ImageProps extends ComponentPropsWithRef<'img'> {
@@ -1263,9 +1265,9 @@ export declare class NavOverflow<T extends ElementType | undefined = 'div'> exte
1263
1265
  readonly props: PolymorphicClassProps<T, NavOverflowProps>;
1264
1266
  protected get componentProps(): Readonly<NavOverflowProps & AsProps>;
1265
1267
  static displayName: string;
1266
- root: import("react").RefObject<HTMLDivElement>;
1267
- nav: import("react").RefObject<HTMLElement>;
1268
- toggleButton: import("react").RefObject<HTMLButtonElement>;
1268
+ root: import("react").RefObject<HTMLDivElement | null>;
1269
+ nav: import("react").RefObject<HTMLElement | null>;
1270
+ toggleButton: import("react").RefObject<HTMLButtonElement | null>;
1269
1271
  store: NavOverflowModel;
1270
1272
  private resizeObserver?;
1271
1273
  componentDidMount(): void;
@@ -1323,9 +1325,9 @@ declare class ScrollSpyModel {
1323
1325
  accessor guides: (Record<'top' | 'left' | 'width' | 'height' | 'line', number> & {
1324
1326
  atBottom: boolean;
1325
1327
  }) | undefined;
1326
- setGuides: (guides: ScrollSpyModel["guides"]) => Record<"line" | "top" | "height" | "width" | "left", number> & {
1328
+ setGuides: (guides: ScrollSpyModel["guides"]) => (Record<"line" | "height" | "width" | "top" | "left", number> & {
1327
1329
  atBottom: boolean;
1328
- };
1330
+ }) | undefined;
1329
1331
  setActiveId: (id: string) => string;
1330
1332
  }
1331
1333
  export interface ScrollSpyProps extends Omit<ComponentPropsWithRef<'div'>, 'onChange' | 'children'> {
@@ -1343,7 +1345,7 @@ export declare class ScrollSpy<T extends ElementType | undefined = 'div'> extend
1343
1345
  readonly props: PolymorphicClassProps<T, ScrollSpyProps>;
1344
1346
  protected get componentProps(): Readonly<ScrollSpyProps & AsProps>;
1345
1347
  static displayName: string;
1346
- root: import("react").RefObject<HTMLDivElement>;
1348
+ root: import("react").RefObject<HTMLDivElement | null>;
1347
1349
  store: ScrollSpyModel;
1348
1350
  private entries;
1349
1351
  private observer?;
@@ -1351,15 +1353,15 @@ export declare class ScrollSpy<T extends ElementType | undefined = 'div'> extend
1351
1353
  private intersecting;
1352
1354
  private atBottom;
1353
1355
  private mounted;
1354
- sentinel: import("react").RefObject<HTMLDivElement>;
1356
+ sentinel: import("react").RefObject<HTMLDivElement | null>;
1355
1357
  componentDidMount(): void;
1356
1358
  componentDidUpdate(previous: ScrollSpyProps): void;
1357
1359
  componentWillUnmount(): void;
1358
1360
  refresh: () => void;
1359
1361
  handleResize: () => void;
1360
- handleScroll: () => Record<"line" | "top" | "height" | "width" | "left", number> & {
1362
+ handleScroll: () => (Record<"line" | "height" | "width" | "top" | "left", number> & {
1361
1363
  atBottom: boolean;
1362
- };
1364
+ }) | undefined;
1363
1365
  private getRootHeight;
1364
1366
  private getRootMargin;
1365
1367
  private rebuildObservers;
@@ -1367,7 +1369,7 @@ export declare class ScrollSpy<T extends ElementType | undefined = 'div'> extend
1367
1369
  private getActivationLine;
1368
1370
  private updateGuides;
1369
1371
  private updateActive;
1370
- renderDebug: () => import("react").ReactPortal;
1372
+ renderDebug: () => import("react").ReactPortal | null;
1371
1373
  render(): import("react").JSX.Element;
1372
1374
  }
1373
1375
  export type StackDirection = 'horizontal' | 'vertical';
@@ -1415,7 +1417,7 @@ export declare class Tabs<T extends ElementType | undefined = 'div'> extends Com
1415
1417
  readonly props: PolymorphicClassProps<T, TabsProps>;
1416
1418
  protected get componentProps(): Readonly<TabsProps & AsProps>;
1417
1419
  get tabs(): import("react").ReactElement<TabProps, string | import("react").JSXElementConstructor<any>>[];
1418
- root: import("react").RefObject<HTMLDivElement>;
1420
+ root: import("react").RefObject<HTMLDivElement | null>;
1419
1421
  accessor selectedKey: string;
1420
1422
  get activeKey(): string;
1421
1423
  handleClick: (event: MouseEvent$1<HTMLDivElement>) => void;
@@ -1475,20 +1477,16 @@ export declare class Toast {
1475
1477
  open(message: ToastMessage): Promise<ToastEntry>;
1476
1478
  close(id: string): void;
1477
1479
  }
1478
- export interface ToggleButtonProps extends Omit<ComponentPropsWithRef<'label'>, 'onChange'> {
1480
+ type NativeInputProps = Omit<ComponentPropsWithRef<'input'>, 'ref' | 'type' | 'size'>;
1481
+ export type ToggleButtonProps = Omit<ComponentPropsWithRef<'label'>, keyof NativeInputProps | 'onChange'> & NativeInputProps & {
1479
1482
  type?: 'checkbox' | 'radio';
1480
1483
  variant?: 'solid' | 'outline' | 'subtle' | 'text';
1481
1484
  theme?: ComponentTheme;
1482
- name?: string;
1483
- value?: string;
1484
- checked?: boolean;
1485
- defaultChecked?: boolean;
1486
- disabled?: boolean;
1487
- required?: boolean;
1488
1485
  size?: 'xs' | 'sm' | 'lg';
1489
- inputProps?: Omit<ComponentPropsWithRef<'input'>, 'type' | 'name' | 'value' | 'checked' | 'defaultChecked' | 'disabled' | 'required'>;
1490
- onChange?: ComponentPropsWithRef<'input'>['onChange'];
1491
- }
1486
+ inputRef?: Ref<HTMLInputElement>;
1487
+ inputClassName?: string;
1488
+ inputStyle?: CSSProperties;
1489
+ };
1492
1490
  export declare const ToggleButton: PolymorphicComponent<ToggleButtonProps>;
1493
1491
  export interface TogglerProps extends Omit<ButtonHTMLAttributes<HTMLElement>, 'value'> {
1494
1492
  as?: 'button' | 'div' | 'span';