@newtonschool/grauity 3.2.0-beta.1 → 3.2.1-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/dist/common/types.d.ts +2 -2
  2. package/dist/index.d.ts +101 -25
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/main.cjs +1 -1
  5. package/dist/main.cjs.map +1 -1
  6. package/dist/module.mjs +1 -1
  7. package/dist/module.mjs.map +1 -1
  8. package/dist/ui/elements/Accordion/types.d.ts +3 -3
  9. package/dist/ui/elements/Alert/constants.d.ts +0 -98
  10. package/dist/ui/elements/Alert/constants.d.ts.map +1 -1
  11. package/dist/ui/elements/AlertBanner/AlertBanner.d.ts.map +1 -1
  12. package/dist/ui/elements/AlertBanner/types.d.ts +1 -1
  13. package/dist/ui/elements/Calendar/CalendarEvent/CalendarEvent.styles.d.ts.map +1 -1
  14. package/dist/ui/elements/Calendar/CalendarEvent/types.d.ts +4 -4
  15. package/dist/ui/elements/Calendar/MonthlyCalendar/MonthlyCalendar.d.ts.map +1 -1
  16. package/dist/ui/elements/Calendar/MonthlyCalendarEvent/types.d.ts +3 -3
  17. package/dist/ui/elements/Calendar/WeeklyCalendar/WeeklyCalendar.styles.d.ts.map +1 -1
  18. package/dist/ui/elements/Drawer/Drawer.d.ts +5 -0
  19. package/dist/ui/elements/Drawer/Drawer.d.ts.map +1 -0
  20. package/dist/ui/elements/Drawer/Drawer.styles.d.ts +5 -0
  21. package/dist/ui/elements/Drawer/Drawer.styles.d.ts.map +1 -0
  22. package/dist/ui/elements/Drawer/constants.d.ts +2 -0
  23. package/dist/ui/elements/Drawer/constants.d.ts.map +1 -0
  24. package/dist/ui/elements/Drawer/index.d.ts +3 -0
  25. package/dist/ui/elements/Drawer/index.d.ts.map +1 -0
  26. package/dist/ui/elements/Drawer/types.d.ts +70 -0
  27. package/dist/ui/elements/Drawer/types.d.ts.map +1 -0
  28. package/dist/ui/elements/DropdownMenu/DropdownMenu.d.ts.map +1 -1
  29. package/dist/ui/elements/DropdownMenu/types.d.ts +3 -0
  30. package/dist/ui/elements/DropdownMenu/types.d.ts.map +1 -1
  31. package/dist/ui/elements/DropdownMenu/utils.d.ts +9 -0
  32. package/dist/ui/elements/DropdownMenu/utils.d.ts.map +1 -1
  33. package/dist/ui/elements/Form/TextField/TextField.d.ts.map +1 -1
  34. package/dist/ui/elements/Form/TextField/types.d.ts +8 -0
  35. package/dist/ui/elements/Form/TextField/types.d.ts.map +1 -1
  36. package/dist/ui/elements/Form/useForm/FormField.d.ts.map +1 -1
  37. package/dist/ui/elements/Form/useForm/types.d.ts +8 -2
  38. package/dist/ui/elements/Form/useForm/types.d.ts.map +1 -1
  39. package/dist/ui/elements/Modal/types.d.ts +1 -1
  40. package/dist/ui/elements/MultiSelectDropdown/MultiSelectDropdown.styles.d.ts.map +1 -1
  41. package/dist/ui/elements/Overlay/types.d.ts +1 -1
  42. package/dist/ui/elements/Placeholder/types.d.ts +1 -1
  43. package/dist/ui/elements/SelectDropdown/SelectDropdown.styles.d.ts.map +1 -1
  44. package/dist/ui/elements/Tab/Tab.d.ts.map +1 -1
  45. package/dist/ui/elements/Tab/Tab.styles.d.ts.map +1 -1
  46. package/dist/ui/elements/Tab/constants.d.ts +1 -1
  47. package/dist/ui/elements/Tab/constants.d.ts.map +1 -1
  48. package/dist/ui/elements/Tab/types.d.ts +10 -5
  49. package/dist/ui/elements/Tab/types.d.ts.map +1 -1
  50. package/dist/ui/elements/TabList/TabList.d.ts.map +1 -1
  51. package/dist/ui/elements/TabList/constants.d.ts +1 -1
  52. package/dist/ui/elements/TabList/constants.d.ts.map +1 -1
  53. package/dist/ui/elements/TabList/index.styles.d.ts.map +1 -1
  54. package/dist/ui/elements/TabList/types.d.ts +2 -2
  55. package/dist/ui/elements/Table/Table.styles.d.ts.map +1 -1
  56. package/dist/ui/elements/Tabs/Tabs.styles.d.ts.map +1 -1
  57. package/dist/ui/elements/Tooltip/types.d.ts +4 -4
  58. package/dist/ui/index.d.ts +1 -0
  59. package/dist/ui/index.d.ts.map +1 -1
  60. package/package.json +1 -1
