@wistia/ui 0.18.14-beta.e9acbfe3.e18434d → 0.18.15-beta.41df01b8.25c8f5e

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 (7) hide show
  1. package/dist/index.cjs +768 -755
  2. package/dist/index.cjs.map +1 -1
  3. package/dist/index.d.mts +17 -29
  4. package/dist/index.d.ts +17 -29
  5. package/dist/index.mjs +769 -756
  6. package/dist/index.mjs.map +1 -1
  7. package/package.json +17 -17
package/dist/index.d.mts CHANGED
@@ -99,7 +99,7 @@ type Rect = {
99
99
  x: number;
100
100
  y: number;
101
101
  };
102
- declare const useElementObserver: <T extends HTMLElement>() => [RefObject<T>, Rect];
102
+ declare const useElementObserver: <T extends HTMLElement>() => [RefObject<T | null>, Rect];
103
103
 
104
104
  /**
105
105
  * Hook that wraps `useFilePicker` from the use-file-picker library
@@ -116,7 +116,7 @@ declare const useImperativeFilePicker: <T extends useImperativeFilePickerConfig
116
116
 
117
117
  type UseFocusTrapOptions = {
118
118
  disableAriaHider?: boolean;
119
- focusSelector?: HTMLElement | RefObject<HTMLElement> | string | null | undefined;
119
+ focusSelector?: HTMLElement | RefObject<HTMLElement | null> | string | null | undefined;
120
120
  };
121
121
  declare const useFocusTrap: (active?: boolean, options?: UseFocusTrapOptions) => (node: HTMLElement | null | undefined) => void;
122
122
 
@@ -365,9 +365,7 @@ type ButtonProps = ButtonAsButtonProps | ButtonAsLinkProps;
365
365
  * action, or performing a delete operation. It replaces the HTML `<button>` element,
366
366
  * unless an `href` attribute is passed, in which it will render an `<a>` element.
367
367
  */
