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

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;
@@ -365,7 +365,7 @@ export declare class NativeDialog<T extends ElementType | undefined = 'dialog'>
365
365
  protected get componentProps(): Readonly<NativeDialogProps & AsProps>;
366
366
  static scrollLocks: Set<NativeDialog<ElementType>>;
367
367
  static bodyOverflow: string;
368
- element: import("react").RefObject<HTMLDialogElement>;
368
+ element: import("react").RefObject<HTMLDialogElement | null>;
369
369
  returnFocus?: HTMLElement;
370
370
  switchingMode: boolean;
371
371
  closeTimer?: ReturnType<typeof setTimeout>;
@@ -406,7 +406,7 @@ export declare class Drawer<T extends ElementType | undefined = 'dialog'> extend
406
406
  protected get componentProps(): Readonly<DrawerProps & AsProps>;
407
407
  static displayName: string;
408
408
  accessor expanded: boolean;
409
- dialog: import("react").RefObject<NativeDialog<ElementType>>;
409
+ dialog: import("react").RefObject<NativeDialog<ElementType> | null>;
410
410
  media?: MediaQueryList;
411
411
  dismissed: boolean;
412
412
  componentDidMount(): void;
@@ -425,7 +425,7 @@ export type ClickBoundaryProps = PropsWithChildren<{
425
425
  export declare class ClickBoundary<T extends ElementType | undefined = 'div'> extends PureComponent<PolymorphicClassProps<T, ClickBoundaryProps>> {
426
426
  readonly props: PolymorphicClassProps<T, ClickBoundaryProps>;
427
427
  protected get componentProps(): Readonly<ClickBoundaryProps & AsProps>;
428
- root: import("react").RefObject<HTMLDivElement>;
428
+ root: import("react").RefObject<HTMLDivElement | null>;
429
429
  switchClick: (event: MouseEvent) => void;
430
430
  componentDidMount(): void;
431
431
  componentWillUnmount(): void;
@@ -487,8 +487,8 @@ export declare class Editor<T extends ElementType | undefined = 'div'> extends C
487
487
  protected get componentProps(): Readonly<EditorProps & AsProps>;
488
488
  static displayName: string;
489
489
  private core?;
490
- accessor innerValue: import("@editorjs/editorjs").OutputData;
491
- setInnerValue: (value: typeof this.innerValue) => import("@editorjs/editorjs").OutputData;
490
+ accessor innerValue: import("@editorjs/editorjs").OutputData | undefined;
491
+ setInnerValue: (value: typeof this.innerValue) => import("@editorjs/editorjs").OutputData | undefined;
492
492
  handleBlur: (event: FocusEvent<HTMLDivElement>) => Promise<void>;
493
493
  initialize: (core: EditorCore) => void;
494
494
  render(): import("react").JSX.Element;
@@ -607,13 +607,13 @@ export declare class OverlayBox<T extends ElementType | undefined = 'span'> exte
607
607
  static displayName: string;
608
608
  accessor open: boolean;
609
609
  id: string;
610
- root: import("react").RefObject<HTMLSpanElement>;
611
- overlay: import("react").RefObject<HTMLDivElement>;
610
+ root: import("react").RefObject<HTMLSpanElement | null>;
611
+ overlay: import("react").RefObject<HTMLDivElement | null>;
612
612
  position: FloatingPosition;
613
613
  timer?: ReturnType<typeof setTimeout>;
614
614
  setOpen: (open: boolean) => boolean;
615
615
  hide: () => void;
616
- setOpenAfterDelay: (open: boolean) => boolean;
616
+ setOpenAfterDelay: (open: boolean) => boolean | undefined;
617
617
  componentWillUnmount(): void;
618
618
  componentDidMount(): void;
619
619
  componentDidUpdate(previous: OverlayBoxProps): void;
@@ -663,7 +663,7 @@ export declare class PageNav<T extends ElementType | undefined = 'nav'> extends
663
663
  initList(): void;
664
664
  componentWillUnmount(): void;
665
665
  scrollTo: (meta: HeadingMeta) => () => void;
666
- renderLink: ({ id, level, text, top }: HeadingMeta) => import("react").JSX.Element;
666
+ renderLink: ({ id, level, text, top }: HeadingMeta) => false | import("react").JSX.Element;
667
667
  render(): import("react").JSX.Element;
668
668
  }
669
669
  export type ScrollNavProps = NavProps;
@@ -698,7 +698,7 @@ export declare function elementToImage(element: HTMLElement, type?: string, qual
698
698
  export type ShareBoxProps = HTMLAttributes<HTMLDivElement> & ShareData;
699
699
  export declare class ShareBox extends Component<ShareBoxProps> {
700
700
  static displayName: string;
701
- root: import("react").RefObject<HTMLDivElement>;
701
+ root: import("react").RefObject<HTMLDivElement | null>;
702
702
  accessor loading: boolean;
703
703
  accessor imageURI: string;
704
704
  componentDidMount(): void;
@@ -1015,8 +1015,8 @@ export declare class MenuSubmenu<T extends ElementType | undefined = 'div'> exte
1015
1015
  readonly props: PolymorphicClassProps<T, MenuSubmenuProps>;
1016
1016
  protected get componentProps(): Readonly<MenuSubmenuProps & AsProps>;
1017
1017
  accessor open: boolean;
1018
- panel: import("react").RefObject<HTMLDivElement>;
1019
- trigger: import("react").RefObject<HTMLButtonElement>;
1018
+ panel: import("react").RefObject<HTMLDivElement | null>;
1019
+ trigger: import("react").RefObject<HTMLButtonElement | null>;
1020
1020
  position: FloatingPosition;
1021
1021
  componentDidUpdate(): void;
1022
1022
  componentWillUnmount(): void;
@@ -1054,9 +1054,9 @@ export declare class Menu<T extends ElementType | undefined = 'div'> extends Com
1054
1054
  protected get componentProps(): Readonly<MenuProps & AsProps>;
1055
1055
  accessor open: boolean;
1056
1056
  accessor responsiveDirection: MenuPlacement | undefined;
1057
- root: import("react").RefObject<HTMLDivElement>;
1058
- trigger: import("react").RefObject<HTMLButtonElement>;
1059
- panel: import("react").RefObject<HTMLDivElement>;
1057
+ root: import("react").RefObject<HTMLDivElement | null>;
1058
+ trigger: import("react").RefObject<HTMLButtonElement | null>;
1059
+ panel: import("react").RefObject<HTMLDivElement | null>;
1060
1060
  media: {
1061
1061
  query: MediaQueryList;
1062
1062
  placement: MenuPlacement;
@@ -1066,7 +1066,7 @@ export declare class Menu<T extends ElementType | undefined = 'div'> extends Com
1066
1066
  componentDidUpdate({ responsivePlacement }: MenuProps): void;
1067
1067
  componentWillUnmount(): void;
1068
1068
  observePlacement: () => void;
1069
- handlePlacement: () => MenuPlacement;
1069
+ handlePlacement: () => MenuPlacement | undefined;
1070
1070
  setOpen: (open: boolean) => void;
1071
1071
  handleOutside: ({ target }: PointerEvent) => void;
1072
1072
  items(panel?: HTMLElement | null): HTMLElement[];
@@ -1170,12 +1170,15 @@ export declare const FormRange: PolymorphicComponent<Omit<Omit<import("react").D
1170
1170
  } & {
1171
1171
  ref?: Ref<HTMLInputElement>;
1172
1172
  }>;
1173
- export type FormSwitchProps = Omit<ComponentPropsWithRef<'label'>, 'children'> & PropsWithChildren<FormValidationProps & {
1174
- inputProps?: Omit<ComponentPropsWithRef<'input'>, 'type'>;
1173
+ type NativeInputProps$1 = Omit<ComponentPropsWithRef<'input'>, 'ref' | 'type' | 'size'>;
1174
+ export type FormSwitchProps = Omit<ComponentPropsWithRef<'label'>, keyof NativeInputProps$1 | 'children'> & PropsWithChildren<NativeInputProps$1 & FormValidationProps & {
1175
1175
  size?: 'sm' | 'lg';
1176
1176
  theme?: ComponentTheme;
1177
- width?: string;
1178
1177
  indicatorWidth?: string;
1178
+ inputRef?: Ref<HTMLInputElement>;
1179
+ inputId?: string;
1180
+ inputClassName?: string;
1181
+ inputStyle?: CSSProperties;
1179
1182
  }>;
1180
1183
  export declare const FormSwitch: PolymorphicComponent<FormSwitchProps>;
1181
1184
  export interface ImageProps extends ComponentPropsWithRef<'img'> {
@@ -1263,9 +1266,9 @@ export declare class NavOverflow<T extends ElementType | undefined = 'div'> exte
1263
1266
  readonly props: PolymorphicClassProps<T, NavOverflowProps>;
1264
1267
  protected get componentProps(): Readonly<NavOverflowProps & AsProps>;
1265
1268
  static displayName: string;
1266
- root: import("react").RefObject<HTMLDivElement>;
1267
- nav: import("react").RefObject<HTMLElement>;
1268
- toggleButton: import("react").RefObject<HTMLButtonElement>;
1269
+ root: import("react").RefObject<HTMLDivElement | null>;
1270
+ nav: import("react").RefObject<HTMLElement | null>;
1271
+ toggleButton: import("react").RefObject<HTMLButtonElement | null>;
1269
1272
  store: NavOverflowModel;
1270
1273
  private resizeObserver?;
1271
1274
  componentDidMount(): void;
@@ -1323,9 +1326,9 @@ declare class ScrollSpyModel {
1323
1326
  accessor guides: (Record<'top' | 'left' | 'width' | 'height' | 'line', number> & {
1324
1327
  atBottom: boolean;
1325
1328
  }) | undefined;
1326
- setGuides: (guides: ScrollSpyModel["guides"]) => Record<"line" | "top" | "height" | "width" | "left", number> & {
1329
+ setGuides: (guides: ScrollSpyModel["guides"]) => (Record<"line" | "top" | "height" | "width" | "left", number> & {
1327
1330
  atBottom: boolean;
1328
- };
1331
+ }) | undefined;
1329
1332
  setActiveId: (id: string) => string;
1330
1333
  }
1331
1334
  export interface ScrollSpyProps extends Omit<ComponentPropsWithRef<'div'>, 'onChange' | 'children'> {
@@ -1343,7 +1346,7 @@ export declare class ScrollSpy<T extends ElementType | undefined = 'div'> extend
1343
1346
  readonly props: PolymorphicClassProps<T, ScrollSpyProps>;
1344
1347
  protected get componentProps(): Readonly<ScrollSpyProps & AsProps>;
1345
1348
  static displayName: string;
1346
- root: import("react").RefObject<HTMLDivElement>;
1349
+ root: import("react").RefObject<HTMLDivElement | null>;
1347
1350
  store: ScrollSpyModel;
1348
1351
  private entries;
1349
1352
  private observer?;
@@ -1351,15 +1354,15 @@ export declare class ScrollSpy<T extends ElementType | undefined = 'div'> extend
1351
1354
  private intersecting;
1352
1355
  private atBottom;
1353
1356
  private mounted;
1354
- sentinel: import("react").RefObject<HTMLDivElement>;
1357
+ sentinel: import("react").RefObject<HTMLDivElement | null>;
1355
1358
  componentDidMount(): void;
1356
1359
  componentDidUpdate(previous: ScrollSpyProps): void;
1357
1360
  componentWillUnmount(): void;
1358
1361
  refresh: () => void;
1359
1362
  handleResize: () => void;
1360
- handleScroll: () => Record<"line" | "top" | "height" | "width" | "left", number> & {
1363
+ handleScroll: () => (Record<"line" | "top" | "height" | "width" | "left", number> & {
1361
1364
  atBottom: boolean;
1362
- };
1365
+ }) | undefined;
1363
1366
  private getRootHeight;
1364
1367
  private getRootMargin;
1365
1368
  private rebuildObservers;
@@ -1367,7 +1370,7 @@ export declare class ScrollSpy<T extends ElementType | undefined = 'div'> extend
1367
1370
  private getActivationLine;
1368
1371
  private updateGuides;
1369
1372
  private updateActive;
1370
- renderDebug: () => import("react").ReactPortal;
1373
+ renderDebug: () => import("react").ReactPortal | null;
1371
1374
  render(): import("react").JSX.Element;
1372
1375
  }
1373
1376
  export type StackDirection = 'horizontal' | 'vertical';
@@ -1415,7 +1418,7 @@ export declare class Tabs<T extends ElementType | undefined = 'div'> extends Com
1415
1418
  readonly props: PolymorphicClassProps<T, TabsProps>;
1416
1419
  protected get componentProps(): Readonly<TabsProps & AsProps>;
1417
1420
  get tabs(): import("react").ReactElement<TabProps, string | import("react").JSXElementConstructor<any>>[];
1418
- root: import("react").RefObject<HTMLDivElement>;
1421
+ root: import("react").RefObject<HTMLDivElement | null>;
1419
1422
  accessor selectedKey: string;
1420
1423
  get activeKey(): string;
1421
1424
  handleClick: (event: MouseEvent$1<HTMLDivElement>) => void;
@@ -1475,20 +1478,16 @@ export declare class Toast {
1475
1478
  open(message: ToastMessage): Promise<ToastEntry>;
1476
1479
  close(id: string): void;
1477
1480
  }
1478
- export interface ToggleButtonProps extends Omit<ComponentPropsWithRef<'label'>, 'onChange'> {
1481
+ type NativeInputProps = Omit<ComponentPropsWithRef<'input'>, 'ref' | 'type' | 'size'>;
1482
+ export type ToggleButtonProps = Omit<ComponentPropsWithRef<'label'>, keyof NativeInputProps | 'onChange'> & NativeInputProps & {
1479
1483
  type?: 'checkbox' | 'radio';
1480
1484
  variant?: 'solid' | 'outline' | 'subtle' | 'text';
1481
1485
  theme?: ComponentTheme;
1482
- name?: string;
1483
- value?: string;
1484
- checked?: boolean;
1485
- defaultChecked?: boolean;
1486
- disabled?: boolean;
1487
- required?: boolean;
1488
1486
  size?: 'xs' | 'sm' | 'lg';
1489
- inputProps?: Omit<ComponentPropsWithRef<'input'>, 'type' | 'name' | 'value' | 'checked' | 'defaultChecked' | 'disabled' | 'required'>;
1490
- onChange?: ComponentPropsWithRef<'input'>['onChange'];
1491
- }
1487
+ inputRef?: Ref<HTMLInputElement>;
1488
+ inputClassName?: string;
1489
+ inputStyle?: CSSProperties;
1490
+ };
1492
1491
  export declare const ToggleButton: PolymorphicComponent<ToggleButtonProps>;
1493
1492
  export interface TogglerProps extends Omit<ButtonHTMLAttributes<HTMLElement>, 'value'> {
1494
1493
  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;
@@ -365,7 +365,7 @@ export declare class NativeDialog<T extends ElementType | undefined = 'dialog'>
365
365
  protected get componentProps(): Readonly<NativeDialogProps & AsProps>;
366
366
  static scrollLocks: Set<NativeDialog<ElementType>>;
367
367
  static bodyOverflow: string;
368
- element: import("react").RefObject<HTMLDialogElement>;
368
+ element: import("react").RefObject<HTMLDialogElement | null>;
369
369
  returnFocus?: HTMLElement;
370
370
  switchingMode: boolean;
371
371
  closeTimer?: ReturnType<typeof setTimeout>;
@@ -406,7 +406,7 @@ export declare class Drawer<T extends ElementType | undefined = 'dialog'> extend
406
406
  protected get componentProps(): Readonly<DrawerProps & AsProps>;
407
407
  static displayName: string;
408
408
  accessor expanded: boolean;
409
- dialog: import("react").RefObject<NativeDialog<ElementType>>;
409
+ dialog: import("react").RefObject<NativeDialog<ElementType> | null>;
410
410
  media?: MediaQueryList;
411
411
  dismissed: boolean;
412
412
  componentDidMount(): void;
@@ -425,7 +425,7 @@ export type ClickBoundaryProps = PropsWithChildren<{
425
425
  export declare class ClickBoundary<T extends ElementType | undefined = 'div'> extends PureComponent<PolymorphicClassProps<T, ClickBoundaryProps>> {
426
426
  readonly props: PolymorphicClassProps<T, ClickBoundaryProps>;
427
427
  protected get componentProps(): Readonly<ClickBoundaryProps & AsProps>;
428
- root: import("react").RefObject<HTMLDivElement>;
428
+ root: import("react").RefObject<HTMLDivElement | null>;
429
429
  switchClick: (event: MouseEvent) => void;
430
430
  componentDidMount(): void;
431
431
  componentWillUnmount(): void;
@@ -487,8 +487,8 @@ export declare class Editor<T extends ElementType | undefined = 'div'> extends C
487
487
  protected get componentProps(): Readonly<EditorProps & AsProps>;
488
488
  static displayName: string;
489
489
  private core?;
490
- accessor innerValue: import("@editorjs/editorjs").OutputData;
491
- setInnerValue: (value: typeof this.innerValue) => import("@editorjs/editorjs").OutputData;
490
+ accessor innerValue: import("@editorjs/editorjs").OutputData | undefined;
491
+ setInnerValue: (value: typeof this.innerValue) => import("@editorjs/editorjs").OutputData | undefined;
492
492
  handleBlur: (event: FocusEvent<HTMLDivElement>) => Promise<void>;
493
493
  initialize: (core: EditorCore) => void;
494
494
  render(): import("react").JSX.Element;
@@ -607,13 +607,13 @@ export declare class OverlayBox<T extends ElementType | undefined = 'span'> exte
607
607
  static displayName: string;
608
608
  accessor open: boolean;
609
609
  id: string;
610
- root: import("react").RefObject<HTMLSpanElement>;
611
- overlay: import("react").RefObject<HTMLDivElement>;
610
+ root: import("react").RefObject<HTMLSpanElement | null>;
611
+ overlay: import("react").RefObject<HTMLDivElement | null>;
612
612
  position: FloatingPosition;
613
613
  timer?: ReturnType<typeof setTimeout>;
614
614
  setOpen: (open: boolean) => boolean;
615
615
  hide: () => void;
616
- setOpenAfterDelay: (open: boolean) => boolean;
616
+ setOpenAfterDelay: (open: boolean) => boolean | undefined;
617
617
  componentWillUnmount(): void;
618
618
  componentDidMount(): void;
619
619
  componentDidUpdate(previous: OverlayBoxProps): void;
@@ -663,7 +663,7 @@ export declare class PageNav<T extends ElementType | undefined = 'nav'> extends
663
663
  initList(): void;
664
664
  componentWillUnmount(): void;
665
665
  scrollTo: (meta: HeadingMeta) => () => void;
666
- renderLink: ({ id, level, text, top }: HeadingMeta) => import("react").JSX.Element;
666
+ renderLink: ({ id, level, text, top }: HeadingMeta) => false | import("react").JSX.Element;
667
667
  render(): import("react").JSX.Element;
668
668
  }
669
669
  export type ScrollNavProps = NavProps;
@@ -698,7 +698,7 @@ export declare function elementToImage(element: HTMLElement, type?: string, qual
698
698
  export type ShareBoxProps = HTMLAttributes<HTMLDivElement> & ShareData;
699
699
  export declare class ShareBox extends Component<ShareBoxProps> {
700
700
  static displayName: string;
701
- root: import("react").RefObject<HTMLDivElement>;
701
+ root: import("react").RefObject<HTMLDivElement | null>;
702
702
  accessor loading: boolean;
703
703
  accessor imageURI: string;
704
704
  componentDidMount(): void;
@@ -1015,8 +1015,8 @@ export declare class MenuSubmenu<T extends ElementType | undefined = 'div'> exte
1015
1015
  readonly props: PolymorphicClassProps<T, MenuSubmenuProps>;
1016
1016
  protected get componentProps(): Readonly<MenuSubmenuProps & AsProps>;
1017
1017
  accessor open: boolean;
1018
- panel: import("react").RefObject<HTMLDivElement>;
1019
- trigger: import("react").RefObject<HTMLButtonElement>;
1018
+ panel: import("react").RefObject<HTMLDivElement | null>;
1019
+ trigger: import("react").RefObject<HTMLButtonElement | null>;
1020
1020
  position: FloatingPosition;
1021
1021
  componentDidUpdate(): void;
1022
1022
  componentWillUnmount(): void;
@@ -1054,9 +1054,9 @@ export declare class Menu<T extends ElementType | undefined = 'div'> extends Com
1054
1054
  protected get componentProps(): Readonly<MenuProps & AsProps>;
1055
1055
  accessor open: boolean;
1056
1056
  accessor responsiveDirection: MenuPlacement | undefined;
1057
- root: import("react").RefObject<HTMLDivElement>;
1058
- trigger: import("react").RefObject<HTMLButtonElement>;
1059
- panel: import("react").RefObject<HTMLDivElement>;
1057
+ root: import("react").RefObject<HTMLDivElement | null>;
1058
+ trigger: import("react").RefObject<HTMLButtonElement | null>;
1059
+ panel: import("react").RefObject<HTMLDivElement | null>;
1060
1060
  media: {
1061
1061
  query: MediaQueryList;
1062
1062
  placement: MenuPlacement;
@@ -1066,7 +1066,7 @@ export declare class Menu<T extends ElementType | undefined = 'div'> extends Com
1066
1066
  componentDidUpdate({ responsivePlacement }: MenuProps): void;
1067
1067
  componentWillUnmount(): void;
1068
1068
  observePlacement: () => void;
1069
- handlePlacement: () => MenuPlacement;
1069
+ handlePlacement: () => MenuPlacement | undefined;
1070
1070
  setOpen: (open: boolean) => void;
1071
1071
  handleOutside: ({ target }: PointerEvent) => void;
1072
1072
  items(panel?: HTMLElement | null): HTMLElement[];
@@ -1170,12 +1170,15 @@ export declare const FormRange: PolymorphicComponent<Omit<Omit<import("react").D
1170
1170
  } & {
1171
1171
  ref?: Ref<HTMLInputElement>;
1172
1172
  }>;
1173
- export type FormSwitchProps = Omit<ComponentPropsWithRef<'label'>, 'children'> & PropsWithChildren<FormValidationProps & {
1174
- inputProps?: Omit<ComponentPropsWithRef<'input'>, 'type'>;
1173
+ type NativeInputProps$1 = Omit<ComponentPropsWithRef<'input'>, 'ref' | 'type' | 'size'>;
1174
+ export type FormSwitchProps = Omit<ComponentPropsWithRef<'label'>, keyof NativeInputProps$1 | 'children'> & PropsWithChildren<NativeInputProps$1 & FormValidationProps & {
1175
1175
  size?: 'sm' | 'lg';
1176
1176
  theme?: ComponentTheme;
1177
- width?: string;
1178
1177
  indicatorWidth?: string;
1178
+ inputRef?: Ref<HTMLInputElement>;
1179
+ inputId?: string;
1180
+ inputClassName?: string;
1181
+ inputStyle?: CSSProperties;
1179
1182
  }>;
1180
1183
  export declare const FormSwitch: PolymorphicComponent<FormSwitchProps>;
1181
1184
  export interface ImageProps extends ComponentPropsWithRef<'img'> {
@@ -1263,9 +1266,9 @@ export declare class NavOverflow<T extends ElementType | undefined = 'div'> exte
1263
1266
  readonly props: PolymorphicClassProps<T, NavOverflowProps>;
1264
1267
  protected get componentProps(): Readonly<NavOverflowProps & AsProps>;
1265
1268
  static displayName: string;
1266
- root: import("react").RefObject<HTMLDivElement>;
1267
- nav: import("react").RefObject<HTMLElement>;
1268
- toggleButton: import("react").RefObject<HTMLButtonElement>;
1269
+ root: import("react").RefObject<HTMLDivElement | null>;
1270
+ nav: import("react").RefObject<HTMLElement | null>;
1271
+ toggleButton: import("react").RefObject<HTMLButtonElement | null>;
1269
1272
  store: NavOverflowModel;
1270
1273
  private resizeObserver?;
1271
1274
  componentDidMount(): void;
@@ -1323,9 +1326,9 @@ declare class ScrollSpyModel {
1323
1326
  accessor guides: (Record<'top' | 'left' | 'width' | 'height' | 'line', number> & {
1324
1327
  atBottom: boolean;
1325
1328
  }) | undefined;
1326
- setGuides: (guides: ScrollSpyModel["guides"]) => Record<"line" | "top" | "height" | "width" | "left", number> & {
1329
+ setGuides: (guides: ScrollSpyModel["guides"]) => (Record<"line" | "top" | "height" | "width" | "left", number> & {
1327
1330
  atBottom: boolean;
1328
- };
1331
+ }) | undefined;
1329
1332
  setActiveId: (id: string) => string;
1330
1333
  }
1331
1334
  export interface ScrollSpyProps extends Omit<ComponentPropsWithRef<'div'>, 'onChange' | 'children'> {
@@ -1343,7 +1346,7 @@ export declare class ScrollSpy<T extends ElementType | undefined = 'div'> extend
1343
1346
  readonly props: PolymorphicClassProps<T, ScrollSpyProps>;
1344
1347
  protected get componentProps(): Readonly<ScrollSpyProps & AsProps>;
1345
1348
  static displayName: string;
1346
- root: import("react").RefObject<HTMLDivElement>;
1349
+ root: import("react").RefObject<HTMLDivElement | null>;
1347
1350
  store: ScrollSpyModel;
1348
1351
  private entries;
1349
1352
  private observer?;
@@ -1351,15 +1354,15 @@ export declare class ScrollSpy<T extends ElementType | undefined = 'div'> extend
1351
1354
  private intersecting;
1352
1355
  private atBottom;
1353
1356
  private mounted;
1354
- sentinel: import("react").RefObject<HTMLDivElement>;
1357
+ sentinel: import("react").RefObject<HTMLDivElement | null>;
1355
1358
  componentDidMount(): void;
1356
1359
  componentDidUpdate(previous: ScrollSpyProps): void;
1357
1360
  componentWillUnmount(): void;
1358
1361
  refresh: () => void;
1359
1362
  handleResize: () => void;
1360
- handleScroll: () => Record<"line" | "top" | "height" | "width" | "left", number> & {
1363
+ handleScroll: () => (Record<"line" | "top" | "height" | "width" | "left", number> & {
1361
1364
  atBottom: boolean;
1362
- };
1365
+ }) | undefined;
1363
1366
  private getRootHeight;
1364
1367
  private getRootMargin;
1365
1368
  private rebuildObservers;
@@ -1367,7 +1370,7 @@ export declare class ScrollSpy<T extends ElementType | undefined = 'div'> extend
1367
1370
  private getActivationLine;
1368
1371
  private updateGuides;
1369
1372
  private updateActive;
1370
- renderDebug: () => import("react").ReactPortal;
1373
+ renderDebug: () => import("react").ReactPortal | null;
1371
1374
  render(): import("react").JSX.Element;
1372
1375
  }
1373
1376
  export type StackDirection = 'horizontal' | 'vertical';
@@ -1415,7 +1418,7 @@ export declare class Tabs<T extends ElementType | undefined = 'div'> extends Com
1415
1418
  readonly props: PolymorphicClassProps<T, TabsProps>;
1416
1419
  protected get componentProps(): Readonly<TabsProps & AsProps>;
1417
1420
  get tabs(): import("react").ReactElement<TabProps, string | import("react").JSXElementConstructor<any>>[];
1418
- root: import("react").RefObject<HTMLDivElement>;
1421
+ root: import("react").RefObject<HTMLDivElement | null>;
1419
1422
  accessor selectedKey: string;
1420
1423
  get activeKey(): string;
1421
1424
  handleClick: (event: MouseEvent$1<HTMLDivElement>) => void;
@@ -1475,20 +1478,16 @@ export declare class Toast {
1475
1478
  open(message: ToastMessage): Promise<ToastEntry>;
1476
1479
  close(id: string): void;
1477
1480
  }
1478
- export interface ToggleButtonProps extends Omit<ComponentPropsWithRef<'label'>, 'onChange'> {
1481
+ type NativeInputProps = Omit<ComponentPropsWithRef<'input'>, 'ref' | 'type' | 'size'>;
1482
+ export type ToggleButtonProps = Omit<ComponentPropsWithRef<'label'>, keyof NativeInputProps | 'onChange'> & NativeInputProps & {
1479
1483
  type?: 'checkbox' | 'radio';
1480
1484
  variant?: 'solid' | 'outline' | 'subtle' | 'text';
1481
1485
  theme?: ComponentTheme;
1482
- name?: string;
1483
- value?: string;
1484
- checked?: boolean;
1485
- defaultChecked?: boolean;
1486
- disabled?: boolean;
1487
- required?: boolean;
1488
1486
  size?: 'xs' | 'sm' | 'lg';
1489
- inputProps?: Omit<ComponentPropsWithRef<'input'>, 'type' | 'name' | 'value' | 'checked' | 'defaultChecked' | 'disabled' | 'required'>;
1490
- onChange?: ComponentPropsWithRef<'input'>['onChange'];
1491
- }
1487
+ inputRef?: Ref<HTMLInputElement>;
1488
+ inputClassName?: string;
1489
+ inputStyle?: CSSProperties;
1490
+ };
1492
1491
  export declare const ToggleButton: PolymorphicComponent<ToggleButtonProps>;
1493
1492
  export interface TogglerProps extends Omit<ButtonHTMLAttributes<HTMLElement>, 'value'> {
1494
1493
  as?: 'button' | 'div' | 'span';