@@ -11,10 +11,10 @@ export interface StyledDivProps extends React.HTMLAttributes<HTMLDivElement> {
11
11
  'data-testid'?: string;
12
12
  }
13
13
  /**
14
- * Interface representing the properties for a styled div component.
14
+ * Interface representing the properties for a styled span component.
15
15
  *
16
16
  * @extends React.HTMLAttributes<HTMLSpanElement>
17
- * @property {React.Ref<HTMLSpanElement>} [ref] - Optional ref for the div element.
17
+ * @property {React.Ref<HTMLSpanElement>} [ref] - Optional ref for the span element.
18
18
  */
19
19
  export interface StyledSpanProps extends React.HTMLAttributes<HTMLSpanElement> {
20
20
  ref?: React.Ref<HTMLSpanElement>;
package/dist/index.d.ts CHANGED
@@ -3162,7 +3162,7 @@ export interface AlertBannerProps {
3162
3162
  /**
3163
3163
  * Alert banner padding
3164
3164
  *
3165
- * Default: `'var(--spacing-8px, 8px)'`
3165
+ * Default: `'var(--spacing-4px, 4px) var(--spacing-8px, 8px)'` if action buttons/close button are present else `'var(--spacing-8px, 8px)'`
3166
3166
  * */
3167
3167
  padding?: string;
3168
3168
  /**
@@ -3571,7 +3571,7 @@ export interface OverlayProps {
3571
3571
  shouldBlurOverlay?: boolean;
3572
3572
  /**
3573
3573
  * Color of the overlay
3574
- * @default 'var(--alpha-overlay, rgba(22, 25, 29, 0.8))'
3574
+ * @default 'var(--bg-subtle-alpha-overlay, #16191dcc)'
3575
3575
  */
3576
3576
  overlayColor?: string;
3577
3577
  /**
@@ -3793,7 +3793,7 @@ export interface ModalProps {
3793
3793
  */
3794
3794
  overflow?: string;
3795
3795
  /**
3796
- * Border for the modal. By default, it is `1px solid var(--border, #e1e5ea)`
3796
+ * Border for the modal. By default, it is `1px solid var(--border-subtle-primary-default, #e1e5ea)`
3797
3797
  * */
3798
3798
  border?: string;
3799
3799
  /**
@@ -4508,17 +4508,17 @@ export interface AccordionProps {
4508
4508
  suffix?: React.ReactNode;
4509
4509
  /**
4510
4510
  * Background color of the accordion header.
4511
- * @default var(--bg-secondary, #F6F7F9)
4511
+ * @default var(--bg-subtle-secondary-default, #f6f7f9)
4512
4512
  */
4513
4513
  headerBackgroundColor?: string;
4514
4514
  /**
4515
4515
  * Background color of the accordion content.
4516
- * @default var(--bg-secondary, #F6F7F9)
4516
+ * @default var(--bg-subtle-secondary-default, #f6f7f9)
4517
4517
  */
4518
4518
  contentBackgroundColor?: string;
4519
4519
  /**
4520
4520
  * Color of the accordion toggle icon.
4521
- * @default var(--text-primary, #16191D)
4521
+ * @default var(--text-emphasis-primary-default, #16191d)
4522
4522
  */
4523
4523
  iconColor?: string;
4524
4524
  /**
@@ -4641,22 +4641,22 @@ export interface CalendarEventProps {
4641
4641
  minDurationToDisplayTime?: number;
4642
4642
  /**
4643
4643
  * Text color of the event.
4644
- * @default 'var(--text-action2)'
4644
+ * @default 'var(--text-emphasis-invert-primary-default, #ffffff)'
4645
4645
  */
4646
4646
  textColor?: string;
4647
4647
  /**
4648
4648
  * Background color of the event.
4649
- * @default 'var(--bg-action-brand)'
4649
+ * @default 'var(--bg-emphasis-brand-default, #0673f9)'
4650
4650
  */
4651
4651
  backgroundColor?: string;
4652
4652
  /**
4653
4653
  * Border color of the event.
4654
- * @default 'var(--border)'
4654
+ * @default 'var(--border-subtle-primary-default, #e1e5ea)'
4655
4655
  */
4656
4656
  borderColor?: string;
4657
4657
  /**
4658
4658
  * Text color of the chip content.
4659
- * @default 'var(--text-action2)'
4659
+ * @default 'var(--text-emphasis-invert-primary-default, #ffffff)'
4660
4660
  */
4661
4661
  chipTextColor?: string;
4662
4662
  /**
@@ -4669,7 +4669,7 @@ export const NSCalendarEvent: React.ForwardRefExoticComponent<CalendarEventProps
4669
4669
  export interface MonthlyCalendarEventProps extends StyledDivProps {
4670
4670
  /**
4671
4671
  * The background color of the calendar event.
4672
- * @default 'var(--bg-action-brand)'
4672
+ * @default 'var(--bg-emphasis-brand-default, #0673f9)'
4673
4673
  */
4674
4674
  backgroundColor?: string;
4675
4675
  /**
@@ -4697,12 +4697,12 @@ export interface MonthlyCalendarEventProps extends StyledDivProps {
4697
4697
  eventTitle: string;
4698
4698
  /**
4699
4699
  * The color of the event time text.
4700
- * @default 'var(--text-action2)'
4700
+ * @default 'var(--text-emphasis-invert-primary-default, #ffffff)'
4701
4701
  */
4702
4702
  eventTimeColor?: string;
4703
4703
  /**
4704
4704
  * The color of the event title text.
4705
- * @default 'var(--text-action2)'
4705
+ * @default 'var(--text-emphasis-invert-primary-default, #ffffff)'
4706
4706
  */
4707
4707
  eventTitleColor?: string;
4708
4708
  /**
@@ -4820,7 +4820,7 @@ export interface PlaceholderProps {
4820
4820
  margin?: string;
4821
4821
  /**
4822
4822
  * Background color of the placeholder.
4823
- * @default 'var(--bg-tertiary, #EDEFF3)'
4823
+ * @default 'var(--bg-subtle-tertiary-default, #edeff3)'
4824
4824
  */
4825
4825
  backgroundColor?: string;
4826
4826
  /**
@@ -5156,12 +5156,12 @@ export interface TooltipProps {
5156
5156
  isOpen?: boolean | null;
5157
5157
  /**
5158
5158
  * The text color of the tooltip
5159
- * @default 'var(--text-emphasis-invert-primary-default)'
5159
+ * @default 'var(--text-emphasis-invert-primary-default, #ffffff)'
5160
5160
  * */
5161
5161
  color?: string;
5162
5162
  /**
5163
5163
  * The background color of the tooltip
5164
- * @default 'var(--bg-subtle-invert-primary-default)'
5164
+ * @default 'var(--bg-subtle-invert-primary-default, #0b0c0e)'
5165
5165
  * */
5166
5166
  backgroundColor?: string;
5167
5167
  /**
@@ -5458,6 +5458,10 @@ export interface TextFieldProps {
5458
5458
  * The function to call when the input field is blurred (unfocused/clicked away).
5459
5459
  */
5460
5460
  onBlur?: (event: React.FocusEvent<HTMLInputElement>) => void;
5461
+ /**
5462
+ * The function to call when a key is pressed while the input field is focused.
5463
+ */
5464
+ onKeyDown?: (event: React.KeyboardEvent<HTMLInputElement>) => void;
5461
5465
  /**
5462
5466
  * The error message to display when the input field is invalid.
5463
5467
  */
@@ -5493,6 +5497,10 @@ export interface TextFieldProps {
5493
5497
  * The color of the input field.
5494
5498
  */
5495
5499
  color?: TextFieldColors;
5500
+ /**
5501
+ * className to be passed to the TextField container.
5502
+ */
5503
+ className?: string;
5496
5504
  }
5497
5505
  export const NSTextField: React.ForwardRefExoticComponent<TextFieldProps & React.RefAttributes<HTMLInputElement>>;
5498
5506
  type VARIANTS = `${VARIANTS_SIZES}`;
@@ -5896,9 +5904,11 @@ type OptionValue = string | number;
5896
5904
  export type NSDropdownMenuBaseItemSubHeaderProps = {
5897
5905
  type: NSDropdownMenuBaseItemType.SUB_HEADER;
5898
5906
  title: string;
5907
+ scrollToOnOpen?: boolean;
5899
5908
  };
5900
5909
  export type NSDropdownMenuBaseItemDividerProps = {
5901
5910
  type: NSDropdownMenuBaseItemType.DIVIDER;
5911
+ scrollToOnOpen?: boolean;
5902
5912
  };
5903
5913
  export type NSDropdownMenuBaseItemOptionProps = {
5904
5914
  type: NSDropdownMenuBaseItemType.OPTION;
@@ -5908,6 +5918,7 @@ export type NSDropdownMenuBaseItemOptionProps = {
5908
5918
  leftIcon?: grauityIconName;
5909
5919
  rightIcon?: grauityIconName;
5910
5920
  disabled?: boolean;
5921
+ scrollToOnOpen?: boolean;
5911
5922
  };
5912
5923
  export type NSDropdownMenuBaseItemProps = NSDropdownMenuBaseItemSubHeaderProps | NSDropdownMenuBaseItemDividerProps | NSDropdownMenuBaseItemOptionProps;
5913
5924
  export interface NSDropdownMenuProps {
@@ -6403,7 +6414,8 @@ export enum NSFormFieldType {
6403
6414
  DROPDOWN_MENU = "dropdown-menu",
6404
6415
  CHECKBOX_GROUP = "checkbox-group",
6405
6416
  RADIOBUTTON_GROUP = "radio-button-group",
6406
- CUSTOM = "custom"
6417
+ CUSTOM = "custom",
6418
+ COMBOBOX = "combobox"
6407
6419
  }
6408
6420
  export interface NSConditionalProp {
6409
6421
  prop: string;
@@ -6426,6 +6438,10 @@ export interface NSFormFieldDropdownProps extends NSFormFieldBaseProps {
6426
6438
  type: NSFormFieldType.DROPDOWN;
6427
6439
  rendererProps: DropdownProps;
6428
6440
  }
6441
+ interface FormFieldComboboxProps extends NSFormFieldBaseProps {
6442
+ type: NSFormFieldType.COMBOBOX;
6443
+ rendererProps: ComboboxProps;
6444
+ }
6429
6445
  export interface NSFormFieldDropdownMenuProps extends NSFormFieldBaseProps {
6430
6446
  type: NSFormFieldType.DROPDOWN_MENU;
6431
6447
  rendererProps: DropdownProps;
@@ -6442,7 +6458,7 @@ export interface NSFormFieldCustomProps extends NSFormFieldBaseProps {
6442
6458
  type: NSFormFieldType.CUSTOM;
6443
6459
  rendererProps: any;
6444
6460
  }
6445
- export type NSFormField = NSFormFieldTextFieldProps | NSFormFieldDropdownProps | NSFormFieldDropdownMenuProps | NSFormFieldCheckboxGroupProps | FormFieldRadioButtonGroupProps | NSFormFieldCustomProps;
6461
+ export type NSFormField = NSFormFieldTextFieldProps | NSFormFieldDropdownProps | FormFieldComboboxProps | NSFormFieldDropdownMenuProps | NSFormFieldCheckboxGroupProps | FormFieldRadioButtonGroupProps | NSFormFieldCustomProps;
6446
6462
  export interface NSFormFields {
6447
6463
  [key: NSFieldName]: NSFormField;
6448
6464
  }
@@ -6622,7 +6638,7 @@ export enum TAB_ICON_POSITIONS_ENUM {
6622
6638
  BOTTOM = "bottom"
6623
6639
  }
6624
6640
  export enum TAB_VARIANT_ENUM {
6625
- BORDER = "border",
6641
+ BORDERED = "bordered",
6626
6642
  ROUNDED = "rounded"
6627
6643
  }
6628
6644
  type TabIconPosition = `${TAB_ICON_POSITIONS_ENUM}`;
@@ -6679,8 +6695,8 @@ export interface TabProps {
6679
6695
  */
6680
6696
  iconPosition?: TabIconPosition;
6681
6697
  /**
6682
- * Variant of the tab, can be 'rounded', 'default', or 'bordered'.
6683
- * @default 'rounded'
6698
+ * Variant of the tab, can be 'rounded', or 'bordered'.
6699
+ * @default 'bordered'
6684
6700
  */
6685
6701
  variant?: TabVariant;
6686
6702
  /**
@@ -6700,13 +6716,18 @@ export interface TabProps {
6700
6716
  onClick?: () => void;
6701
6717
  /**
6702
6718
  * Tab index for keyboard navigation.
6703
- * @default '-1'
6719
+ * @default 0
6704
6720
  */
6705
6721
  tabIndex?: number;
6722
+ /**
6723
+ * ID of the tabpanel associated with the tab.
6724
+ * @default ''
6725
+ */
6726
+ ariaControls?: string;
6706
6727
  }
6707
6728
  export function NSTab(props: TabProps): JSX.Element;
6708
6729
  export enum TAB_LIST_VARIANT_ENUM {
6709
- BORDER = "border",
6730
+ BORDERED = "bordered",
6710
6731
  ROUNDED = "rounded"
6711
6732
  }
6712
6733
  export interface TabListProps {
@@ -6724,8 +6745,8 @@ export interface TabListProps {
6724
6745
  */
6725
6746
  onChange?: (index: number) => void;
6726
6747
  /**
6727
- * Variant of the TabList, can be 'border' or 'rounded'.
6728
- * @default 'default'
6748
+ * Variant of the TabList, can be 'bordered' or 'rounded'.
6749
+ * @default 'bordered'
6729
6750
  */
6730
6751
  variant?: TabVariant;
6731
6752
  /**
@@ -6744,5 +6765,60 @@ export interface TabListProps {
6744
6765
  size?: TabSize;
6745
6766
  }
6746
6767
  export function NSTabList(props: TabListProps): JSX.Element;
6768
+ export interface DrawerProps {
6769
+ /**
6770
+ * The content to be displayed inside the Drawer.
6771
+ */
6772
+ children?: React.ReactNode;
6773
+ /**
6774
+ * Determines whether the Drawer is open or closed.
6775
+ * @default false
6776
+ */
6777
+ isOpen?: boolean;
6778
+ /**
6779
+ * Callback function to be called when the Drawer is requested to be closed.
6780
+ * @default () => {}
6781
+ */
6782
+ onClose?: () => void;
6783
+ /**
6784
+ * If true, the Drawer will take up the full screen.
6785
+ * @default false
6786
+ */
6787
+ fullScreen?: boolean;
6788
+ /**
6789
+ * If true, the Drawer will close when the backdrop is clicked.
6790
+ * @default true
6791
+ */
6792
+ closeOnBackdropClick?: boolean;
6793
+ /**
6794
+ * The width of the Drawer.
6795
+ * @default '30%'
6796
+ */
6797
+ width?: string;
6798
+ /**
6799
+ * The side from which the Drawer opens.
6800
+ * @default 'left'
6801
+ */
6802
+ position?: 'left' | 'right';
6803
+ /**
6804
+ * Additional class name to be passed to the Drawer.
6805
+ */
6806
+ className?: string;
6807
+ /**
6808
+ * Should focus on the first element in the drawer
6809
+ * @default true
6810
+ */
6811
+ shouldFocusOnFirstElement?: boolean;
6812
+ /**
6813
+ * Flag to determine if the background scroll should be disabled.
6814
+ * @default true
6815
+ */
6816
+ shouldDisableScroll?: boolean;
6817
+ /**
6818
+ * Custom styles to override drawer styling
6819
+ */
6820
+ styles?: React.CSSProperties;
6821
+ }
6822
+ export const NSDrawer: React.ForwardRefExoticComponent<DrawerProps & React.RefAttributes<HTMLDivElement>>;
6747
6823
 
6748
6824
  //# sourceMappingURL=index.d.ts.map