368
- declare const Button: react.ForwardRefExoticComponent<(Omit<BaseButtonProps & Omit<react.DetailedHTMLProps<react.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref"> & {
369
- ref?: ((instance: HTMLAnchorElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLAnchorElement> | null | undefined;
370
- } & {
368
+ declare const Button: react.ForwardRefExoticComponent<(Omit<BaseButtonProps & react.ClassAttributes<HTMLAnchorElement> & react.AnchorHTMLAttributes<HTMLAnchorElement> & {
371
369
  beforeAction?: (() => Promise<void>) | (() => void);
372
370
  children: ReactNode;
373
371
  colorScheme?: ColorSchemeTypes;
@@ -398,9 +396,7 @@ declare const Button: react.ForwardRefExoticComponent<(Omit<BaseButtonProps & Om
398
396
  * @ignore
399
397
  */
400
398
  type?: LinkTypes;
401
- }, "ref"> | Omit<BaseButtonProps & Omit<react.DetailedHTMLProps<react.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref"> & {
402
- ref?: ((instance: HTMLAnchorElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLAnchorElement> | null | undefined;
403
- } & {
399
+ }, "ref"> | Omit<BaseButtonProps & react.ClassAttributes<HTMLAnchorElement> & react.AnchorHTMLAttributes<HTMLAnchorElement> & {
404
400
  beforeAction?: (() => Promise<void>) | (() => void);
405
401
  children: ReactNode;
406
402
  colorScheme?: ColorSchemeTypes;
@@ -409,9 +405,7 @@ declare const Button: react.ForwardRefExoticComponent<(Omit<BaseButtonProps & Om
409
405
  rightIcon?: ReactNode | undefined;
410
406
  type?: LinkTypes | undefined;
411
407
  underline?: "always" | "hover" | "none";
412
- } & Omit<react.DetailedHTMLProps<react.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & {
413
- ref?: ((instance: HTMLButtonElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLButtonElement> | null | undefined;
414
- } & {
408
+ } & react.ClassAttributes<HTMLButtonElement> & react.ButtonHTMLAttributes<HTMLButtonElement> & {
415
409
  href?: never;
416
410
  type?: "button" | "reset" | "submit";
417
411
  } & {
@@ -1144,7 +1138,7 @@ type ClickRegionProps = {
1144
1138
  /**
1145
1139
  * The ref to the button or link that should be clicked when the ClickRegion is clicked.
1146
1140
  */
1147
- targetRef: MutableRefObject<HTMLAnchorElement | HTMLButtonElement | null>;
1141
+ targetRef: RefObject<HTMLAnchorElement | HTMLButtonElement | null>;
1148
1142
  };
1149
1143
  /**
1150
1144
  * This allows larger elements to be interactive links or buttons while maintaining acessibility.
@@ -1334,6 +1328,7 @@ declare const iconMap: {
1334
1328
  'private-chat': (props: react.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
1335
1329
  'private-user-sessions': (props: react.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
1336
1330
  project: (props: react.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
1331
+ 'project-open': (props: react.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
1337
1332
  properties: (props: react.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
1338
1333
  'question-mark': (props: react.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
1339
1334
  react: (props: react.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
@@ -1674,7 +1669,7 @@ type ContextMenuProps = {
1674
1669
  } | {
1675
1670
  position?: never;
1676
1671
  side?: never;
1677
- triggerRef: RefObject<HTMLElement>;
1672
+ triggerRef: RefObject<HTMLElement | null>;
1678
1673
  });
1679
1674
  /**
1680
1675
  * The ContextMenu is an extended implementation of the [Menu]() component that allows for right-click context menus.
@@ -1723,7 +1718,7 @@ declare const DataCard: {
1723
1718
  displayName: string;
1724
1719
  };
1725
1720
 
1726
- type DataCardsProps = ComponentPropsWithoutRef<'dl'> & {
1721
+ type DataCardsProps = ComponentPropsWithoutRef<'div'> & {
1727
1722
  /**
1728
1723
  * Should be at least one `DataCard` component
1729
1724
  */
@@ -2865,9 +2860,7 @@ type MenuItemButtonProps = ButtonProps & {
2865
2860
  unstyled?: never;
2866
2861
  };
2867
2862
 
2868
- declare const MenuItem: react.ForwardRefExoticComponent<(Omit<DropdownMenuItemProps & BaseButtonProps & Omit<react.DetailedHTMLProps<react.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref"> & {
2869
- ref?: ((instance: HTMLAnchorElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLAnchorElement> | null | undefined;
2870
- } & {
2863
+ declare const MenuItem: react.ForwardRefExoticComponent<(Omit<DropdownMenuItemProps & BaseButtonProps & react.ClassAttributes<HTMLAnchorElement> & react.AnchorHTMLAttributes<HTMLAnchorElement> & {
2871
2864
  beforeAction?: (() => Promise<void>) | (() => void);
2872
2865
  children: react.ReactNode;
2873
2866
  colorScheme?: ColorSchemeTypes;
@@ -2908,9 +2901,7 @@ declare const MenuItem: react.ForwardRefExoticComponent<(Omit<DropdownMenuItemPr
2908
2901
  * Treats the menu item as a link when provided
2909
2902
  */
2910
2903
  href?: MenuItemButtonProps["href"];
2911
- }, "ref"> | Omit<DropdownMenuItemProps & BaseButtonProps & Omit<react.DetailedHTMLProps<react.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref"> & {
2912
- ref?: ((instance: HTMLAnchorElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLAnchorElement> | null | undefined;
2913
- } & {
2904
+ }, "ref"> | Omit<DropdownMenuItemProps & BaseButtonProps & react.ClassAttributes<HTMLAnchorElement> & react.AnchorHTMLAttributes<HTMLAnchorElement> & {
2914
2905
  beforeAction?: (() => Promise<void>) | (() => void);
2915
2906
  children: react.ReactNode;
2916
2907
  colorScheme?: ColorSchemeTypes;
@@ -2919,9 +2910,7 @@ declare const MenuItem: react.ForwardRefExoticComponent<(Omit<DropdownMenuItemPr
2919
2910
  rightIcon?: react.ReactNode | undefined;
2920
2911
  type?: LinkTypes | undefined;
2921
2912
  underline?: "always" | "hover" | "none";
2922
- } & Omit<react.DetailedHTMLProps<react.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & {
2923
- ref?: ((instance: HTMLButtonElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLButtonElement> | null | undefined;
2924
- } & {
2913
+ } & react.ClassAttributes<HTMLButtonElement> & react.ButtonHTMLAttributes<HTMLButtonElement> & {
2925
2914
  href?: never;
2926
2915
  type?: "button" | "reset" | "submit";
2927
2916
  } & {
@@ -2947,9 +2936,7 @@ declare const MenuItem: react.ForwardRefExoticComponent<(Omit<DropdownMenuItemPr
2947
2936
  * Treats the menu item as a link when provided
2948
2937
  */
2949
2938
  href?: MenuItemButtonProps["href"];
2950
- }, "ref"> | Omit<DropdownMenuItemProps & BaseButtonProps & Omit<react.DetailedHTMLProps<react.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & {
2951
- ref?: ((instance: HTMLButtonElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLButtonElement> | null | undefined;
2952
- } & {
2939
+ }, "ref"> | Omit<DropdownMenuItemProps & BaseButtonProps & react.ClassAttributes<HTMLButtonElement> & react.ButtonHTMLAttributes<HTMLButtonElement> & {
2953
2940
  href?: never;
2954
2941
  type?: "button" | "reset" | "submit";
2955
2942
  children: react.ReactNode;
@@ -3106,7 +3093,7 @@ type ModalProps = ComponentPropsWithoutRef<'div'> & {
3106
3093
  /**
3107
3094
  * Ref to the element that should receive focus when the modal opens
3108
3095
  */
3109
- initialFocusRef?: RefObject<HTMLElement>;
3096
+ initialFocusRef?: RefObject<HTMLElement | null>;
3110
3097
  /**
3111
3098
  * Determines if the modal is currently open
3112
3099
  */
@@ -3154,7 +3141,7 @@ declare const Modal: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProp
3154
3141
  /**
3155
3142
  * Ref to the element that should receive focus when the modal opens
3156
3143
  */
3157
- initialFocusRef?: RefObject<HTMLElement>;
3144
+ initialFocusRef?: RefObject<HTMLElement | null>;
3158
3145
  /**
3159
3146
  * Determines if the modal is currently open
3160
3147
  */
@@ -4373,7 +4360,8 @@ type CustomizableThemeWrapperProps = ComponentPropsWithoutRef<'div'> & {
4373
4360
  overrides: Partial<Record<CustomizableTokens, number | string>>;
4374
4361
  };
4375
4362
  /**
4376
- * Component description goes here
4363
+ * Used for overriding the default theme tokens with custom values.
4364
+ * This should only be used when the ui systems team has been consulted first.
4377
4365
  */
4378
4366
  declare const CustomizableThemeWrapper: {
4379
4367
  ({ children, overrides, ...props }: CustomizableThemeWrapperProps): JSX.Element;
package/dist/index.d.ts CHANGED
@@ -99,7 +99,7 @@ type Rect = {
99
99
  x: number;
100
100
  y: number;
101
101
  };
102
- declare const useElementObserver: <T extends HTMLElement>() => [RefObject<T>, Rect];
102
+ declare const useElementObserver: <T extends HTMLElement>() => [RefObject<T | null>, Rect];
103
103
 
104
104
  /**
105
105
  * Hook that wraps `useFilePicker` from the use-file-picker library
@@ -116,7 +116,7 @@ declare const useImperativeFilePicker: <T extends useImperativeFilePickerConfig
116
116
 
117
117
  type UseFocusTrapOptions = {
118
118
  disableAriaHider?: boolean;
119
- focusSelector?: HTMLElement | RefObject<HTMLElement> | string | null | undefined;
119
+ focusSelector?: HTMLElement | RefObject<HTMLElement | null> | string | null | undefined;
120
120
  };
121
121
  declare const useFocusTrap: (active?: boolean, options?: UseFocusTrapOptions) => (node: HTMLElement | null | undefined) => void;
122
122
 
@@ -365,9 +365,7 @@ type ButtonProps = ButtonAsButtonProps | ButtonAsLinkProps;
365
365
  * action, or performing a delete operation. It replaces the HTML `<button>` element,
366
366
  * unless an `href` attribute is passed, in which it will render an `<a>` element.
367
367
  */
368
- declare const Button: react.ForwardRefExoticComponent<(Omit<BaseButtonProps & Omit<react.DetailedHTMLProps<react.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref"> & {
369
- ref?: ((instance: HTMLAnchorElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLAnchorElement> | null | undefined;
370
- } & {
368
+ declare const Button: react.ForwardRefExoticComponent<(Omit<BaseButtonProps & react.ClassAttributes<HTMLAnchorElement> & react.AnchorHTMLAttributes<HTMLAnchorElement> & {
371
369
  beforeAction?: (() => Promise<void>) | (() => void);
372
370
  children: ReactNode;
373
371
  colorScheme?: ColorSchemeTypes;
@@ -398,9 +396,7 @@ declare const Button: react.ForwardRefExoticComponent<(Omit<BaseButtonProps & Om
398
396
  * @ignore
399
397
  */
400
398
  type?: LinkTypes;
401
- }, "ref"> | Omit<BaseButtonProps & Omit<react.DetailedHTMLProps<react.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref"> & {
402
- ref?: ((instance: HTMLAnchorElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLAnchorElement> | null | undefined;
403
- } & {
399
+ }, "ref"> | Omit<BaseButtonProps & react.ClassAttributes<HTMLAnchorElement> & react.AnchorHTMLAttributes<HTMLAnchorElement> & {
404
400
  beforeAction?: (() => Promise<void>) | (() => void);
405
401
  children: ReactNode;
406
402
  colorScheme?: ColorSchemeTypes;
@@ -409,9 +405,7 @@ declare const Button: react.ForwardRefExoticComponent<(Omit<BaseButtonProps & Om
409
405
  rightIcon?: ReactNode | undefined;
410
406
  type?: LinkTypes | undefined;
411
407
  underline?: "always" | "hover" | "none";
412
- } & Omit<react.DetailedHTMLProps<react.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & {
413
- ref?: ((instance: HTMLButtonElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLButtonElement> | null | undefined;
414
- } & {
408
+ } & react.ClassAttributes<HTMLButtonElement> & react.ButtonHTMLAttributes<HTMLButtonElement> & {
415
409
  href?: never;
416
410
  type?: "button" | "reset" | "submit";
417
411
  } & {
@@ -1144,7 +1138,7 @@ type ClickRegionProps = {
1144
1138
  /**
1145
1139
  * The ref to the button or link that should be clicked when the ClickRegion is clicked.
1146
1140
  */
1147
- targetRef: MutableRefObject<HTMLAnchorElement | HTMLButtonElement | null>;
1141
+ targetRef: RefObject<HTMLAnchorElement | HTMLButtonElement | null>;
1148
1142
  };
1149
1143
  /**
1150
1144
  * This allows larger elements to be interactive links or buttons while maintaining acessibility.
@@ -1334,6 +1328,7 @@ declare const iconMap: {
1334
1328
  'private-chat': (props: react.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
1335
1329
  'private-user-sessions': (props: react.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
1336
1330
  project: (props: react.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
1331
+ 'project-open': (props: react.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
1337
1332
  properties: (props: react.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
1338
1333
  'question-mark': (props: react.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
1339
1334
  react: (props: react.SVGProps<SVGSVGElement>) => react_jsx_runtime.JSX.Element;
@@ -1674,7 +1669,7 @@ type ContextMenuProps = {
1674
1669
  } | {
1675
1670
  position?: never;
1676
1671
  side?: never;
1677
- triggerRef: RefObject<HTMLElement>;
1672
+ triggerRef: RefObject<HTMLElement | null>;
1678
1673
  });
1679
1674
  /**
1680
1675
  * The ContextMenu is an extended implementation of the [Menu]() component that allows for right-click context menus.
@@ -1723,7 +1718,7 @@ declare const DataCard: {
1723
1718
  displayName: string;
1724
1719
  };
1725
1720
 
1726
- type DataCardsProps = ComponentPropsWithoutRef<'dl'> & {
1721
+ type DataCardsProps = ComponentPropsWithoutRef<'div'> & {
1727
1722
  /**
1728
1723
  * Should be at least one `DataCard` component
1729
1724
  */
@@ -2865,9 +2860,7 @@ type MenuItemButtonProps = ButtonProps & {
2865
2860
  unstyled?: never;
2866
2861
  };
2867
2862
 
2868
- declare const MenuItem: react.ForwardRefExoticComponent<(Omit<DropdownMenuItemProps & BaseButtonProps & Omit<react.DetailedHTMLProps<react.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref"> & {
2869
- ref?: ((instance: HTMLAnchorElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLAnchorElement> | null | undefined;
2870
- } & {
2863
+ declare const MenuItem: react.ForwardRefExoticComponent<(Omit<DropdownMenuItemProps & BaseButtonProps & react.ClassAttributes<HTMLAnchorElement> & react.AnchorHTMLAttributes<HTMLAnchorElement> & {
2871
2864
  beforeAction?: (() => Promise<void>) | (() => void);
2872
2865
  children: react.ReactNode;
2873
2866
  colorScheme?: ColorSchemeTypes;
@@ -2908,9 +2901,7 @@ declare const MenuItem: react.ForwardRefExoticComponent<(Omit<DropdownMenuItemPr
2908
2901
  * Treats the menu item as a link when provided
2909
2902
  */
2910
2903
  href?: MenuItemButtonProps["href"];
2911
- }, "ref"> | Omit<DropdownMenuItemProps & BaseButtonProps & Omit<react.DetailedHTMLProps<react.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref"> & {
2912
- ref?: ((instance: HTMLAnchorElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLAnchorElement> | null | undefined;
2913
- } & {
2904
+ }, "ref"> | Omit<DropdownMenuItemProps & BaseButtonProps & react.ClassAttributes<HTMLAnchorElement> & react.AnchorHTMLAttributes<HTMLAnchorElement> & {
2914
2905
  beforeAction?: (() => Promise<void>) | (() => void);
2915
2906
  children: react.ReactNode;
2916
2907
  colorScheme?: ColorSchemeTypes;
@@ -2919,9 +2910,7 @@ declare const MenuItem: react.ForwardRefExoticComponent<(Omit<DropdownMenuItemPr
2919
2910
  rightIcon?: react.ReactNode | undefined;
2920
2911
  type?: LinkTypes | undefined;
2921
2912
  underline?: "always" | "hover" | "none";
2922
- } & Omit<react.DetailedHTMLProps<react.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & {
2923
- ref?: ((instance: HTMLButtonElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLButtonElement> | null | undefined;
2924
- } & {
2913
+ } & react.ClassAttributes<HTMLButtonElement> & react.ButtonHTMLAttributes<HTMLButtonElement> & {
2925
2914
  href?: never;
2926
2915
  type?: "button" | "reset" | "submit";
2927
2916
  } & {
@@ -2947,9 +2936,7 @@ declare const MenuItem: react.ForwardRefExoticComponent<(Omit<DropdownMenuItemPr
2947
2936
  * Treats the menu item as a link when provided
2948
2937
  */
2949
2938
  href?: MenuItemButtonProps["href"];
2950
- }, "ref"> | Omit<DropdownMenuItemProps & BaseButtonProps & Omit<react.DetailedHTMLProps<react.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & {
2951
- ref?: ((instance: HTMLButtonElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLButtonElement> | null | undefined;
2952
- } & {
2939
+ }, "ref"> | Omit<DropdownMenuItemProps & BaseButtonProps & react.ClassAttributes<HTMLButtonElement> & react.ButtonHTMLAttributes<HTMLButtonElement> & {
2953
2940
  href?: never;
2954
2941
  type?: "button" | "reset" | "submit";
2955
2942
  children: react.ReactNode;
@@ -3106,7 +3093,7 @@ type ModalProps = ComponentPropsWithoutRef<'div'> & {
3106
3093
  /**
3107
3094
  * Ref to the element that should receive focus when the modal opens
3108
3095
  */
3109
- initialFocusRef?: RefObject<HTMLElement>;
3096
+ initialFocusRef?: RefObject<HTMLElement | null>;
3110
3097
  /**
3111
3098
  * Determines if the modal is currently open
3112
3099
  */
@@ -3154,7 +3141,7 @@ declare const Modal: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProp
3154
3141
  /**
3155
3142
  * Ref to the element that should receive focus when the modal opens
3156
3143
  */
3157
- initialFocusRef?: RefObject<HTMLElement>;
3144
+ initialFocusRef?: RefObject<HTMLElement | null>;
3158
3145
  /**
3159
3146
  * Determines if the modal is currently open
3160
3147
  */
@@ -4373,7 +4360,8 @@ type CustomizableThemeWrapperProps = ComponentPropsWithoutRef<'div'> & {
4373
4360
  overrides: Partial<Record<CustomizableTokens, number | string>>;
4374
4361
  };
4375
4362
  /**
4376
- * Component description goes here
4363
+ * Used for overriding the default theme tokens with custom values.
4364
+ * This should only be used when the ui systems team has been consulted first.
4377
4365
  */
4378
4366
  declare const CustomizableThemeWrapper: {
4379
4367
  ({ children, overrides, ...props }: CustomizableThemeWrapperProps): JSX.Element;