@newtonschool/grauity 2.0.3 → 2.1.0-beta.2

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import React, { NamedExoticComponent, ReactNode, RefAttributes, Component, HTMLA
 import { Substitute, IStyledComponentBase } from "styled-components/dist/types";
 import { HTMLMotionProps, ForwardRefComponent } from "framer-motion";
 import { FastOmit } from "styled-components";
+import { Schema } from "yup";
 export const ICON_TAGS: {
     "exclamation-circle-filled": string[];
     "exclamation-circle": string[];
@@ -19,8 +20,6 @@ export const ICON_TAGS: {
     project: string[];
     "terminal-filled": string[];
     terminal: string[];
-    "nst-filled": string[];
-    nst: string[];
     "desktop-filled": string[];
     desktop: string[];
     "gamepad-filled": string[];
@@ -103,8 +102,6 @@ export const ICON_TAGS: {
     "lock-open-filled": string[];
     "lock-open": string[];
     lock: string[];
-    "magic-orb-filled": string[];
-    "magic-orb": string[];
     "message-filled": string[];
     "message-info-filled": string[];
     "message-info": string[];
@@ -445,7 +442,6 @@ export const ICON_TAGS: {
 export const TAG_ICONS: {
     Alert: string[];
     Code: string[];
-    College: string[];
     Device: string[];
     Docs: string[];
     Finance: string[];
@@ -457,7 +453,7 @@ export const TAG_ICONS: {
     Time: string[];
     User: string[];
 };
-type grauityIconName = 'exclamation-circle-filled' | 'exclamation-circle' | 'exclamation-triangle-filled' | 'exclamation-triangle' | 'info-circle-filled' | 'info-circle' | 'question-circle-filled' | 'question-circle' | 'code-alt-filled' | 'code-alt' | 'code-filled' | 'code' | 'project-filled' | 'project' | 'terminal-filled' | 'terminal' | 'nst-filled' | 'nst' | 'desktop-filled' | 'desktop' | 'gamepad-filled' | 'gamepad' | 'lamp-filled' | 'lamp' | 'laptop-filled' | 'laptop' | 'mobile-filled' | 'mobile' | 'archive-filled' | 'archive' | 'bookmark-filled' | 'bookmark' | 'file-alt-filled' | 'file-alt' | 'file-filled' | 'file-lightning-filled' | 'file-lightning' | 'file' | 'folder-filled' | 'folder-open-filled' | 'folder-open' | 'folder' | 'label-filled' | 'label' | 'note-filled' | 'note' | 'pen-filled' | 'pen' | 'pin-filled' | 'pin' | 'currency-rupee-filled' | 'currency-rupee' | 'headphone-filled' | 'headphone-mic-filled' | 'headphone-mic' | 'headphone' | 'mic-filled' | 'mic' | 'micmute-filled' | 'micmute' | 'pause-circle-filled' | 'pause-circle' | 'pause-filled' | 'pause' | 'play-circle-filled' | 'play-circle' | 'play-filled' | 'play-rectangle-filled' | 'play-rectangle' | 'play' | 'video-filled' | 'video-off-filled' | 'video-off' | 'video' | 'volume-maximum-filled' | 'volume-maximum' | 'volume-minimum-filled' | 'volume-minimum' | 'volume-mute-filled' | 'volume-mute' | 'comment-filled' | 'comment' | 'connector-filled' | 'connector' | 'doubt-alt2-filled' | 'doubt-alt2' | 'doubt-filled' | 'doubt-message-filled' | 'doubt-message' | 'doubt' | 'hearing-filled' | 'hearing' | 'heart-filled' | 'heart' | 'hearthands-filled' | 'hearthands' | 'lock-filled' | 'lock-open-filled' | 'lock-open' | 'lock' | 'magic-orb-filled' | 'magic-orb' | 'message-filled' | 'message-info-filled' | 'message-info' | 'message' | 'milestone-filled' | 'milestone' | 'scholar-hat-filled' | 'scholar-hat' | 'smiley-bad-filled' | 'smiley-bad' | 'smiley-filled' | 'smiley-happy-filled' | 'smiley-happy' | 'smiley-neutral-filled' | 'smiley-neutral' | 'smiley-sad-filled' | 'smiley-sad' | 'smiley-very-bad-filled' | 'smiley-very-bad' | 'smiley-very-happy-filled' | 'smiley-very-happy' | 'smiley' | 'spark-filled' | 'spark' | 'sparkle-filled' | 'sparkle' | 'target-filled' | 'target' | 'check-badge-filled' | 'check-badge' | 'crown-filled' | 'crown' | 'flag-filled' | 'flag' | 'gift-filled' | 'gift' | 'leaderboard-filled' | 'leaderboard' | 'medal-filled' | 'medal' | 'star-filled' | 'star' | 'trophy-filled' | 'trophy' | 'codechef' | 'codeforces' | 'facebook' | 'github' | 'google' | 'hackerearth' | 'hackerrank' | 'instagram' | 'leetcode' | 'linkedin' | 'twitter' | 'whatsapp' | 'x' | 'youtube' | 'arrow-double-filled' | 'arrow-double' | 'arrow-down-filled' | 'arrow-down-left-filled' | 'arrow-down-left' | 'arrow-down-right-filled' | 'arrow-down-right' | 'arrow-down' | 'arrow-left-filled' | 'arrow-left' | 'arrow-right-filled' | 'arrow-right' | 'arrow-up-filled' | 'arrow-up-left-filled' | 'arrow-up-left' | 'arrow-up-right-filled' | 'arrow-up-right' | 'arrow-up' | 'ban-filled' | 'ban' | 'bin-filled' | 'bin' | 'book-alt-filled' | 'book-alt' | 'book-alt2-filled' | 'book-alt2' | 'book-alt3-filled' | 'book-alt3' | 'book-filled' | 'book' | 'briefcase-alt2-filled' | 'briefcase-alt2' | 'briefcase-filled' | 'briefcase' | 'broadcast-filled' | 'broadcast' | 'bug-filled' | 'bug' | 'bulb-filled' | 'bulb' | 'call-end-filled' | 'call-end' | 'call-start-filled' | 'call-start' | 'camera-filled' | 'camera' | 'caret-double-filled' | 'caret-double' | 'caret-down-filled' | 'caret-down' | 'caret-left-filled' | 'caret-left' | 'caret-right-filled' | 'caret-right' | 'caret-up-filled' | 'caret-up' | 'check-circle-filled' | 'check-circle' | 'check-filled' | 'check-square-filled' | 'check-square' | 'check' | 'chevron-down-double-filled' | 'chevron-down-double' | 'chevron-down-filled' | 'chevron-down' | 'chevron-left-double-filled' | 'chevron-left-double' | 'chevron-left-filled' | 'chevron-left' | 'chevron-right-double-filled' | 'chevron-right-double' | 'chevron-right-filled' | 'chevron-right' | 'chevron-up-double-filled' | 'chevron-up-double' | 'chevron-up-filled' | 'chevron-up' | 'circle-filled' | 'circle' | 'clock-alarm-filled' | 'clock-alarm' | 'close-circle-filled' | 'close-circle' | 'close-filled' | 'close-square-filled' | 'close-square' | 'close' | 'compass-filled' | 'compass' | 'database-filled' | 'database' | 'diamond-filled' | 'diamond' | 'double-check-filled' | 'double-check' | 'download-filled' | 'download' | 'eda-filled' | 'eda' | 'email-alt-filled' | 'email-alt' | 'email-filled' | 'email' | 'filter-filled' | 'filter' | 'floppy-filled' | 'floppy' | 'forward-filled' | 'forward' | 'gear-filled' | 'gear' | 'git-commit-filled' | 'git-commit' | 'globe-filled' | 'globe' | 'grip-hortizontal-filled' | 'grip-hortizontal' | 'grip-vertical-filled' | 'grip-vertical' | 'growth-down-filled' | 'growth-down' | 'growth-up-filled' | 'growth-up' | 'help-filled' | 'help' | 'hold-filled' | 'hold' | 'home-filled' | 'home' | 'hourglass-filled' | 'hourglass' | 'kebab-horizontal-filled' | 'kebab-horizontal' | 'kebab-vertical-filled' | 'kebab-vertical' | 'link-filled' | 'link' | 'list-checked-filled' | 'list-checked' | 'list-filled' | 'list' | 'load-filled' | 'load' | 'loudspeaker-filled' | 'loudspeaker' | 'machine-learning-filled' | 'machine-learning' | 'map-pin-alt1-filled' | 'map-pin-alt1' | 'map-pin-alt2-filled' | 'map-pin-alt2' | 'map-pin-filled' | 'map-pin' | 'maximize-filled' | 'maximize' | 'menu-alt2-filled' | 'menu-alt2' | 'menu-filled' | 'menu-grid-filled' | 'menu-grid' | 'menu' | 'microchip-filled' | 'microchip' | 'minimize-filled' | 'minimize' | 'minus-circle-filled' | 'minus-circle' | 'minus-square-filled' | 'minus-square' | 'moon-filled' | 'moon' | 'new-tab-filled' | 'new-tab' | 'paper-clip-filled' | 'paper-clip' | 'plus-circle-filled' | 'plus-circle' | 'plus-filled' | 'plus-square-filled' | 'plus-square' | 'plus' | 'power-bi-filled' | 'power-bi' | 'printer-filled' | 'printer' | 'progress-half-filled' | 'progress-half' | 'progress-quarter-filled' | 'progress-quarter' | 'progress-zero-filled' | 'progress-zero' | 'python-filled' | 'python' | 'quiz-filled' | 'quiz' | 'refresh-filled' | 'refresh' | 'remove-filled' | 'remove' | 'reply-filled' | 'reply' | 'retail-filled' | 'retail' | 'screenshare-start-filled' | 'screenshare-start' | 'screenshare-stop-filled' | 'screenshare-stop' | 'search-filled' | 'search' | 'share-filled' | 'share' | 'shield-alert-filled' | 'shield-alert' | 'shield-check-filled' | 'shield-check' | 'shield-filled' | 'shield-lock-filled' | 'shield-lock' | 'shield-x-filled' | 'shield-x' | 'shield' | 'shop-filled' | 'shop' | 'sidebar-left-filled' | 'sidebar-left' | 'sidebar-right-filled' | 'sidebar-right' | 'signin-filled' | 'signin' | 'signout-filled' | 'signout' | 'slider-filled' | 'slider' | 'square-filled' | 'square' | 'sticky-note-filled' | 'sticky-note' | 'sun-filled' | 'sun' | 'thumbs-down-filled' | 'thumbs-down' | 'thumbs-up-filled' | 'thumbs-up' | 'thunder-filled' | 'thunder' | 'truck-filled' | 'truck' | 'upload-filled' | 'upload' | 'wrench-filled' | 'wrench' | 'bell-filled' | 'bell' | 'calender-check-filled' | 'calender-check' | 'calender-filled' | 'calender-plus-filled' | 'calender-plus' | 'calender' | 'clock-filled' | 'clock' | 'rewatch-filled' | 'rewatch' | 'stopwatch-filled' | 'stopwatch' | 'bot-filled' | 'bot' | 'person-check-filled' | 'person-check' | 'person-filled' | 'person-plus-filled' | 'person-plus' | 'person' | 'user-speak-filled' | 'user-speak' | 'users-filled' | 'users';
+type grauityIconName = 'exclamation-circle-filled' | 'exclamation-circle' | 'exclamation-triangle-filled' | 'exclamation-triangle' | 'info-circle-filled' | 'info-circle' | 'question-circle-filled' | 'question-circle' | 'code-alt-filled' | 'code-alt' | 'code-filled' | 'code' | 'project-filled' | 'project' | 'terminal-filled' | 'terminal' | 'desktop-filled' | 'desktop' | 'gamepad-filled' | 'gamepad' | 'lamp-filled' | 'lamp' | 'laptop-filled' | 'laptop' | 'mobile-filled' | 'mobile' | 'archive-filled' | 'archive' | 'bookmark-filled' | 'bookmark' | 'file-alt-filled' | 'file-alt' | 'file-filled' | 'file-lightning-filled' | 'file-lightning' | 'file' | 'folder-filled' | 'folder-open-filled' | 'folder-open' | 'folder' | 'label-filled' | 'label' | 'note-filled' | 'note' | 'pen-filled' | 'pen' | 'pin-filled' | 'pin' | 'currency-rupee-filled' | 'currency-rupee' | 'headphone-filled' | 'headphone-mic-filled' | 'headphone-mic' | 'headphone' | 'mic-filled' | 'mic' | 'micmute-filled' | 'micmute' | 'pause-circle-filled' | 'pause-circle' | 'pause-filled' | 'pause' | 'play-circle-filled' | 'play-circle' | 'play-filled' | 'play-rectangle-filled' | 'play-rectangle' | 'play' | 'video-filled' | 'video-off-filled' | 'video-off' | 'video' | 'volume-maximum-filled' | 'volume-maximum' | 'volume-minimum-filled' | 'volume-minimum' | 'volume-mute-filled' | 'volume-mute' | 'comment-filled' | 'comment' | 'connector-filled' | 'connector' | 'doubt-alt2-filled' | 'doubt-alt2' | 'doubt-filled' | 'doubt-message-filled' | 'doubt-message' | 'doubt' | 'hearing-filled' | 'hearing' | 'heart-filled' | 'heart' | 'hearthands-filled' | 'hearthands' | 'lock-filled' | 'lock-open-filled' | 'lock-open' | 'lock' | 'message-filled' | 'message-info-filled' | 'message-info' | 'message' | 'milestone-filled' | 'milestone' | 'scholar-hat-filled' | 'scholar-hat' | 'smiley-bad-filled' | 'smiley-bad' | 'smiley-filled' | 'smiley-happy-filled' | 'smiley-happy' | 'smiley-neutral-filled' | 'smiley-neutral' | 'smiley-sad-filled' | 'smiley-sad' | 'smiley-very-bad-filled' | 'smiley-very-bad' | 'smiley-very-happy-filled' | 'smiley-very-happy' | 'smiley' | 'spark-filled' | 'spark' | 'sparkle-filled' | 'sparkle' | 'target-filled' | 'target' | 'check-badge-filled' | 'check-badge' | 'crown-filled' | 'crown' | 'flag-filled' | 'flag' | 'gift-filled' | 'gift' | 'leaderboard-filled' | 'leaderboard' | 'medal-filled' | 'medal' | 'star-filled' | 'star' | 'trophy-filled' | 'trophy' | 'codechef' | 'codeforces' | 'facebook' | 'github' | 'google' | 'hackerearth' | 'hackerrank' | 'instagram' | 'leetcode' | 'linkedin' | 'twitter' | 'whatsapp' | 'x' | 'youtube' | 'arrow-double-filled' | 'arrow-double' | 'arrow-down-filled' | 'arrow-down-left-filled' | 'arrow-down-left' | 'arrow-down-right-filled' | 'arrow-down-right' | 'arrow-down' | 'arrow-left-filled' | 'arrow-left' | 'arrow-right-filled' | 'arrow-right' | 'arrow-up-filled' | 'arrow-up-left-filled' | 'arrow-up-left' | 'arrow-up-right-filled' | 'arrow-up-right' | 'arrow-up' | 'ban-filled' | 'ban' | 'bin-filled' | 'bin' | 'book-alt-filled' | 'book-alt' | 'book-alt2-filled' | 'book-alt2' | 'book-alt3-filled' | 'book-alt3' | 'book-filled' | 'book' | 'briefcase-alt2-filled' | 'briefcase-alt2' | 'briefcase-filled' | 'briefcase' | 'broadcast-filled' | 'broadcast' | 'bug-filled' | 'bug' | 'bulb-filled' | 'bulb' | 'call-end-filled' | 'call-end' | 'call-start-filled' | 'call-start' | 'camera-filled' | 'camera' | 'caret-double-filled' | 'caret-double' | 'caret-down-filled' | 'caret-down' | 'caret-left-filled' | 'caret-left' | 'caret-right-filled' | 'caret-right' | 'caret-up-filled' | 'caret-up' | 'check-circle-filled' | 'check-circle' | 'check-filled' | 'check-square-filled' | 'check-square' | 'check' | 'chevron-down-double-filled' | 'chevron-down-double' | 'chevron-down-filled' | 'chevron-down' | 'chevron-left-double-filled' | 'chevron-left-double' | 'chevron-left-filled' | 'chevron-left' | 'chevron-right-double-filled' | 'chevron-right-double' | 'chevron-right-filled' | 'chevron-right' | 'chevron-up-double-filled' | 'chevron-up-double' | 'chevron-up-filled' | 'chevron-up' | 'circle-filled' | 'circle' | 'clock-alarm-filled' | 'clock-alarm' | 'close-circle-filled' | 'close-circle' | 'close-filled' | 'close-square-filled' | 'close-square' | 'close' | 'compass-filled' | 'compass' | 'database-filled' | 'database' | 'diamond-filled' | 'diamond' | 'double-check-filled' | 'double-check' | 'download-filled' | 'download' | 'eda-filled' | 'eda' | 'email-alt-filled' | 'email-alt' | 'email-filled' | 'email' | 'filter-filled' | 'filter' | 'floppy-filled' | 'floppy' | 'forward-filled' | 'forward' | 'gear-filled' | 'gear' | 'git-commit-filled' | 'git-commit' | 'globe-filled' | 'globe' | 'grip-hortizontal-filled' | 'grip-hortizontal' | 'grip-vertical-filled' | 'grip-vertical' | 'growth-down-filled' | 'growth-down' | 'growth-up-filled' | 'growth-up' | 'help-filled' | 'help' | 'hold-filled' | 'hold' | 'home-filled' | 'home' | 'hourglass-filled' | 'hourglass' | 'kebab-horizontal-filled' | 'kebab-horizontal' | 'kebab-vertical-filled' | 'kebab-vertical' | 'link-filled' | 'link' | 'list-checked-filled' | 'list-checked' | 'list-filled' | 'list' | 'load-filled' | 'load' | 'loudspeaker-filled' | 'loudspeaker' | 'machine-learning-filled' | 'machine-learning' | 'map-pin-alt1-filled' | 'map-pin-alt1' | 'map-pin-alt2-filled' | 'map-pin-alt2' | 'map-pin-filled' | 'map-pin' | 'maximize-filled' | 'maximize' | 'menu-alt2-filled' | 'menu-alt2' | 'menu-filled' | 'menu-grid-filled' | 'menu-grid' | 'menu' | 'microchip-filled' | 'microchip' | 'minimize-filled' | 'minimize' | 'minus-circle-filled' | 'minus-circle' | 'minus-square-filled' | 'minus-square' | 'moon-filled' | 'moon' | 'new-tab-filled' | 'new-tab' | 'paper-clip-filled' | 'paper-clip' | 'plus-circle-filled' | 'plus-circle' | 'plus-filled' | 'plus-square-filled' | 'plus-square' | 'plus' | 'power-bi-filled' | 'power-bi' | 'printer-filled' | 'printer' | 'progress-half-filled' | 'progress-half' | 'progress-quarter-filled' | 'progress-quarter' | 'progress-zero-filled' | 'progress-zero' | 'python-filled' | 'python' | 'quiz-filled' | 'quiz' | 'refresh-filled' | 'refresh' | 'remove-filled' | 'remove' | 'reply-filled' | 'reply' | 'retail-filled' | 'retail' | 'screenshare-start-filled' | 'screenshare-start' | 'screenshare-stop-filled' | 'screenshare-stop' | 'search-filled' | 'search' | 'share-filled' | 'share' | 'shield-alert-filled' | 'shield-alert' | 'shield-check-filled' | 'shield-check' | 'shield-filled' | 'shield-lock-filled' | 'shield-lock' | 'shield-x-filled' | 'shield-x' | 'shield' | 'shop-filled' | 'shop' | 'sidebar-left-filled' | 'sidebar-left' | 'sidebar-right-filled' | 'sidebar-right' | 'signin-filled' | 'signin' | 'signout-filled' | 'signout' | 'slider-filled' | 'slider' | 'square-filled' | 'square' | 'sticky-note-filled' | 'sticky-note' | 'sun-filled' | 'sun' | 'thumbs-down-filled' | 'thumbs-down' | 'thumbs-up-filled' | 'thumbs-up' | 'thunder-filled' | 'thunder' | 'truck-filled' | 'truck' | 'upload-filled' | 'upload' | 'wrench-filled' | 'wrench' | 'bell-filled' | 'bell' | 'calender-check-filled' | 'calender-check' | 'calender-filled' | 'calender-plus-filled' | 'calender-plus' | 'calender' | 'clock-filled' | 'clock' | 'rewatch-filled' | 'rewatch' | 'stopwatch-filled' | 'stopwatch' | 'bot-filled' | 'bot' | 'person-check-filled' | 'person-check' | 'person-filled' | 'person-plus-filled' | 'person-plus' | 'person' | 'user-speak-filled' | 'user-speak' | 'users-filled' | 'users';
 type grauityFlippedChoiceName = 'vertically' | 'horizontally';
 type grauityRotatedChoiceName = 'clockwise' | 'counterclockwise';
 type grauityIconSizeName = '4' | '8' | '12' | '14' | '16' | '20' | '24' | '28' | '32' | '36' | '40';
@@ -3967,6 +3963,11 @@ interface DropdownOption {
     id: number | string;
     label: string;
 }
+/**
+ * @deprecated This interface is deprecated and will be removed in future versions.
+ * - Use the `DropdownMenu` component instead.
+ * @see {@link https://grauity.newtonschool.co/?path=/docs/elements-dropdownmenu--docs}
+ */
 export interface SelectDropdownProps {
     /**
      * Set of options available for selection.
@@ -4018,11 +4019,21 @@ export interface SelectDropdownProps {
      */
     width?: string | null;
 }
+/**
+ * @deprecated This component is deprecated and will be removed in future releases.
+ * - Use the `DropdownMenu` component instead.
+ * @see {@link https://grauity.newtonschool.co/?path=/docs/elements-dropdownmenu--docs}
+ */
 export const NSSelectDropdown: React.ForwardRefExoticComponent<SelectDropdownProps & React.RefAttributes<HTMLSelectElement>>;
 interface _DropdownOption1 {
     id: string;
     label: string;
 }
+/**
+ * @deprecated This interface is deprecated and will be removed in future versions.
+ * - Use the `DropdownMenu` component instead.
+ * @see {@link https://grauity.newtonschool.co/?path=/docs/elements-dropdownmenu--docs}
+ */
 export interface MultiSelectDropdownProps {
     /**
      * Text to display when no option is selected.
@@ -4075,6 +4086,11 @@ export interface MultiSelectDropdownProps {
      */
     triggerComponent?: React.ReactNode;
 }
+/**
+ * @deprecated This component is deprecated and will be removed in future releases.
+ * - Use the `DropdownMenu` component instead.
+ * @see {@link https://grauity.newtonschool.co/?path=/docs/elements-dropdownmenu--docs}
+ */
 export const NSMultiSelectDropdown: React.ForwardRefExoticComponent<MultiSelectDropdownProps & React.RefAttributes<HTMLSelectElement>>;
 type ChipVariants = 'brand' | 'success' | 'error' | 'warning' | 'yellow' | 'purple' | 'disabled' | 'action-brand' | 'action-success' | 'action-error' | 'action-warning' | 'action-yellow' | 'action-purple';
 type ChipSizes = 'small' | 'medium' | 'large' | 'extra-large';
@@ -5393,5 +5409,325 @@ export interface OtpInputFieldProps {
     successMessage?: string;
 }
 export const NSOtpInput: ({ label, name, length, onChange, style, isOtpCorrect, isOtpWrong, isDisabled, errorMessage, successMessage, }: OtpInputFieldProps) => JSX.Element;
+export enum NSDropdownMenuBaseItemType {
+    SUB_HEADER = "subheader",
+    DIVIDER = "divider",
+    OPTION = "option"
+}
+type OptionValue = string | number;
+export type NSDropdownMenuBaseItemSubHeaderProps = {
+    type: NSDropdownMenuBaseItemType.SUB_HEADER;
+    title: string;
+};
+export type NSDropdownMenuBaseItemDividerProps = {
+    type: NSDropdownMenuBaseItemType.DIVIDER;
+};
+export type NSDropdownMenuBaseItemOptionProps = {
+    type: NSDropdownMenuBaseItemType.OPTION;
+    label: string;
+    value: OptionValue;
+    description?: string;
+    leftIcon?: grauityIconName;
+    rightIcon?: grauityIconName;
+    disabled?: boolean;
+};
+export type NSDropdownMenuBaseItemProps = NSDropdownMenuBaseItemSubHeaderProps | NSDropdownMenuBaseItemDividerProps | NSDropdownMenuBaseItemOptionProps;
+export interface NSDropdownMenuProps {
+    /**
+     * Whether to show the header of the dropdown menu.
+     * - If `showHeader` is false, `title`, `overline`, and `subtext` will be ignored.
+     * - if `title`, `overline`, and `subtext` all are not provided, `showHeader` will be ignored.
+     * @default true
+     */
+    showHeader?: boolean;
+    /**
+     * The title of the dropdown menu.
+     * @default 'Select'
+     */
+    title?: string;
+    /**
+     * The overline text of the dropdown menu.
+     * @default ''
+     */
+    overline?: string;
+    /**
+     * The subtext of the dropdown menu.
+     * @default ''
+     */
+    subtext?: string;
+    /**
+     * Custom header component for the dropdown menu.
+     * - If `customHeader` is provided, `showHeader`, `title`, `overline`, and `subtext` will be ignored.
+     * @default null
+     */
+    customHeader?: React.ReactNode;
+    /**
+     * Whether the dropdown menu is searchable.
+     * @default false
+     */
+    searchable?: boolean;
+    /**
+     * Placeholder text for the search input.
+     * @default 'Search'
+     */
+    searchPlaceholder?: string;
+    /**
+     * Icon name for the search input.
+     * @default 'search'
+     */
+    searchIcon?: grauityIconName;
+    /**
+     * Callback function called when the search input value changes.
+     * @param value - The new value of the search input.
+     * @default A function that searches on label and description of items.
+     */
+    onSearchInputChange?: (value: string) => void;
+    /**
+     * Whether multiple items can be selected.
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * List of items to be displayed in the dropdown menu.
+     * @type {
+            type: 'subheader'
+            title?: string;
+        } | {
+            type: 'divider'
+        } | {
+            type: 'option'
+            label: string;
+            value: string;
+            description?: string;
+            leftIcon?: grauityIconName;
+            rightIcon?: grauityIconName;
+            disabled?: boolean;
+        }
+     * @default []
+     */
+    items: NSDropdownMenuBaseItemProps[];
+    /**
+     * Whether to show action buttons (e.g., Apply, Clear All).
+     * @default false in single select mode, true in multiple select mode
+     */
+    showActionButtons?: boolean;
+    /**
+     * Whether to show the "Clear All" button.
+     * - If `showActionButtons` is false, `showClearAllButton` will be ignored.
+     * - If `multiple` is false, `showClearAllButton` will always be false.
+     * @default true
+     */
+    showClearAllButton?: boolean;
+    /**
+     * Text for the "Clear All" button.
+     * @default 'Clear All'
+     */
+    clearAllButtonText?: string;
+    /**
+     * Text for the "Apply" button.
+     * @default 'Apply'
+     */
+    applyButtonText?: string;
+    /**
+     * Callback function called when the "Clear All" button is clicked.
+     * @default null
+     */
+    onClearAll?: () => void;
+    /**
+     * Callback function called to apply the selected items.
+     * - In single select mode, if `showActionButtons` is false, `onApply` will be called when an option is clicked.
+     * - In multiple select mode, if `showActionButtons` is false, `onApply` will be called when clicked outside the dropdown menu.
+     * - If `showActionButtons` is true, `onApply` will be called when the "Apply" button is clicked.
+     * @param items - The selected items.
+     * @default null
+     */
+    onApply?: (items: NSDropdownMenuBaseItemOptionProps[]) => void;
+    /**
+     * Callback function called when the dropdown menu is scrolled to the bottom.
+     * @default null
+     */
+    onScrollToBottom?: () => void;
+    /**
+     * Additional class names for the dropdown menu.
+     * @default null
+     */
+    className?: string;
+    /**
+     * Additional styles for the dropdown menu.
+     * @default {}
+     */
+    styles?: React.CSSProperties;
+    /**
+     * The values of the selected items.
+     * @default []
+     */
+    selectedValues?: OptionValue[];
+    /**
+     * The width of the dropdown menu.
+     * @default '300px'
+     */
+    width?: string;
+}
+export const NSDropdownMenu: React.ForwardRefExoticComponent<NSDropdownMenuProps & React.RefAttributes<HTMLDivElement>>;
+interface DropdownTriggerProps {
+    /**
+     * The name of the dropdown field
+     * @required
+     */
+    name: string;
+    /**
+     * The label for the dropdown field
+     */
+    label?: string;
+    /**
+     * The placeholder text for the dropdown field
+     * @default 'Select'
+     */
+    placeholder?: string;
+    /**
+     * Whether the dropdown field is required
+     * @default false
+     */
+    isRequired?: boolean;
+    /**
+      * Whether to disable the dropdown field
+ 
+      * @default false
+      */
+    isDisabled?: boolean;
+    /**
+     * The help message to display below the dropdown field
+     */
+    helpMessage?: string;
+    /**
+     * The error message to display when the dropdown field is invalid
+     */
+    errorMessage?: string;
+}
+export interface DropdownProps extends DropdownTriggerProps, NSDropdownMenuProps {
+    /**
+     * The width of the dropdown menu.
+     * @default '100%'
+     */
+    width?: string;
+}
+export const NSDropdown: (props: DropdownProps) => JSX.Element;
+export interface NSFormState {
+    [key: string]: any;
+}
+export interface NSFormErrors {
+    [key: string]: string;
+}
+export enum NSFormFieldType {
+    TEXTFIELD = "TEXTFIELD",
+    DATE_PICKER = "DATE_PICKER",
+    DROPDOWN = "DROPDOWN",
+    DROPDOWN_MENU = "DROPDOWN_MENU",
+    ICON_BUTTON = "ICON_BUTTON",
+    CHECKBOX = "CHECKBOX",
+    CUSTOM = "CUSTOM"
+}
+export interface NSConditionalProp {
+    propName: string;
+    propValue: any;
+    conditions: Array<{
+        prop: string;
+        value: any;
+    }>;
+}
+export interface NSFormFieldBaseProps {
+    type: NSFormFieldType;
+    renderer?: (props: FormFieldProps) => React.ReactNode;
+    rendererProps?: any;
+    schema?: Schema;
+    configProps?: any;
+    conditionalProps?: NSConditionalProp[];
+}
+export interface NSFormFieldTextFieldProps extends NSFormFieldBaseProps {
+    type: NSFormFieldType.TEXTFIELD;
+    rendererProps: TextFieldProps;
+}
+export interface NSFormFieldDatePickerProps extends NSFormFieldBaseProps {
+    type: NSFormFieldType.DATE_PICKER;
+    rendererProps: TextFieldProps;
+}
+export interface NSFormFieldDropdownProps extends NSFormFieldBaseProps {
+    type: NSFormFieldType.DROPDOWN;
+    rendererProps: DropdownProps;
+}
+export interface NSFormFieldDropdownMenuProps extends NSFormFieldBaseProps {
+    type: NSFormFieldType.DROPDOWN_MENU;
+    rendererProps: DropdownProps;
+}
+export interface NSFormFieldIconButtonProps extends NSFormFieldBaseProps {
+    type: NSFormFieldType.ICON_BUTTON;
+    rendererProps: IconButtonProps;
+}
+export interface NSFormFieldCheckboxProps extends NSFormFieldBaseProps {
+    type: NSFormFieldType.CHECKBOX;
+    rendererProps: CheckboxProps;
+}
+export interface NSFormFieldCustomProps extends NSFormFieldBaseProps {
+    type: NSFormFieldType.CUSTOM;
+    rendererProps: any;
+}
+export type NSFormField = NSFormFieldTextFieldProps | NSFormFieldDatePickerProps | NSFormFieldDropdownProps | NSFormFieldDropdownMenuProps | NSFormFieldIconButtonProps | NSFormFieldCheckboxProps | NSFormFieldCustomProps;
+export interface NSFormFields {
+    [key: string]: NSFormField;
+}
+export interface NSFormRowProps {
+    widths?: string;
+    column?: NSFormRowColumnCondition;
+    items?: NSFormField[];
+}
+export enum NSFormRowColumnCondition {
+    ALWAYS_COLUMN = "ALWAYS_COLUMN",
+    ALWAYS_ROW = "ALWAYS_ROW",
+    COLUMN_ON_MOBILE = "COLUMN_ON_MOBILE"
+}
+export interface NSFormConfig {
+    fields: NSFormFields;
+    initialState: NSFormState;
+    rows: NSFormRowProps[];
+}
+export interface NSUseFormHookProps {
+    /**
+     * The initial state of the form.
+     * @default {}
+     */
+    initialState?: NSFormState;
+    /**
+     * An array of form rows to be rendered.
+     * @default []
+     */
+    formRows?: NSFormRowProps[];
+    /**
+     * CSS properties to style the form rows.
+     * @default {}
+     */
+    rowStyles?: React.CSSProperties;
+    /**
+     * Flag to indicate if the form is being viewed on a mobile device.
+     * @default false
+     */
+    isMobileView?: boolean;
+}
+export interface NSUseFormHookReturnProps {
+    formData: NSFormState;
+    formRenderer: React.ReactNode;
+    validateFields: (fields: NSFormFields, data: NSFormState) => any;
+    changeFormData: (newData: NSFormState) => void;
+}
+interface HandleFormFieldChangeProps {
+    name: string;
+    value: any;
+}
+interface FormFieldProps {
+    formField: NSFormField;
+    error?: string;
+    formData: NSFormState;
+    handleChange: (props: HandleFormFieldChangeProps) => void;
+}
+export const useNSFormHook: ({ initialState, formRows, rowStyles, isMobileView, }: NSUseFormHookProps) => NSUseFormHookReturnProps;
 
 //# sourceMappingURL=index.d.ts.map