@ceed/ads 1.25.1-next.3 → 1.27.0

package/dist/index.cjs

@@ -841,11 +841,24 @@ Button.displayName = "Button";
 var Button_default = Button;
 
 // src/components/Calendar/Calendar.tsx
-var import_react13 = __toESM(require("react"));
-var import_joy18 = require("@mui/joy");
+var import_react14 = __toESM(require("react"));
+var import_joy19 = require("@mui/joy");
 var import_ChevronLeft = __toESM(require("@mui/icons-material/ChevronLeft"));
 var import_ChevronRight = __toESM(require("@mui/icons-material/ChevronRight"));
+var import_framer_motion13 = require("framer-motion");
+
+// src/components/Tooltip/Tooltip.tsx
+var import_react11 = __toESM(require("react"));
+var import_joy17 = require("@mui/joy");
 var import_framer_motion12 = require("framer-motion");
+var MotionTooltip = (0, import_framer_motion12.motion)(import_joy17.Tooltip);
+var Tooltip = (props) => {
+  return /* @__PURE__ */ import_react11.default.createElement(MotionTooltip, { ...props });
+};
+Tooltip.displayName = "Tooltip";
+
+// src/components/Tooltip/index.ts
+var Tooltip_default = Tooltip;
 
 // src/components/Calendar/utils/index.ts
 var getCalendarDates = (date) => {
@@ -919,43 +932,43 @@ var isSameMonth = (date1, date2) => {
 };
 
 // src/components/Calendar/hooks/use-calendar-props.ts
-var import_react11 = require("react");
-var import_joy17 = require("@mui/joy");
+var import_react12 = require("react");
+var import_joy18 = require("@mui/joy");
 var resolveView = (view, views) => {
   return views.includes(view) ? view : views[0];
 };
 var useCalendarProps = (inProps) => {
-  const [uncontrolledView, setUncontrolledView] = (0, import_react11.useState)(
+  const [uncontrolledView, setUncontrolledView] = (0, import_react12.useState)(
     () => resolveView(inProps.view || "day", inProps.views || ["day", "month"])
   );
-  const [uncontrolledValue, setUncontrolledValue] = (0, import_react11.useState)(
+  const [uncontrolledValue, setUncontrolledValue] = (0, import_react12.useState)(
     inProps.defaultValue
   );
-  const [viewMonth, setViewMonth] = (0, import_react11.useState)(() => {
+  const [viewMonth, setViewMonth] = (0, import_react12.useState)(() => {
     const today = /* @__PURE__ */ new Date();
     today.setDate(1);
     today.setHours(0, 0, 0, 0);
     return inProps.value?.[0] || inProps.defaultValue?.[0] || today;
   });
-  const [[page, direction], setPage] = (0, import_react11.useState)([0, 0]);
+  const [[page, direction], setPage] = (0, import_react12.useState)([0, 0]);
   const resolvedView = inProps.view ?? uncontrolledView;
-  const resolvedMinDate = (0, import_react11.useMemo)(() => {
+  const resolvedMinDate = (0, import_react12.useMemo)(() => {
     const minDate = inProps.minDate || /* @__PURE__ */ new Date(0);
     minDate.setHours(0, 0, 0, 0);
     return minDate;
   }, [inProps.minDate]);
-  const resolvedMaxDate = (0, import_react11.useMemo)(() => {
+  const resolvedMaxDate = (0, import_react12.useMemo)(() => {
     const maxDate = inProps.maxDate || /* @__PURE__ */ new Date(864e13);
     maxDate.setHours(0, 0, 0, 0);
     return maxDate;
   }, [inProps.maxDate]);
-  const paginate = (0, import_react11.useCallback)(
+  const paginate = (0, import_react12.useCallback)(
     (newDirection) => {
       setPage([page + newDirection, newDirection]);
     },
     [page]
   );
-  const handleViewMonthChange = (0, import_react11.useCallback)(
+  const handleViewMonthChange = (0, import_react12.useCallback)(
     (newMonth) => {
       setViewMonth(newMonth);
       if (resolvedView === "month") {
@@ -969,7 +982,7 @@ var useCalendarProps = (inProps) => {
     },
     [resolvedView, inProps, viewMonth, paginate]
   );
-  const props = (0, import_joy17.useThemeProps)({
+  const props = (0, import_joy18.useThemeProps)({
     props: {
       locale: "default",
       views: ["day", "month"],
@@ -1003,18 +1016,18 @@ var useCalendarProps = (inProps) => {
     },
     name: "Calendar"
   });
-  const ownerState = (0, import_react11.useMemo)(() => ({ ...props, viewMonth, direction }), [props, viewMonth, direction]);
+  const ownerState = (0, import_react12.useMemo)(() => ({ ...props, viewMonth, direction }), [props, viewMonth, direction]);
   return [props, ownerState];
 };
 
 // src/components/Calendar/hooks/use-calendar.ts
-var import_react12 = require("react");
+var import_react13 = require("react");
 var useCalendar = (ownerState) => {
-  const [hoverDay, setHoverDay] = (0, import_react12.useState)(null);
-  const [hoverMonth, setHoverMonth] = (0, import_react12.useState)(null);
+  const [hoverDay, setHoverDay] = (0, import_react13.useState)(null);
+  const [hoverMonth, setHoverMonth] = (0, import_react13.useState)(null);
   return {
     calendarTitle: ownerState.view === "month" ? getYearName(ownerState.viewMonth, ownerState.locale || "default") : getMonthName(ownerState.viewMonth, ownerState.locale || "default"),
-    onPrev: (0, import_react12.useCallback)(() => {
+    onPrev: (0, import_react13.useCallback)(() => {
       if (ownerState.view === "day") {
         const currentDate = new Date(ownerState.viewMonth || /* @__PURE__ */ new Date());
         const currentYear = currentDate.getFullYear();
@@ -1031,7 +1044,7 @@ var useCalendar = (ownerState) => {
         ownerState.onMonthChange?.(prevYear);
       }
     }, [ownerState.onMonthChange, ownerState.viewMonth, ownerState.view]),
-    onNext: (0, import_react12.useCallback)(() => {
+    onNext: (0, import_react13.useCallback)(() => {
       if (ownerState.view === "day") {
         const currentDate = new Date(ownerState.viewMonth || /* @__PURE__ */ new Date());
         const currentYear = currentDate.getFullYear();
@@ -1048,7 +1061,7 @@ var useCalendar = (ownerState) => {
         ownerState.onMonthChange?.(nextYear);
       }
     }, [ownerState.onMonthChange, ownerState.viewMonth, ownerState.view]),
-    getDayCellProps: (0, import_react12.useCallback)(
+    getDayCellProps: (0, import_react13.useCallback)(
       (day) => {
         const thisDay = new Date(ownerState.viewMonth || /* @__PURE__ */ new Date());
         thisDay.setHours(0, 0, 0, 0);
@@ -1063,7 +1076,7 @@ var useCalendar = (ownerState) => {
       },
       [ownerState.rangeSelection, ownerState.value, ownerState.viewMonth, hoverDay]
     ),
-    getMonthCellProps: (0, import_react12.useCallback)(
+    getMonthCellProps: (0, import_react13.useCallback)(
       (monthIndex) => {
         const thisMonth = new Date(ownerState.viewMonth || /* @__PURE__ */ new Date());
         thisMonth.setDate(1);
@@ -1080,7 +1093,7 @@ var useCalendar = (ownerState) => {
       },
       [ownerState.rangeSelection, ownerState.value, ownerState.viewMonth, hoverMonth]
     ),
-    getPickerDayProps: (0, import_react12.useCallback)(
+    getPickerDayProps: (0, import_react13.useCallback)(
       (day) => {
         const thisDay = new Date(ownerState.viewMonth || /* @__PURE__ */ new Date());
         thisDay.setHours(0, 0, 0, 0);
@@ -1134,7 +1147,7 @@ var useCalendar = (ownerState) => {
         hoverDay
       ]
     ),
-    getPickerMonthProps: (0, import_react12.useCallback)(
+    getPickerMonthProps: (0, import_react13.useCallback)(
       (monthIndex) => {
         const thisMonth = new Date(ownerState.viewMonth || /* @__PURE__ */ new Date());
         thisMonth.setDate(1);
@@ -1204,13 +1217,19 @@ var useCalendar = (ownerState) => {
 };
 
 // src/components/Calendar/Calendar.tsx
-var CalendarRoot = (0, import_joy18.styled)("div", {
+var MONTH_VIEW_HINT_MESSAGE = "Click the month title to view all months.";
+var MONTH_NAV_CLICK_WINDOW_MS = 1200;
+var MONTH_NAV_CLICK_THRESHOLD = 3;
+var MONTH_VIEW_HINT_DURATION_MS = 5e3;
+var MONTH_VIEW_HINT_COOLDOWN_MS = 3e4;
+var lastMonthViewAssistHintShownAt = 0;
+var CalendarRoot = (0, import_joy19.styled)("div", {
   name: "Calendar",
   slot: "root"
 })({
   maxWidth: "264px"
 });
-var CalendarHeader = (0, import_joy18.styled)("div", {
+var CalendarHeader = (0, import_joy19.styled)("div", {
   name: "Calendar",
   slot: "calendarHeader"
 })(({ theme }) => ({
@@ -1219,7 +1238,7 @@ var CalendarHeader = (0, import_joy18.styled)("div", {
   alignItems: "center",
   padding: theme.spacing(2)
 }));
-var CalendarViewContainer = (0, import_joy18.styled)("div", {
+var CalendarViewContainer = (0, import_joy19.styled)("div", {
   name: "Calendar",
   slot: "viewContainer",
   shouldForwardProp: (prop) => prop !== "calendarType"
@@ -1230,7 +1249,7 @@ var CalendarViewContainer = (0, import_joy18.styled)("div", {
   overflow: "hidden",
   minHeight: calendarType === "datePicker" ? "250px" : "unset"
 }));
-var CalendarViewTable = (0, import_joy18.styled)(import_framer_motion12.motion.table, {
+var CalendarViewTable = (0, import_joy19.styled)(import_framer_motion13.motion.table, {
   name: "Calendar",
   slot: "viewTable"
 })(({ theme }) => ({
@@ -1243,15 +1262,15 @@ var CalendarViewTable = (0, import_joy18.styled)(import_framer_motion12.motion.t
     paddingBottom: theme.spacing(2)
   }
 }));
-var CalendarWeekHeaderContainer = (0, import_joy18.styled)("thead", {
+var CalendarWeekHeaderContainer = (0, import_joy19.styled)("thead", {
   name: "Calendar",
   slot: "weekHeaderContainer"
 })({});
-var CalendarDayPickerContainer = (0, import_joy18.styled)("tbody", {
+var CalendarDayPickerContainer = (0, import_joy19.styled)("tbody", {
   name: "Calendar",
   slot: "dayPickerContainer"
 })({});
-var CalendarSwitchViewButton = (0, import_joy18.styled)(Button_default, {
+var CalendarSwitchViewButton = (0, import_joy19.styled)(Button_default, {
   name: "Calendar",
   slot: "switchViewButton"
 })(({ ownerState }) => [
@@ -1259,7 +1278,7 @@ var CalendarSwitchViewButton = (0, import_joy18.styled)(Button_default, {
     pointerEvents: "none"
   }
 ]);
-var CalendarDayCell = (0, import_joy18.styled)("td", {
+var CalendarDayCell = (0, import_joy19.styled)("td", {
   name: "Calendar",
   slot: "dayCell"
 })(({ theme }) => ({
@@ -1281,7 +1300,7 @@ var CalendarDayCell = (0, import_joy18.styled)("td", {
     }
   }
 }));
-var CalendarMonthCell = (0, import_joy18.styled)("td", {
+var CalendarMonthCell = (0, import_joy19.styled)("td", {
   name: "Calendar",
   slot: "monthCell"
 })(({ theme }) => ({
@@ -1303,7 +1322,7 @@ var CalendarMonthCell = (0, import_joy18.styled)("td", {
     }
   }
 }));
-var CalendarMonth = (0, import_joy18.styled)(Button_default, {
+var CalendarMonth = (0, import_joy19.styled)(Button_default, {
   name: "Calendar",
   slot: "month",
   shouldForwardProp: (prop) => prop !== "isSelected"
@@ -1338,7 +1357,7 @@ var CalendarMonth = (0, import_joy18.styled)(Button_default, {
     backgroundColor: theme.palette.neutral.solidDisabledBg
   }
 ]);
-var CalendarDay = (0, import_joy18.styled)(Button_default, {
+var CalendarDay = (0, import_joy19.styled)(Button_default, {
   name: "Calendar",
   slot: "day",
   shouldForwardProp: (prop) => !["isToday", "isSelected"].includes(prop)
@@ -1408,9 +1427,9 @@ var swipePower = (offset, velocity) => {
 var PickerDays = (props) => {
   const { ownerState } = props;
   const { getPickerDayProps, getDayCellProps } = useCalendar(ownerState);
-  const calendarDates = (0, import_react13.useMemo)(() => getCalendarDates(ownerState.viewMonth), [ownerState.viewMonth]);
-  const weekdayNames = (0, import_react13.useMemo)(() => getWeekdayNames(ownerState.locale || "default"), [ownerState.locale]);
-  return /* @__PURE__ */ import_react13.default.createElement(CalendarViewContainer, { calendarType: "datePicker" }, /* @__PURE__ */ import_react13.default.createElement(import_framer_motion12.AnimatePresence, { initial: false, custom: ownerState.direction }, /* @__PURE__ */ import_react13.default.createElement(
+  const calendarDates = (0, import_react14.useMemo)(() => getCalendarDates(ownerState.viewMonth), [ownerState.viewMonth]);
+  const weekdayNames = (0, import_react14.useMemo)(() => getWeekdayNames(ownerState.locale || "default"), [ownerState.locale]);
+  return /* @__PURE__ */ import_react14.default.createElement(CalendarViewContainer, { calendarType: "datePicker" }, /* @__PURE__ */ import_react14.default.createElement(import_framer_motion13.AnimatePresence, { initial: false, custom: ownerState.direction }, /* @__PURE__ */ import_react14.default.createElement(
     CalendarViewTable,
     {
       key: `${ownerState.viewMonth.toString()}_${ownerState.direction}`,
@@ -1439,10 +1458,10 @@ var PickerDays = (props) => {
         }
       }
     },
-    /* @__PURE__ */ import_react13.default.createElement(CalendarWeekHeaderContainer, null, /* @__PURE__ */ import_react13.default.createElement("tr", null, weekdayNames.map((name, i) => /* @__PURE__ */ import_react13.default.createElement(import_react13.Fragment, { key: `${ownerState.viewMonth}_${name}_${i}` }, /* @__PURE__ */ import_react13.default.createElement("th", null, /* @__PURE__ */ import_react13.default.createElement(Typography_default, { level: "body-xs", textAlign: "center" }, name)), i < 6 && /* @__PURE__ */ import_react13.default.createElement("th", { style: { width: 4 }, "aria-hidden": "true", "aria-description": "cell-gap" }))))),
-    /* @__PURE__ */ import_react13.default.createElement(CalendarDayPickerContainer, null, calendarDates.map((weekDates, rowIndex) => /* @__PURE__ */ import_react13.default.createElement(import_react13.Fragment, { key: `${ownerState.viewMonth}_${rowIndex}` }, /* @__PURE__ */ import_react13.default.createElement("tr", null, weekDates.map(
-      (date, i) => date ? /* @__PURE__ */ import_react13.default.createElement(import_react13.Fragment, { key: `${ownerState.viewMonth}_${date}_${i}` }, /* @__PURE__ */ import_react13.default.createElement(CalendarDayCell, { ...getDayCellProps(date) }, /* @__PURE__ */ import_react13.default.createElement(CalendarDay, { size: "sm", variant: "plain", color: "neutral", ...getPickerDayProps(date) }, date)), i < 6 && /* @__PURE__ */ import_react13.default.createElement("td", { "aria-hidden": "true", "aria-description": "cell-gap" })) : /* @__PURE__ */ import_react13.default.createElement(import_react13.Fragment, { key: `${ownerState.viewMonth}_${i}` }, /* @__PURE__ */ import_react13.default.createElement("td", null), i < 6 && /* @__PURE__ */ import_react13.default.createElement("td", { "aria-hidden": "true", "aria-description": "cell-gap" }))
-    )), rowIndex < calendarDates.length - 1 && /* @__PURE__ */ import_react13.default.createElement("tr", { "aria-hidden": "true", "aria-description": "row-gap" }, /* @__PURE__ */ import_react13.default.createElement("td", { colSpan: 13, style: { height: 4 } })))))
+    /* @__PURE__ */ import_react14.default.createElement(CalendarWeekHeaderContainer, null, /* @__PURE__ */ import_react14.default.createElement("tr", null, weekdayNames.map((name, i) => /* @__PURE__ */ import_react14.default.createElement(import_react14.Fragment, { key: `${ownerState.viewMonth}_${name}_${i}` }, /* @__PURE__ */ import_react14.default.createElement("th", null, /* @__PURE__ */ import_react14.default.createElement(Typography_default, { level: "body-xs", textAlign: "center" }, name)), i < 6 && /* @__PURE__ */ import_react14.default.createElement("th", { style: { width: 4 }, "aria-hidden": "true", "aria-description": "cell-gap" }))))),
+    /* @__PURE__ */ import_react14.default.createElement(CalendarDayPickerContainer, null, calendarDates.map((weekDates, rowIndex) => /* @__PURE__ */ import_react14.default.createElement(import_react14.Fragment, { key: `${ownerState.viewMonth}_${rowIndex}` }, /* @__PURE__ */ import_react14.default.createElement("tr", null, weekDates.map(
+      (date, i) => date ? /* @__PURE__ */ import_react14.default.createElement(import_react14.Fragment, { key: `${ownerState.viewMonth}_${date}_${i}` }, /* @__PURE__ */ import_react14.default.createElement(CalendarDayCell, { ...getDayCellProps(date) }, /* @__PURE__ */ import_react14.default.createElement(CalendarDay, { size: "sm", variant: "plain", color: "neutral", ...getPickerDayProps(date) }, date)), i < 6 && /* @__PURE__ */ import_react14.default.createElement("td", { "aria-hidden": "true", "aria-description": "cell-gap" })) : /* @__PURE__ */ import_react14.default.createElement(import_react14.Fragment, { key: `${ownerState.viewMonth}_${i}` }, /* @__PURE__ */ import_react14.default.createElement("td", null), i < 6 && /* @__PURE__ */ import_react14.default.createElement("td", { "aria-hidden": "true", "aria-description": "cell-gap" }))
+    )), rowIndex < calendarDates.length - 1 && /* @__PURE__ */ import_react14.default.createElement("tr", { "aria-hidden": "true", "aria-description": "row-gap" }, /* @__PURE__ */ import_react14.default.createElement("td", { colSpan: 13, style: { height: 4 } })))))
   )));
 };
 var PickerMonths = (props) => {
@@ -1459,7 +1478,7 @@ var PickerMonths = (props) => {
     [[]]
   );
   const isMonthPicker = !ownerState.views?.find((view) => view === "day");
-  return /* @__PURE__ */ import_react13.default.createElement(CalendarViewContainer, { calendarType: isMonthPicker ? "monthPicker" : "datePicker" }, /* @__PURE__ */ import_react13.default.createElement(import_framer_motion12.AnimatePresence, { initial: false, custom: ownerState.direction }, /* @__PURE__ */ import_react13.default.createElement(
+  return /* @__PURE__ */ import_react14.default.createElement(CalendarViewContainer, { calendarType: isMonthPicker ? "monthPicker" : "datePicker" }, /* @__PURE__ */ import_react14.default.createElement(import_framer_motion13.AnimatePresence, { initial: false, custom: ownerState.direction }, /* @__PURE__ */ import_react14.default.createElement(
     CalendarViewTable,
     {
       key: `${ownerState.viewMonth.getFullYear()}_${ownerState.direction}`,
@@ -1488,10 +1507,10 @@ var PickerMonths = (props) => {
         }
       }
     },
-    /* @__PURE__ */ import_react13.default.createElement("tbody", null, chunkedMonths.map((months, i) => /* @__PURE__ */ import_react13.default.createElement(import_react13.Fragment, { key: months.join("_") }, /* @__PURE__ */ import_react13.default.createElement("tr", null, months.map((monthIndex, j) => /* @__PURE__ */ import_react13.default.createElement(import_react13.Fragment, { key: monthIndex }, /* @__PURE__ */ import_react13.default.createElement(CalendarMonthCell, { ...getMonthCellProps(monthIndex) }, /* @__PURE__ */ import_react13.default.createElement(CalendarMonth, { size: "sm", variant: "plain", color: "neutral", ...getPickerMonthProps(monthIndex) }, getMonthNameFromIndex(monthIndex, ownerState.locale))), j < 3 && /* @__PURE__ */ import_react13.default.createElement("td", { style: { width: 4 }, "aria-hidden": "true", "aria-description": "cell-gap" })))), i < chunkedMonths.length - 1 && /* @__PURE__ */ import_react13.default.createElement("tr", { "aria-hidden": "true", "aria-description": "row-gap" }, /* @__PURE__ */ import_react13.default.createElement("td", { colSpan: 7, style: { height: 4 } })))))
+    /* @__PURE__ */ import_react14.default.createElement("tbody", null, chunkedMonths.map((months, i) => /* @__PURE__ */ import_react14.default.createElement(import_react14.Fragment, { key: months.join("_") }, /* @__PURE__ */ import_react14.default.createElement("tr", null, months.map((monthIndex, j) => /* @__PURE__ */ import_react14.default.createElement(import_react14.Fragment, { key: monthIndex }, /* @__PURE__ */ import_react14.default.createElement(CalendarMonthCell, { ...getMonthCellProps(monthIndex) }, /* @__PURE__ */ import_react14.default.createElement(CalendarMonth, { size: "sm", variant: "plain", color: "neutral", ...getPickerMonthProps(monthIndex) }, getMonthNameFromIndex(monthIndex, ownerState.locale))), j < 3 && /* @__PURE__ */ import_react14.default.createElement("td", { style: { width: 4 }, "aria-hidden": "true", "aria-description": "cell-gap" })))), i < chunkedMonths.length - 1 && /* @__PURE__ */ import_react14.default.createElement("tr", { "aria-hidden": "true", "aria-description": "row-gap" }, /* @__PURE__ */ import_react14.default.createElement("td", { colSpan: 7, style: { height: 4 } })))))
   )));
 };
-var Calendar = (0, import_react13.forwardRef)((inProps, ref) => {
+var Calendar = (0, import_react14.forwardRef)((inProps, ref) => {
   const [props, ownerState] = useCalendarProps(inProps);
   const {
     value,
@@ -1510,17 +1529,96 @@ var Calendar = (0, import_react13.forwardRef)((inProps, ref) => {
     ...others
   } = props;
   const { calendarTitle, onPrev, onNext } = useCalendar(ownerState);
-  return /* @__PURE__ */ import_react13.default.createElement(CalendarRoot, { ref, ...others }, /* @__PURE__ */ import_react13.default.createElement(CalendarHeader, null, /* @__PURE__ */ import_react13.default.createElement(IconButton_default, { size: "sm", onClick: onPrev, "aria-label": `Previous ${view === "day" ? "Month" : "Year"}` }, /* @__PURE__ */ import_react13.default.createElement(import_ChevronLeft.default, null)), /* @__PURE__ */ import_react13.default.createElement(
-    CalendarSwitchViewButton,
+  const [isMonthViewAssistHintOpen, setIsMonthViewAssistHintOpen] = (0, import_react14.useState)(false);
+  const monthNavClickTimestampsRef = (0, import_react14.useRef)([]);
+  const monthViewAssistHintShownInSessionRef = (0, import_react14.useRef)(false);
+  const monthViewAssistHintTimeoutRef = (0, import_react14.useRef)(null);
+  const hasEndDate = Boolean(value?.[1]);
+  const isRangeHintEligible = Boolean(rangeSelection && !hasEndDate);
+  const isHintEligible = Boolean(view === "day" && (!rangeSelection || isRangeHintEligible));
+  const monthViewHintMessage = MONTH_VIEW_HINT_MESSAGE;
+  (0, import_react14.useEffect)(() => {
+    if (!isHintEligible) {
+      monthNavClickTimestampsRef.current = [];
+      setIsMonthViewAssistHintOpen(false);
+    }
+  }, [isHintEligible]);
+  (0, import_react14.useEffect)(() => {
+    return () => {
+      if (monthViewAssistHintTimeoutRef.current) {
+        clearTimeout(monthViewAssistHintTimeoutRef.current);
+      }
+    };
+  }, []);
+  const closeMonthViewAssistHint = (0, import_react14.useCallback)(() => {
+    if (monthViewAssistHintTimeoutRef.current) {
+      clearTimeout(monthViewAssistHintTimeoutRef.current);
+      monthViewAssistHintTimeoutRef.current = null;
+    }
+    setIsMonthViewAssistHintOpen(false);
+  }, []);
+  const showMonthViewAssistHint = (0, import_react14.useCallback)(() => {
+    const now = Date.now();
+    if (monthViewAssistHintShownInSessionRef.current) return;
+    if (now - lastMonthViewAssistHintShownAt < MONTH_VIEW_HINT_COOLDOWN_MS) return;
+    monthViewAssistHintShownInSessionRef.current = true;
+    lastMonthViewAssistHintShownAt = now;
+    setIsMonthViewAssistHintOpen(true);
+    if (monthViewAssistHintTimeoutRef.current) {
+      clearTimeout(monthViewAssistHintTimeoutRef.current);
+    }
+    monthViewAssistHintTimeoutRef.current = setTimeout(() => {
+      setIsMonthViewAssistHintOpen(false);
+      monthViewAssistHintTimeoutRef.current = null;
+    }, MONTH_VIEW_HINT_DURATION_MS);
+  }, []);
+  const trackFastMonthNavigation = (0, import_react14.useCallback)(() => {
+    if (!isHintEligible) return;
+    const now = Date.now();
+    monthNavClickTimestampsRef.current = [
+      ...monthNavClickTimestampsRef.current.filter((timestamp) => now - timestamp <= MONTH_NAV_CLICK_WINDOW_MS),
+      now
+    ];
+    if (monthNavClickTimestampsRef.current.length >= MONTH_NAV_CLICK_THRESHOLD) {
+      showMonthViewAssistHint();
+    }
+  }, [isHintEligible, showMonthViewAssistHint]);
+  const handlePrevClick = (0, import_react14.useCallback)(() => {
+    onPrev();
+    trackFastMonthNavigation();
+  }, [onPrev, trackFastMonthNavigation]);
+  const handleNextClick = (0, import_react14.useCallback)(() => {
+    onNext();
+    trackFastMonthNavigation();
+  }, [onNext, trackFastMonthNavigation]);
+  const handleSwitchViewClick = (0, import_react14.useCallback)(() => {
+    closeMonthViewAssistHint();
+    onViewChange?.();
+  }, [closeMonthViewAssistHint, onViewChange]);
+  return /* @__PURE__ */ import_react14.default.createElement(CalendarRoot, { ref, ...others }, /* @__PURE__ */ import_react14.default.createElement(CalendarHeader, null, /* @__PURE__ */ import_react14.default.createElement(IconButton_default, { size: "sm", onClick: handlePrevClick, "aria-label": `Previous ${view === "day" ? "Month" : "Year"}` }, /* @__PURE__ */ import_react14.default.createElement(import_ChevronLeft.default, null)), /* @__PURE__ */ import_react14.default.createElement(
+    Tooltip_default,
     {
-      ownerState,
-      variant: "plain",
-      color: "neutral",
-      onClick: onViewChange,
-      "aria-label": "Switch Calendar View"
+      title: monthViewHintMessage,
+      arrow: true,
+      open: isMonthViewAssistHintOpen,
+      placement: "bottom",
+      disableFocusListener: true,
+      disableHoverListener: true,
+      disableTouchListener: true,
+      variant: "solid"
     },
-    calendarTitle
-  ), /* @__PURE__ */ import_react13.default.createElement(IconButton_default, { size: "sm", onClick: onNext, "aria-label": `Next ${view === "day" ? "Month" : "Year"}` }, /* @__PURE__ */ import_react13.default.createElement(import_ChevronRight.default, null))), view === "day" && /* @__PURE__ */ import_react13.default.createElement(PickerDays, { ownerState }), view === "month" && /* @__PURE__ */ import_react13.default.createElement(PickerMonths, { ownerState }));
+    /* @__PURE__ */ import_react14.default.createElement(
+      CalendarSwitchViewButton,
+      {
+        ownerState,
+        variant: "plain",
+        color: "neutral",
+        onClick: handleSwitchViewClick,
+        "aria-label": "Switch Calendar View"
+      },
+      calendarTitle
+    )
+  ), /* @__PURE__ */ import_react14.default.createElement(IconButton_default, { size: "sm", onClick: handleNextClick, "aria-label": `Next ${view === "day" ? "Month" : "Year"}` }, /* @__PURE__ */ import_react14.default.createElement(import_ChevronRight.default, null))), view === "day" && /* @__PURE__ */ import_react14.default.createElement(PickerDays, { ownerState }), view === "month" && /* @__PURE__ */ import_react14.default.createElement(PickerMonths, { ownerState }));
 });
 Calendar.displayName = "Calendar";
 
@@ -1528,31 +1626,31 @@ Calendar.displayName = "Calendar";
 var Calendar_default = Calendar;
 
 // src/components/Card/Card.tsx
-var import_joy19 = require("@mui/joy");
-var import_framer_motion13 = require("framer-motion");
-var MotionCard = (0, import_framer_motion13.motion)(import_joy19.Card);
+var import_joy20 = require("@mui/joy");
+var import_framer_motion14 = require("framer-motion");
+var MotionCard = (0, import_framer_motion14.motion)(import_joy20.Card);
 var Card = MotionCard;
 Card.displayName = "Card";
-var MotionCardContent = (0, import_framer_motion13.motion)(import_joy19.CardContent);
+var MotionCardContent = (0, import_framer_motion14.motion)(import_joy20.CardContent);
 var CardContent = MotionCardContent;
 CardContent.displayName = "CardContent";
-var MotionCardCover = (0, import_framer_motion13.motion)(import_joy19.CardCover);
+var MotionCardCover = (0, import_framer_motion14.motion)(import_joy20.CardCover);
 var CardCover = MotionCardCover;
 CardCover.displayName = "CardCover";
-var MotionCardActions = (0, import_framer_motion13.motion)(import_joy19.CardActions);
+var MotionCardActions = (0, import_framer_motion14.motion)(import_joy20.CardActions);
 var CardActions = MotionCardActions;
 CardActions.displayName = "CardActions";
-var MotionCardOverflow = (0, import_framer_motion13.motion)(import_joy19.CardOverflow);
+var MotionCardOverflow = (0, import_framer_motion14.motion)(import_joy20.CardOverflow);
 var CardOverflow = MotionCardOverflow;
 CardOverflow.displayName = "CardOverflow";
 
 // src/components/Checkbox/Checkbox.tsx
-var import_react14 = __toESM(require("react"));
-var import_joy20 = require("@mui/joy");
-var import_framer_motion14 = require("framer-motion");
-var MotionCheckbox = (0, import_framer_motion14.motion)(import_joy20.Checkbox);
+var import_react15 = __toESM(require("react"));
+var import_joy21 = require("@mui/joy");
+var import_framer_motion15 = require("framer-motion");
+var MotionCheckbox = (0, import_framer_motion15.motion)(import_joy21.Checkbox);
 var Checkbox = (props) => {
-  return /* @__PURE__ */ import_react14.default.createElement(MotionCheckbox, { ...props });
+  return /* @__PURE__ */ import_react15.default.createElement(MotionCheckbox, { ...props });
 };
 Checkbox.displayName = "Checkbox";
 
@@ -1560,9 +1658,9 @@ Checkbox.displayName = "Checkbox";
 var Checkbox_default = Checkbox;
 
 // src/components/Container/Container.tsx
-var import_joy21 = require("@mui/joy");
-var import_react15 = __toESM(require("react"));
-var ContainerRoot = (0, import_joy21.styled)("div", {
+var import_joy22 = require("@mui/joy");
+var import_react16 = __toESM(require("react"));
+var ContainerRoot = (0, import_joy22.styled)("div", {
   name: "Container",
   slot: "root",
   shouldForwardProp: (prop) => prop !== "maxWidth" && prop !== "overrideBreakpoint"
@@ -1587,25 +1685,24 @@ var ContainerRoot = (0, import_joy21.styled)("div", {
     paddingRight: theme.breakpoints.values[overrideBreakpoint] >= theme.breakpoints.values.lg ? theme.spacing(8) : theme.spacing(4)
   } : null
 ]);
-var Container = (0, import_react15.forwardRef)(function Container2(props, ref) {
-  return /* @__PURE__ */ import_react15.default.createElement(ContainerRoot, { ref, ...props });
+var Container = (0, import_react16.forwardRef)(function Container2(props, ref) {
+  return /* @__PURE__ */ import_react16.default.createElement(ContainerRoot, { ref, ...props });
 });
 Container.displayName = "Container";
 
 // src/components/CurrencyInput/CurrencyInput.tsx
-var import_react17 = __toESM(require("react"));
-var import_intl_messageformat2 = require("intl-messageformat");
+var import_react18 = __toESM(require("react"));
 var import_react_number_format = require("react-number-format");
 
 // src/components/Input/Input.tsx
-var import_react16 = __toESM(require("react"));
-var import_joy22 = require("@mui/joy");
-var import_framer_motion15 = require("framer-motion");
+var import_react17 = __toESM(require("react"));
+var import_joy23 = require("@mui/joy");
+var import_framer_motion16 = require("framer-motion");
 var import_Close2 = __toESM(require("@mui/icons-material/Close"));
 var import_Visibility = __toESM(require("@mui/icons-material/Visibility"));
 var import_VisibilityOff = __toESM(require("@mui/icons-material/VisibilityOff"));
-var MotionInput = (0, import_framer_motion15.motion)(import_joy22.Input);
-var Input = import_react16.default.forwardRef((props, ref) => {
+var MotionInput = (0, import_framer_motion16.motion)(import_joy23.Input);
+var Input = import_react17.default.forwardRef((props, ref) => {
   const {
     label,
     helperText,
@@ -1628,11 +1725,11 @@ var Input = import_react16.default.forwardRef((props, ref) => {
   if (type === "password" && innerProps.endDecorator) {
     console.warn('Input: endDecorator is not supported when type="password"');
   }
-  const [passwordVisible, setPasswordVisible] = (0, import_react16.useState)(false);
+  const [passwordVisible, setPasswordVisible] = (0, import_react17.useState)(false);
   const [value, setValue] = useControlledState(
     props.value,
     props.defaultValue,
-    (0, import_react16.useCallback)(
+    (0, import_react17.useCallback)(
       (value2) => {
         onChange?.({
           /**
@@ -1658,7 +1755,7 @@ var Input = import_react16.default.forwardRef((props, ref) => {
   const actualType = type === "password" && passwordVisible ? "text" : type;
   const isPasswordType = type === "password";
   const showPasswordToggle = isPasswordType && !disableTogglePasswordButton;
-  const input = /* @__PURE__ */ import_react16.default.createElement(
+  const input = /* @__PURE__ */ import_react17.default.createElement(
     MotionInput,
     {
       value,
@@ -1673,7 +1770,7 @@ var Input = import_react16.default.forwardRef((props, ref) => {
         ...innerProps.slotProps
       },
       ...innerProps,
-      endDecorator: isPasswordType ? showPasswordToggle ? /* @__PURE__ */ import_react16.default.createElement(Stack_default, { gap: 1, direction: "row" }, /* @__PURE__ */ import_react16.default.createElement(
+      endDecorator: isPasswordType ? showPasswordToggle ? /* @__PURE__ */ import_react17.default.createElement(Stack_default, { gap: 1, direction: "row" }, /* @__PURE__ */ import_react17.default.createElement(
         IconButton_default,
         {
           onMouseDown: (e) => e.preventDefault(),
@@ -1681,19 +1778,19 @@ var Input = import_react16.default.forwardRef((props, ref) => {
           disabled,
           "aria-label": passwordVisible ? "Hide password" : "Show password"
         },
-        passwordVisible ? /* @__PURE__ */ import_react16.default.createElement(import_VisibilityOff.default, null) : /* @__PURE__ */ import_react16.default.createElement(import_Visibility.default, null)
-      )) : null : enableClearable ? /* @__PURE__ */ import_react16.default.createElement(Stack_default, { gap: 1, direction: "row" }, innerProps.endDecorator, value && /* @__PURE__ */ import_react16.default.createElement(
+        passwordVisible ? /* @__PURE__ */ import_react17.default.createElement(import_VisibilityOff.default, null) : /* @__PURE__ */ import_react17.default.createElement(import_Visibility.default, null)
+      )) : null : enableClearable ? /* @__PURE__ */ import_react17.default.createElement(Stack_default, { gap: 1, direction: "row" }, innerProps.endDecorator, value && /* @__PURE__ */ import_react17.default.createElement(
         IconButton_default,
         {
           onMouseDown: (e) => e.preventDefault(),
           onClick: handleClear,
           "aria-label": "Clear"
         },
-        /* @__PURE__ */ import_react16.default.createElement(import_Close2.default, null)
+        /* @__PURE__ */ import_react17.default.createElement(import_Close2.default, null)
       )) : innerProps.endDecorator
     }
   );
-  return /* @__PURE__ */ import_react16.default.createElement(
+  return /* @__PURE__ */ import_react17.default.createElement(
     FormControl_default,
     {
       required,
@@ -1704,9 +1801,9 @@ var Input = import_react16.default.forwardRef((props, ref) => {
       sx,
       className
     },
-    label && /* @__PURE__ */ import_react16.default.createElement(FormLabel_default, null, label),
+    label && /* @__PURE__ */ import_react17.default.createElement(FormLabel_default, null, label),
     input,
-    helperText && /* @__PURE__ */ import_react16.default.createElement(FormHelperText_default, null, helperText)
+    helperText && /* @__PURE__ */ import_react17.default.createElement(FormHelperText_default, null, helperText)
   );
 });
 Input.displayName = "Input";
@@ -1715,10 +1812,9 @@ Input.displayName = "Input";
 var Input_default = Input;
 
 // src/components/CurrencyInput/CurrencyInput.tsx
-var import_joy23 = require("@mui/joy");
+var import_joy24 = require("@mui/joy");
 
 // src/components/CurrencyInput/hooks/use-currency-setting.ts
-var import_intl_messageformat = __toESM(require("intl-messageformat"));
 var CURRENCY_DECIMAL_MAP = {
   AED: 2,
   ALL: 2,
@@ -1863,9 +1959,10 @@ var CURRENCY_DECIMAL_MAP = {
 };
 var useCurrencySetting = (props) => {
   const { currency = "USD", placeholder } = props;
-  const [symbol, thousandSeparator, decimalSeparator, ...rest] = new import_intl_messageformat.default(
-    `{amount, number, ::currency/${currency} unit-width-narrow}`
-  ).format({ amount: 1e3 }).toString().replace(/\d/g, "").split("");
+  const parts = new Intl.NumberFormat("en-US", { style: "currency", currency }).formatToParts(1000.01);
+  const symbol = parts.find((p) => p.type === "currency")?.value ?? "$";
+  const thousandSeparator = parts.find((p) => p.type === "group")?.value ?? ",";
+  const decimalSeparator = parts.find((p) => p.type === "decimal")?.value;
   const decimalScale = CURRENCY_DECIMAL_MAP[currency];
   return {
     symbol: `${symbol} `,
@@ -1878,9 +1975,9 @@ var useCurrencySetting = (props) => {
 };
 
 // src/components/CurrencyInput/CurrencyInput.tsx
-var TextMaskAdapter = import_react17.default.forwardRef(function TextMaskAdapter2(props, ref) {
+var TextMaskAdapter = import_react18.default.forwardRef(function TextMaskAdapter2(props, ref) {
   const { onChange, ...innerProps } = props;
-  return /* @__PURE__ */ import_react17.default.createElement(
+  return /* @__PURE__ */ import_react18.default.createElement(
     import_react_number_format.NumericFormat,
     {
       ...innerProps,
@@ -1895,13 +1992,13 @@ var TextMaskAdapter = import_react17.default.forwardRef(function TextMaskAdapter
     }
   );
 });
-var CurrencyInputRoot = (0, import_joy23.styled)(Input_default, {
+var CurrencyInputRoot = (0, import_joy24.styled)(Input_default, {
   name: "CurrencyInput",
   slot: "root",
   overridesResolver: (props, styles) => styles.root
 })({});
-var CurrencyInput = import_react17.default.forwardRef(function CurrencyInput2(inProps, ref) {
-  const props = (0, import_joy23.useThemeProps)({ props: inProps, name: "CurrencyInput" });
+var CurrencyInput = import_react18.default.forwardRef(function CurrencyInput2(inProps, ref) {
+  const props = (0, import_joy24.useThemeProps)({ props: inProps, name: "CurrencyInput" });
   const {
     currency = "USD",
     name,
@@ -1921,28 +2018,28 @@ var CurrencyInput = import_react17.default.forwardRef(function CurrencyInput2(in
   const [_value, setValue] = useControlledState(
     props.value,
     props.defaultValue,
-    (0, import_react17.useCallback)((value2) => onChange?.({ target: { name, value: value2 } }), [onChange, name])
+    (0, import_react18.useCallback)((value2) => onChange?.({ target: { name, value: value2 } }), [onChange, name])
   );
-  const value = (0, import_react17.useMemo)(() => {
+  const value = (0, import_react18.useMemo)(() => {
     if (_value && useMinorUnit) {
       return _value / Math.pow(10, decimalScale);
     }
     return _value;
   }, [_value, useMinorUnit, decimalScale]);
-  const max = (0, import_react17.useMemo)(() => {
+  const max = (0, import_react18.useMemo)(() => {
     if (props.max && useMinorUnit) {
       return props.max / Math.pow(10, decimalScale);
     }
     return props.max;
   }, [props.max, useMinorUnit, decimalScale]);
-  const [isOverLimit, setIsOverLimit] = (0, import_react17.useState)(!!max && !!value && value > max);
-  const handleChange = (0, import_react17.useCallback)(
+  const [isOverLimit, setIsOverLimit] = (0, import_react18.useState)(!!max && !!value && value > max);
+  const handleChange = (0, import_react18.useCallback)(
     (event) => {
       if (event.target.value === "") {
         setValue(void 0);
         return;
       }
-      const amount = useMinorUnit ? Number(event.target.value?.replace(decimalSeparator, "")) : Number(event.target.value);
+      const amount = useMinorUnit ? Number(decimalSeparator ? event.target.value?.replace(decimalSeparator, "") : event.target.value) : Number(event.target.value);
       if (!!max && Number(event.target.value) > max) {
         setIsOverLimit(true);
       } else {
@@ -1952,7 +2049,7 @@ var CurrencyInput = import_react17.default.forwardRef(function CurrencyInput2(in
     },
     [decimalSeparator, max, useMinorUnit, setValue]
   );
-  return /* @__PURE__ */ import_react17.default.createElement(
+  return /* @__PURE__ */ import_react18.default.createElement(
     CurrencyInputRoot,
     {
       ...innerProps,
@@ -1965,9 +2062,7 @@ var CurrencyInput = import_react17.default.forwardRef(function CurrencyInput2(in
       required,
       color: error || isOverLimit ? "danger" : props.color,
       label,
-      helperText: isOverLimit ? new import_intl_messageformat2.IntlMessageFormat(`limit: {amount, number, ::currency/${currency} unit-width-narrow}`).format({
-        amount: max
-      }) : helperText,
+      helperText: isOverLimit ? `limit: ${new Intl.NumberFormat("en-US", { style: "currency", currency }).format(max)}` : helperText,
       slotProps: {
         input: {
           component: TextMaskAdapter,
@@ -2039,14 +2134,15 @@ function reorderColumnsByGroupingModel(columns, columnGroupingModel) {
   }
   return reorderedColumns;
 }
-function flattenColumnGroups(items, groupPath = [], columnIndex = { current: 0 }) {
+function flattenColumnGroups(items, groupPath = [], columnIndex = { current: 0 }, visibleFields) {
   const result = [];
   for (const item of items) {
     if ("groupId" in item) {
       const newPath = [...groupPath, item.groupId];
       const children = Array.isArray(item.children) ? item.children : [item.children];
-      result.push(...flattenColumnGroups(children, newPath, columnIndex));
+      result.push(...flattenColumnGroups(children, newPath, columnIndex, visibleFields));
     } else {
+      if (visibleFields && !visibleFields.has(item.field)) continue;
       result.push({
         ...item,
         groupPath,
@@ -2056,9 +2152,9 @@ function flattenColumnGroups(items, groupPath = [], columnIndex = { current: 0 }
   }
   return result;
 }
-function calculateColumnGroups(columnGroupingModel, columns) {
+function calculateColumnGroups(columnGroupingModel, columns, visibleFields) {
   const fieldsInGroupingModel = extractFieldsFromGroupingModel(columnGroupingModel);
-  const flattenedColumns = flattenColumnGroups(columnGroupingModel);
+  const flattenedColumns = flattenColumnGroups(columnGroupingModel, [], { current: 0 }, visibleFields);
   const columnIndexMap = new Map(flattenedColumns.map((col) => [col.field, col.columnIndex]));
   const processedGroups = /* @__PURE__ */ new Map();
   const groupsByLevel = [];
@@ -2106,7 +2202,9 @@ function calculateColumnGroups(columnGroupingModel, columns) {
   groupsByLevel.forEach((level) => {
     level.sort((a, b) => a.startIndex - b.startIndex);
   });
-  return { groups: groupsByLevel, maxLevel, fieldsInGroupingModel };
+  const filteredGroupsByLevel = groupsByLevel.map((level) => level.filter((g) => g.colspan > 0)).filter((level) => level.length > 0);
+  const correctedMaxLevel = filteredGroupsByLevel.length > 0 ? filteredGroupsByLevel.length - 1 : -1;
+  return { groups: filteredGroupsByLevel, maxLevel: correctedMaxLevel, fieldsInGroupingModel };
 }
 function getTextAlign(props) {
   return !props.editMode && ["number", "date", "currency"].includes(props.type || "") ? "end" : "start";
@@ -2114,19 +2212,29 @@ function getTextAlign(props) {
 var numberFormatter = (value) => "Intl" in window ? new Intl.NumberFormat().format(value) : value;
 
 // src/components/DataTable/styled.tsx
-var import_react18 = __toESM(require("react"));
-var import_joy24 = require("@mui/joy");
-var import_framer_motion16 = require("framer-motion");
+var import_react19 = __toESM(require("react"));
+var import_joy25 = require("@mui/joy");
+var import_framer_motion17 = require("framer-motion");
 var import_ArrowUpwardRounded = __toESM(require("@mui/icons-material/ArrowUpwardRounded"));
-var EllipsisDiv = (0, import_joy24.styled)("div", {
+var EllipsisDiv = (0, import_joy25.styled)("div", {
   name: "DataTable",
-  slot: "textEllipsis"
-})({
-  overflow: "hidden",
-  textOverflow: "ellipsis",
-  whiteSpace: "nowrap"
-});
-var OverlayWrapper = (0, import_joy24.styled)("tr", {
+  slot: "textEllipsis",
+  shouldForwardProp: (prop) => prop !== "lineClamp"
+})(
+  ({ lineClamp }) => lineClamp && lineClamp > 1 ? {
+    overflow: "hidden",
+    display: "-webkit-box !important",
+    WebkitBoxOrient: "vertical",
+    WebkitLineClamp: lineClamp,
+    whiteSpace: "normal",
+    overflowWrap: "anywhere"
+  } : {
+    overflow: "hidden",
+    textOverflow: "ellipsis",
+    whiteSpace: "nowrap"
+  }
+);
+var OverlayWrapper = (0, import_joy25.styled)("tr", {
   name: "DataTable",
   slot: "overlayWrapper"
 })({
@@ -2141,7 +2249,7 @@ var OverlayWrapper = (0, import_joy24.styled)("tr", {
     border: "none !important"
   }
 });
-var VirtualizedTableBody = (0, import_joy24.styled)("tbody", {
+var VirtualizedTableBody = (0, import_joy25.styled)("tbody", {
   name: "DataTable",
   slot: "tableBody"
 })({
@@ -2150,21 +2258,21 @@ var VirtualizedTableBody = (0, import_joy24.styled)("tbody", {
     display: "block",
     height: "0.01em"
   },
-  [`& .${import_joy24.buttonClasses.root}`]: {
+  [`& .${import_joy25.buttonClasses.root}`]: {
     "--Button-minHeight": "26px",
     "--Button-paddingBlock": "0.25rem",
     lineHeight: 1,
     marginTop: "-2px",
     marginBottom: "-2px"
   },
-  [`& .${import_joy24.iconButtonClasses.root}`]: {
+  [`& .${import_joy25.iconButtonClasses.root}`]: {
     "--IconButton-size": "26px",
     verticalAlign: "middle",
     marginTop: "-2px",
     marginBottom: "-2px"
   }
 });
-var StyledTableRow = (0, import_joy24.styled)("tr", {
+var StyledTableRow = (0, import_joy25.styled)("tr", {
   name: "DataTable",
   slot: "tableRow",
   shouldForwardProp: (prop) => prop !== "striped"
@@ -2183,17 +2291,17 @@ var StyledTableRow = (0, import_joy24.styled)("tr", {
     }
   }
 }));
-var Asterisk = (0, import_joy24.styled)("span", {
+var Asterisk = (0, import_joy25.styled)("span", {
   name: "DataTable",
   slot: "headCellAsterisk"
 })(({ theme }) => ({
   color: "var(--ceed-palette-danger-500)",
   marginLeft: theme.spacing(0.5)
 }));
-var StyledTh = (0, import_joy24.styled)(import_framer_motion16.motion.th)(({ theme }) => ({
+var StyledTh = (0, import_joy25.styled)(import_framer_motion17.motion.th)(({ theme }) => ({
   boxShadow: "1px 0 var(--TableCell-borderColor)"
 }));
-var StyledTd = (0, import_joy24.styled)("td")(({ theme }) => ({
+var StyledTd = (0, import_joy25.styled)("td")(({ theme }) => ({
   transition: `box-shadow 0.3s`,
   "&:not(.is-last-left):not(.is-last-right)": {
     boxShadow: "1px 0 var(--TableCell-borderColor)"
@@ -2209,9 +2317,9 @@ var StyledTd = (0, import_joy24.styled)("td")(({ theme }) => ({
     }
   }
 }));
-var MotionSortIcon = (0, import_framer_motion16.motion)(import_ArrowUpwardRounded.default);
-var DefaultLoadingOverlay = () => /* @__PURE__ */ import_react18.default.createElement(import_joy24.LinearProgress, { value: 8, variant: "plain" });
-var Resizer = (ref, targetRef = ref) => /* @__PURE__ */ import_react18.default.createElement(
+var MotionSortIcon = (0, import_framer_motion17.motion)(import_ArrowUpwardRounded.default);
+var DefaultLoadingOverlay = () => /* @__PURE__ */ import_react19.default.createElement(import_joy25.LinearProgress, { value: 8, variant: "plain" });
+var Resizer = (ref, targetRef = ref) => /* @__PURE__ */ import_react19.default.createElement(
   Box_default,
   {
     sx: {
@@ -2248,24 +2356,24 @@ var import_joy32 = require("@mui/joy");
 var import_framer_motion21 = require("framer-motion");
 
 // src/components/DatePicker/DatePicker.tsx
-var import_react19 = __toESM(require("react"));
+var import_react20 = __toESM(require("react"));
 var import_react_imask = require("react-imask");
 var import_CalendarToday = __toESM(require("@mui/icons-material/CalendarToday"));
-var import_joy27 = require("@mui/joy");
+var import_joy28 = require("@mui/joy");
 var import_base3 = require("@mui/base");
 
 // src/components/Sheet/Sheet.tsx
-var import_joy25 = require("@mui/joy");
-var Sheet = import_joy25.Sheet;
+var import_joy26 = require("@mui/joy");
+var Sheet = import_joy26.Sheet;
 
 // src/components/Sheet/index.ts
 var Sheet_default = Sheet;
 
 // src/components/DialogActions/DialogActions.tsx
-var import_joy26 = require("@mui/joy");
-var import_framer_motion17 = require("framer-motion");
-var MotionDialogActions = (0, import_framer_motion17.motion)(import_joy26.DialogActions);
-var StyledDialogActions = (0, import_joy26.styled)(MotionDialogActions)(({ theme }) => ({
+var import_joy27 = require("@mui/joy");
+var import_framer_motion18 = require("framer-motion");
+var MotionDialogActions = (0, import_framer_motion18.motion)(import_joy27.DialogActions);
+var StyledDialogActions = (0, import_joy27.styled)(MotionDialogActions)(({ theme }) => ({
   padding: theme.spacing(2),
   gap: theme.spacing(2),
   flexDirection: "row",
@@ -2278,7 +2386,7 @@ DialogActions.displayName = "DialogActions";
 var DialogActions_default = DialogActions;
 
 // src/components/DatePicker/DatePicker.tsx
-var CalendarButton = (0, import_joy27.styled)(IconButton_default, {
+var CalendarButton = (0, import_joy28.styled)(IconButton_default, {
   name: "DatePicker",
   slot: "calendarButton"
 })(({ theme }) => ({
@@ -2288,13 +2396,13 @@ var CalendarButton = (0, import_joy27.styled)(IconButton_default, {
     outline: `${theme.getCssVar("focus-thickness")} solid ${theme.getCssVar("palette-focusVisible")}`
   }
 }));
-var StyledPopper = (0, import_joy27.styled)(import_base3.Popper, {
+var StyledPopper = (0, import_joy28.styled)(import_base3.Popper, {
   name: "DatePicker",
   slot: "popper"
 })(({ theme }) => ({
   zIndex: theme.zIndex.tooltip
 }));
-var CalendarSheet = (0, import_joy27.styled)(Sheet_default, {
+var CalendarSheet = (0, import_joy28.styled)(Sheet_default, {
   name: "DatePicker",
   slot: "sheet",
   overridesResolver: (props, styles) => styles.root
@@ -2303,7 +2411,7 @@ var CalendarSheet = (0, import_joy27.styled)(Sheet_default, {
   boxShadow: theme.shadow.md,
   borderRadius: theme.radius.md
 }));
-var DatePickerRoot = (0, import_joy27.styled)("div", {
+var DatePickerRoot = (0, import_joy28.styled)("div", {
   name: "DatePicker",
   slot: "root",
   overridesResolver: (props, styles) => styles.root
@@ -2360,9 +2468,9 @@ function parseDate(dateString, format) {
 var formatToPattern = (format) => {
   return format.replace(/YYYY/g, "Y").replace(/MM/g, "M").replace(/DD/g, "D").replace(/[^YMD\s]/g, (match) => `${match}\``);
 };
-var TextMaskAdapter3 = import_react19.default.forwardRef(function TextMaskAdapter4(props, ref) {
+var TextMaskAdapter3 = import_react20.default.forwardRef(function TextMaskAdapter4(props, ref) {
   const { onChange, format, ...other } = props;
-  return /* @__PURE__ */ import_react19.default.createElement(
+  return /* @__PURE__ */ import_react20.default.createElement(
     import_react_imask.IMaskInput,
     {
       ...other,
@@ -2397,8 +2505,8 @@ var TextMaskAdapter3 = import_react19.default.forwardRef(function TextMaskAdapte
     }
   );
 });
-var DatePicker = (0, import_react19.forwardRef)((inProps, ref) => {
-  const props = (0, import_joy27.useThemeProps)({ props: inProps, name: "DatePicker" });
+var DatePicker = (0, import_react20.forwardRef)((inProps, ref) => {
+  const props = (0, import_joy28.useThemeProps)({ props: inProps, name: "DatePicker" });
   const {
     onChange,
     disabled,
@@ -2422,24 +2530,24 @@ var DatePicker = (0, import_react19.forwardRef)((inProps, ref) => {
     shouldDisableDate,
     ...innerProps
   } = props;
-  const innerRef = (0, import_react19.useRef)(null);
-  const buttonRef = (0, import_react19.useRef)(null);
+  const innerRef = (0, import_react20.useRef)(null);
+  const buttonRef = (0, import_react20.useRef)(null);
   const [value, setValue] = useControlledState(
     props.value,
     props.defaultValue || "",
-    (0, import_react19.useCallback)((value2) => onChange?.({ target: { name: props.name, value: value2 } }), [props.name, onChange])
+    (0, import_react20.useCallback)((value2) => onChange?.({ target: { name: props.name, value: value2 } }), [props.name, onChange])
   );
-  const [displayValue, setDisplayValue] = (0, import_react19.useState)(
+  const [displayValue, setDisplayValue] = (0, import_react20.useState)(
     () => value ? formatValueString(parseDate(value, format), displayFormat) : ""
   );
-  const [anchorEl, setAnchorEl] = (0, import_react19.useState)(null);
+  const [anchorEl, setAnchorEl] = (0, import_react20.useState)(null);
   const open = Boolean(anchorEl);
-  (0, import_react19.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     if (!anchorEl) {
       innerRef.current?.blur();
     }
   }, [anchorEl, innerRef]);
-  (0, import_react19.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     if (value === "") {
       setDisplayValue("");
       return;
@@ -2449,8 +2557,8 @@ var DatePicker = (0, import_react19.forwardRef)((inProps, ref) => {
       setDisplayValue(formattedValue);
     }
   }, [displayFormat, displayValue, format, value]);
-  (0, import_react19.useImperativeHandle)(ref, () => innerRef.current, [innerRef]);
-  const handleChange = (0, import_react19.useCallback)(
+  (0, import_react20.useImperativeHandle)(ref, () => innerRef.current, [innerRef]);
+  const handleChange = (0, import_react20.useCallback)(
     (event) => {
       const value2 = event.target.value;
       setDisplayValue(value2 ? formatValueString(parseDate(value2, format), displayFormat) : value2);
@@ -2458,7 +2566,7 @@ var DatePicker = (0, import_react19.forwardRef)((inProps, ref) => {
     },
     [displayFormat, format, setValue]
   );
-  const handleDisplayInputChange = (0, import_react19.useCallback)(
+  const handleDisplayInputChange = (0, import_react20.useCallback)(
     (event) => {
       if (event.target.value === "") {
         handleChange({
@@ -2483,7 +2591,7 @@ var DatePicker = (0, import_react19.forwardRef)((inProps, ref) => {
     },
     [displayFormat, format, handleChange, props.name]
   );
-  const handleCalendarToggle = (0, import_react19.useCallback)(
+  const handleCalendarToggle = (0, import_react20.useCallback)(
     (event) => {
       setAnchorEl(anchorEl ? null : event.currentTarget);
       setTimeout(() => {
@@ -2492,7 +2600,7 @@ var DatePicker = (0, import_react19.forwardRef)((inProps, ref) => {
     },
     [anchorEl, setAnchorEl, innerRef]
   );
-  const handleInputMouseDown = (0, import_react19.useCallback)(
+  const handleInputMouseDown = (0, import_react20.useCallback)(
     (event) => {
       if (inputReadOnly) {
         event.preventDefault();
@@ -2501,7 +2609,7 @@ var DatePicker = (0, import_react19.forwardRef)((inProps, ref) => {
     },
     [inputReadOnly, buttonRef]
   );
-  return /* @__PURE__ */ import_react19.default.createElement(DatePickerRoot, null, /* @__PURE__ */ import_react19.default.createElement(import_base3.FocusTrap, { open: true }, /* @__PURE__ */ import_react19.default.createElement(import_react19.default.Fragment, null, /* @__PURE__ */ import_react19.default.createElement(
+  return /* @__PURE__ */ import_react20.default.createElement(DatePickerRoot, null, /* @__PURE__ */ import_react20.default.createElement(import_base3.FocusTrap, { open: true }, /* @__PURE__ */ import_react20.default.createElement(import_react20.default.Fragment, null, /* @__PURE__ */ import_react20.default.createElement(
     Input_default,
     {
       ...innerProps,
@@ -2529,7 +2637,7 @@ var DatePicker = (0, import_react19.forwardRef)((inProps, ref) => {
       },
       className,
       sx,
-      endDecorator: /* @__PURE__ */ import_react19.default.createElement(
+      endDecorator: /* @__PURE__ */ import_react20.default.createElement(
         CalendarButton,
         {
           ref: buttonRef,
@@ -2541,13 +2649,13 @@ var DatePicker = (0, import_react19.forwardRef)((inProps, ref) => {
           "aria-expanded": open,
           disabled
         },
-        /* @__PURE__ */ import_react19.default.createElement(import_CalendarToday.default, null)
+        /* @__PURE__ */ import_react20.default.createElement(import_CalendarToday.default, null)
       ),
       label,
       helperText,
       readOnly: readOnly || inputReadOnly
     }
-  ), open && /* @__PURE__ */ import_react19.default.createElement(import_base3.ClickAwayListener, { onClickAway: () => setAnchorEl(null) }, /* @__PURE__ */ import_react19.default.createElement(
+  ), open && /* @__PURE__ */ import_react20.default.createElement(import_base3.ClickAwayListener, { onClickAway: () => setAnchorEl(null) }, /* @__PURE__ */ import_react20.default.createElement(
     StyledPopper,
     {
       id: "date-picker-popper",
@@ -2566,7 +2674,7 @@ var DatePicker = (0, import_react19.forwardRef)((inProps, ref) => {
       "aria-label": "Calendar Tooltip",
       "aria-expanded": open
     },
-    /* @__PURE__ */ import_react19.default.createElement(CalendarSheet, { tabIndex: -1, role: "presentation" }, /* @__PURE__ */ import_react19.default.createElement(
+    /* @__PURE__ */ import_react20.default.createElement(CalendarSheet, { tabIndex: -1, role: "presentation" }, /* @__PURE__ */ import_react20.default.createElement(
       Calendar_default,
       {
         value: value && !Number.isNaN(parseDate(value, format).getTime()) ? [parseDate(value, format), void 0] : void 0,
@@ -2585,14 +2693,14 @@ var DatePicker = (0, import_react19.forwardRef)((inProps, ref) => {
         disablePast,
         shouldDisableDate: shouldDisableDate ? (date) => shouldDisableDate(formatValueString(date, format)) : void 0
       }
-    ), !hideClearButton && /* @__PURE__ */ import_react19.default.createElement(
+    ), !hideClearButton && /* @__PURE__ */ import_react20.default.createElement(
       DialogActions_default,
       {
         sx: {
           p: 1
         }
       },
-      /* @__PURE__ */ import_react19.default.createElement(
+      /* @__PURE__ */ import_react20.default.createElement(
         Button_default,
         {
           size,
@@ -2618,10 +2726,10 @@ var DatePicker = (0, import_react19.forwardRef)((inProps, ref) => {
 var DatePicker_default = DatePicker;
 
 // src/components/Textarea/Textarea.tsx
-var import_react20 = __toESM(require("react"));
-var import_joy28 = require("@mui/joy");
-var import_framer_motion18 = require("framer-motion");
-var MotionTextarea = (0, import_framer_motion18.motion)(import_joy28.Textarea);
+var import_react21 = __toESM(require("react"));
+var import_joy29 = require("@mui/joy");
+var import_framer_motion19 = require("framer-motion");
+var MotionTextarea = (0, import_framer_motion19.motion)(import_joy29.Textarea);
 var Textarea = (props) => {
   const {
     label,
@@ -2638,7 +2746,7 @@ var Textarea = (props) => {
     className,
     ...innerProps
   } = props;
-  const textarea = /* @__PURE__ */ import_react20.default.createElement(
+  const textarea = /* @__PURE__ */ import_react21.default.createElement(
     MotionTextarea,
     {
       required,
@@ -2650,7 +2758,7 @@ var Textarea = (props) => {
       ...innerProps
     }
   );
-  return /* @__PURE__ */ import_react20.default.createElement(
+  return /* @__PURE__ */ import_react21.default.createElement(
     FormControl_default,
     {
       required,
@@ -2661,9 +2769,9 @@ var Textarea = (props) => {
       sx,
       className
     },
-    label && /* @__PURE__ */ import_react20.default.createElement(FormLabel_default, null, label),
+    label && /* @__PURE__ */ import_react21.default.createElement(FormLabel_default, null, label),
     textarea,
-    helperText && /* @__PURE__ */ import_react20.default.createElement(FormHelperText_default, null, helperText)
+    helperText && /* @__PURE__ */ import_react21.default.createElement(FormHelperText_default, null, helperText)
   );
 };
 Textarea.displayName = "Textarea";
@@ -2672,10 +2780,10 @@ Textarea.displayName = "Textarea";
 var Textarea_default = Textarea;
 
 // src/components/Select/Select.tsx
-var import_react21 = __toESM(require("react"));
-var import_joy29 = require("@mui/joy");
-var import_framer_motion19 = require("framer-motion");
-var MotionOption = (0, import_framer_motion19.motion)(import_joy29.Option);
+var import_react22 = __toESM(require("react"));
+var import_joy30 = require("@mui/joy");
+var import_framer_motion20 = require("framer-motion");
+var MotionOption = (0, import_framer_motion20.motion)(import_joy30.Option);
 var Option = MotionOption;
 var secondaryTextLevelMap2 = {
   sm: "body-xs",
@@ -2698,7 +2806,7 @@ function Select(props) {
     className,
     ...innerProps
   } = props;
-  const options = (0, import_react21.useMemo)(
+  const options = (0, import_react22.useMemo)(
     () => props.options.map((option) => {
       if (option.hasOwnProperty("value") && option.hasOwnProperty("label")) {
         return option;
@@ -2723,15 +2831,15 @@ function Select(props) {
     };
     onChange?.(newEvent, newValue);
   };
-  const optionMap = (0, import_react21.useMemo)(() => {
+  const optionMap = (0, import_react22.useMemo)(() => {
     const map = /* @__PURE__ */ new Map();
     options.forEach((option) => {
       map.set(option.value, option);
     });
     return map;
   }, [options]);
-  const select = /* @__PURE__ */ import_react21.default.createElement(
-    import_joy29.Select,
+  const select = /* @__PURE__ */ import_react22.default.createElement(
+    import_joy30.Select,
     {
       ...innerProps,
       required,
@@ -2747,9 +2855,9 @@ function Select(props) {
         return optionMap.get(selected.value)?.label;
       }
     },
-    options.map((option) => /* @__PURE__ */ import_react21.default.createElement(Option, { key: option.value, value: option.value, disabled: option.disabled }, option.secondaryText ? /* @__PURE__ */ import_react21.default.createElement(import_joy29.ListItemContent, { sx: { gap: 0.5 } }, /* @__PURE__ */ import_react21.default.createElement(import_joy29.Typography, { level: "inherit" }, option.label), /* @__PURE__ */ import_react21.default.createElement(import_joy29.Typography, { level: secondaryTextLevelMap2[size ?? "md"], textColor: "text.tertiary" }, option.secondaryText)) : option.label))
+    options.map((option) => /* @__PURE__ */ import_react22.default.createElement(Option, { key: option.value, value: option.value, disabled: option.disabled }, option.secondaryText ? /* @__PURE__ */ import_react22.default.createElement(import_joy30.ListItemContent, { sx: { gap: 0.5 } }, /* @__PURE__ */ import_react22.default.createElement(import_joy30.Typography, { level: "inherit" }, option.label), /* @__PURE__ */ import_react22.default.createElement(import_joy30.Typography, { level: secondaryTextLevelMap2[size ?? "md"], textColor: "text.tertiary" }, option.secondaryText)) : option.label))
   );
-  return /* @__PURE__ */ import_react21.default.createElement(
+  return /* @__PURE__ */ import_react22.default.createElement(
     FormControl_default,
     {
       required,
@@ -2760,9 +2868,9 @@ function Select(props) {
       sx,
       className
     },
-    label && /* @__PURE__ */ import_react21.default.createElement(FormLabel_default, null, label),
+    label && /* @__PURE__ */ import_react22.default.createElement(FormLabel_default, null, label),
     select,
-    helperText && /* @__PURE__ */ import_react21.default.createElement(FormHelperText_default, null, helperText)
+    helperText && /* @__PURE__ */ import_react22.default.createElement(FormHelperText_default, null, helperText)
   );
 }
 Select.displayName = "Select";
@@ -2773,19 +2881,6 @@ var Select_default = Select;
 // src/components/DataTable/components.tsx
 var import_joy33 = require("@mui/joy");
 
-// src/components/Tooltip/Tooltip.tsx
-var import_react22 = __toESM(require("react"));
-var import_joy30 = require("@mui/joy");
-var import_framer_motion20 = require("framer-motion");
-var MotionTooltip = (0, import_framer_motion20.motion)(import_joy30.Tooltip);
-var Tooltip = (props) => {
-  return /* @__PURE__ */ import_react22.default.createElement(MotionTooltip, { ...props });
-};
-Tooltip.displayName = "Tooltip";
-
-// src/components/Tooltip/index.ts
-var Tooltip_default = Tooltip;
-
 // src/components/InfoSign/InfoSign.tsx
 var import_react23 = __toESM(require("react"));
 var import_joy31 = require("@mui/joy");
@@ -2820,21 +2915,22 @@ function InfoSign(props) {
 var InfoSign_default = InfoSign;
 
 // src/components/DataTable/components.tsx
-var TextEllipsis = ({ children }) => {
+var TextEllipsis = ({ children, lineClamp }) => {
   const textRef = (0, import_react24.useRef)(null);
   const [showTooltip, setShowTooltip] = (0, import_react24.useState)(false);
   (0, import_react24.useLayoutEffect)(() => {
     const element = textRef.current;
-    if (element) {
-      const isTextTruncated = element.scrollWidth > element.clientWidth;
-      setShowTooltip(isTextTruncated);
-    }
-  }, [children]);
-  const content = /* @__PURE__ */ import_react24.default.createElement(EllipsisDiv, { ref: textRef }, children);
-  if (showTooltip) {
-    return /* @__PURE__ */ import_react24.default.createElement(Tooltip_default, { title: children, placement: "top", onClick: (e) => e.stopPropagation() }, content);
-  }
-  return content;
+    if (!element) return;
+    const checkTruncation = () => {
+      const isTruncated = lineClamp && lineClamp > 1 ? element.scrollHeight > element.clientHeight + 1 : element.scrollWidth > element.clientWidth;
+      setShowTooltip(isTruncated);
+    };
+    checkTruncation();
+    const ro = new ResizeObserver(checkTruncation);
+    ro.observe(element);
+    return () => ro.disconnect();
+  }, [children, lineClamp]);
+  return /* @__PURE__ */ import_react24.default.createElement(Tooltip_default, { title: showTooltip ? children : "", placement: "top", onClick: (e) => e.stopPropagation() }, /* @__PURE__ */ import_react24.default.createElement(EllipsisDiv, { ref: textRef, lineClamp }, children));
 };
 var CellTextEllipsis = ({ children }) => {
   const textRef = (0, import_react24.useRef)(null);
@@ -2885,7 +2981,8 @@ var HeadCell = (props) => {
     pinnedEndPosition,
     headerRef,
     tableColRef,
-    headerClassName
+    headerClassName,
+    headerLineClamp
   } = props;
   const theme = (0, import_joy32.useTheme)();
   const ref = headerRef;
@@ -2979,7 +3076,7 @@ var HeadCell = (props) => {
       initial: "initial",
       className: computedHeaderClassName
     },
-    /* @__PURE__ */ import_react24.default.createElement(Stack_default, { gap: 1, direction: "row", justifyContent: textAlign, alignItems: "center" }, textAlign === "end" && sortIcon, textAlign === "end" && infoSign, /* @__PURE__ */ import_react24.default.createElement(TextEllipsis, null, headerName ?? field, editMode && required && /* @__PURE__ */ import_react24.default.createElement(Asterisk, null, "*")), textAlign === "start" && infoSign, textAlign === "start" && sortIcon),
+    /* @__PURE__ */ import_react24.default.createElement(Stack_default, { gap: 1, direction: "row", justifyContent: textAlign, alignItems: "center", sx: { minWidth: 0 } }, textAlign === "end" && sortIcon, textAlign === "end" && infoSign, /* @__PURE__ */ import_react24.default.createElement(TextEllipsis, { lineClamp: headerLineClamp }, headerName ?? field, editMode && required && /* @__PURE__ */ import_react24.default.createElement(Asterisk, null, "*")), textAlign === "start" && infoSign, textAlign === "start" && sortIcon),
     resizer
   );
 };
@@ -3271,7 +3368,9 @@ function useDataTableRenderer({
   getId: _getId,
   isTotalSelected: _isTotalSelected,
   isRowSelectable,
-  columnGroupingModel
+  columnGroupingModel,
+  columnVisibilityModel,
+  onColumnVisibilityModelChange
 }) {
   if (pinnedColumns && columnGroupingModel) {
     throw new Error(
@@ -3287,12 +3386,35 @@ function useDataTableRenderer({
     initialState?.sorting?.sortModel ?? [],
     (0, import_react25.useCallback)((sortModel2) => onSortModelChange?.(sortModel2), [onSortModelChange])
   );
+  const [visibilityModel] = useControlledState(
+    columnVisibilityModel,
+    initialState?.columns?.columnVisibilityModel ?? {},
+    (0, import_react25.useCallback)(
+      (model) => onColumnVisibilityModelChange?.(model),
+      [onColumnVisibilityModelChange]
+    )
+  );
   const reorderedColumns = (0, import_react25.useMemo)(() => {
     if (!columnGroupingModel) return columnsProp;
     return reorderColumnsByGroupingModel(columnsProp, columnGroupingModel);
   }, [columnsProp, columnGroupingModel]);
-  const columnsByField = (0, import_react25.useMemo)(
+  const visibleColumns = (0, import_react25.useMemo)(
+    () => reorderedColumns.filter((col) => visibilityModel[col.field] !== false),
+    [reorderedColumns, visibilityModel]
+  );
+  const visibleFieldSet = (0, import_react25.useMemo)(() => new Set(visibleColumns.map((c) => c.field)), [visibleColumns]);
+  const allColumnsByField = (0, import_react25.useMemo)(
     () => reorderedColumns.reduce(
+      (acc, curr) => ({
+        ...acc,
+        [curr.field]: curr
+      }),
+      {}
+    ),
+    [reorderedColumns]
+  );
+  const visibleColumnsByField = (0, import_react25.useMemo)(
+    () => visibleColumns.reduce(
       (acc, curr) => ({
         ...acc,
         [curr.field]: {
@@ -3303,7 +3425,7 @@ function useDataTableRenderer({
       }),
       {}
     ),
-    [reorderedColumns]
+    [visibleColumns]
   );
   const sortComparator = (0, import_react25.useCallback)(
     (rowA, rowB) => {
@@ -3311,7 +3433,8 @@ function useDataTableRenderer({
         const { field, sort: direction } = sort;
         const a = rowA[field];
         const b = rowB[field];
-        const column = columnsByField[field];
+        const column = allColumnsByField[field];
+        if (!column) continue;
         let comparison = 0;
         if (column.sortComparator) {
           comparison = column.sortComparator({
@@ -3331,7 +3454,7 @@ function useDataTableRenderer({
       }
       return 0;
     },
-    [sortModel, columnsByField]
+    [sortModel, allColumnsByField]
   );
   const rows = (0, import_react25.useMemo)(
     () => sortModel.length ? [..._rows].sort(sortComparator) : _rows,
@@ -3395,44 +3518,54 @@ function useDataTableRenderer({
     () => _isTotalSelected ?? (selectableRowCount > 0 && (selectionModel?.length || 0) === selectableRowCount),
     [_isTotalSelected, selectionModel, selectableRowCount]
   );
-  const columnWidths = useColumnWidths(columnsByField);
+  const columnWidths = useColumnWidths(visibleColumnsByField);
   const getWidth = (0, import_react25.useCallback)(
-    (f) => columnWidths[f] ?? columnsByField[f].width ?? // Column prop 으로 지정된 width
-    columnsByField[f].minWidth ?? 0,
-    [columnWidths, columnsByField]
+    (f) => columnWidths[f] ?? allColumnsByField[f]?.width ?? // Column prop 으로 지정된 width
+    allColumnsByField[f]?.minWidth ?? 0,
+    [columnWidths, allColumnsByField]
   );
   const processedColumnGroups = (0, import_react25.useMemo)(() => {
     if (!columnGroupingModel) return null;
-    return calculateColumnGroups(columnGroupingModel, reorderedColumns);
-  }, [columnGroupingModel, reorderedColumns]);
+    return calculateColumnGroups(columnGroupingModel, visibleColumns, visibleFieldSet);
+  }, [columnGroupingModel, visibleColumns, visibleFieldSet]);
+  const effectivePinnedLeft = (0, import_react25.useMemo)(
+    () => pinnedColumns?.left?.filter((f) => visibleFieldSet.has(f)),
+    [pinnedColumns?.left, visibleFieldSet]
+  );
+  const effectivePinnedRight = (0, import_react25.useMemo)(
+    () => pinnedColumns?.right?.filter((f) => visibleFieldSet.has(f)),
+    [pinnedColumns?.right, visibleFieldSet]
+  );
   const columns = (0, import_react25.useMemo)(() => {
-    const baseColumns = reorderedColumns.length > 0 ? reorderedColumns : Object.keys(rows[0] || {}).map((key) => ({
+    const baseColumns = visibleColumns.length > 0 ? visibleColumns : reorderedColumns.length > 0 ? [] : Object.keys(rows[0] || {}).map((key) => ({
       field: key
     }));
     return baseColumns.map((column) => {
-      const isLeftPinned = pinnedColumns?.left?.includes(column.field);
-      const isRightPinned = pinnedColumns?.right?.includes(column.field);
+      const isLeftPinned = effectivePinnedLeft?.includes(column.field);
+      const isRightPinned = effectivePinnedRight?.includes(column.field);
       const isPinned = isLeftPinned || isRightPinned;
       return {
         ...column,
-        headerRef: columnsByField[column.field].headerRef,
-        tableColRef: columnsByField[column.field].tableColRef,
+        headerRef: visibleColumnsByField[column.field]?.headerRef,
+        tableColRef: visibleColumnsByField[column.field]?.tableColRef,
         isCellEditable: editMode && (typeof column.isCellEditable === "function" ? column.isCellEditable : column.isCellEditable ?? true),
         sort: sortModel.find((sort) => sort.field === column.field)?.sort,
-        sortOrder: columnsByField[column.field]?.sortOrder || sortOrder,
+        sortOrder: allColumnsByField[column.field]?.sortOrder || sortOrder,
         isPinned,
-        isLastStartPinnedColumn: isLeftPinned && [...pinnedColumns?.left || []].pop() === column.field,
-        isLastEndPinnedColumn: isRightPinned && (pinnedColumns?.right?.[0] ?? null) === column.field,
-        pinnedStartPosition: pinnedColumns?.left?.slice(0, isLeftPinned ? pinnedColumns.left.indexOf(column.field) : pinnedColumns.left.length).reduce((acc, curr) => acc + getWidth(curr), 0),
-        pinnedEndPosition: pinnedColumns?.right?.slice(isRightPinned ? pinnedColumns.right.indexOf(column.field) + 1 : 0).reduce((acc, curr) => acc + getWidth(curr), 0)
+        isLastStartPinnedColumn: isLeftPinned && [...effectivePinnedLeft || []].pop() === column.field,
+        isLastEndPinnedColumn: isRightPinned && (effectivePinnedRight?.[0] ?? null) === column.field,
+        pinnedStartPosition: effectivePinnedLeft?.slice(0, isLeftPinned ? effectivePinnedLeft.indexOf(column.field) : effectivePinnedLeft.length).reduce((acc, curr) => acc + getWidth(curr), 0),
+        pinnedEndPosition: effectivePinnedRight?.slice(isRightPinned ? effectivePinnedRight.indexOf(column.field) + 1 : 0).reduce((acc, curr) => acc + getWidth(curr), 0)
       };
     });
   }, [
+    visibleColumns,
     reorderedColumns,
     rows,
-    pinnedColumns?.left,
-    pinnedColumns?.right,
-    columnsByField,
+    effectivePinnedLeft,
+    effectivePinnedRight,
+    visibleColumnsByField,
+    allColumnsByField,
     editMode,
     sortModel,
     sortOrder,
@@ -3448,8 +3581,8 @@ function useDataTableRenderer({
   const handleSortChange = (0, import_react25.useCallback)(
     (props) => {
       const { field, currentSort, multiple } = props;
-      const column = columnsByField[field];
-      const columnSortOrder = column.sortOrder || sortOrder;
+      const column = allColumnsByField[field];
+      const columnSortOrder = column?.sortOrder || sortOrder;
       if (currentSort !== void 0) {
         const currentOrderIndex = columnSortOrder.indexOf(currentSort);
         const nextSortOrderIndex = (currentOrderIndex + 1) % columnSortOrder.length;
@@ -3466,7 +3599,7 @@ function useDataTableRenderer({
         setSortModel(newSortModel);
       }
     },
-    [sortOrder, columnsByField, sortModel, setSortModel]
+    [sortOrder, allColumnsByField, sortModel, setSortModel]
   );
   (0, import_react25.useEffect)(() => {
     if (!paginationModel) {
@@ -3892,6 +4025,10 @@ function Component(props, apiRef) {
     loading,
     columnGroupingModel: _________________,
     // columnGroupingModel is used in useDataTableRenderer
+    columnVisibilityModel: __________________,
+    // columnVisibilityModel is used in useDataTableRenderer
+    onColumnVisibilityModelChange: ___________________,
+    // onColumnVisibilityModelChange is used in useDataTableRenderer
     slots: {
       checkbox: RenderCheckbox = Checkbox_default,
       toolbar: Toolbar,
@@ -4131,7 +4268,7 @@ function Component(props, apiRef) {
             width: c.width
           }
         }
-      ))), /* @__PURE__ */ import_react28.default.createElement("thead", null, processedColumnGroups && processedColumnGroups.groups.map((levelGroups, level) => /* @__PURE__ */ import_react28.default.createElement("tr", { key: `group-level-${level}` }, checkboxSelection && level === 0 && /* @__PURE__ */ import_react28.default.createElement(
+      ))), /* @__PURE__ */ import_react28.default.createElement("thead", null, processedColumnGroups && processedColumnGroups.groups.length > 0 && processedColumnGroups.groups.map((levelGroups, level) => /* @__PURE__ */ import_react28.default.createElement("tr", { key: `group-level-${level}` }, checkboxSelection && level === 0 && /* @__PURE__ */ import_react28.default.createElement(
         "th",
         {
           rowSpan: processedColumnGroups.maxLevel + 2,
@@ -4151,7 +4288,7 @@ function Component(props, apiRef) {
             ...checkboxProps
           }
         )
-      ), level > 0 && Array.from({ length: levelGroups[0]?.startIndex || 0 }).map((_2, i) => /* @__PURE__ */ import_react28.default.createElement("th", { key: `empty-${level}-${i}` })), levelGroups.map((group, groupIndex) => {
+      ), level > 0 && Array.from({ length: levelGroups[0]?.startIndex || 0 }).map((_2, i) => /* @__PURE__ */ import_react28.default.createElement("th", { key: `empty-${level}-${i}` })), levelGroups.filter((g) => g.colspan > 0).map((group, groupIndex) => {
         const nextGroup = levelGroups[groupIndex + 1];
         const emptyCells = nextGroup ? nextGroup.startIndex - (group.startIndex + group.colspan) : columns.length - (group.startIndex + group.colspan);
         const params = { groupId: group.groupId };
@@ -4169,7 +4306,7 @@ function Component(props, apiRef) {
           },
           group.headerName ?? group.groupId
         ), emptyCells > 0 && Array.from({ length: emptyCells }).map((_2, i) => /* @__PURE__ */ import_react28.default.createElement("th", { key: `empty-between-${level}-${groupIndex}-${i}`, colSpan: 1 })));
-      }))), /* @__PURE__ */ import_react28.default.createElement("tr", null, !processedColumnGroups && checkboxSelection && /* @__PURE__ */ import_react28.default.createElement(
+      }))), /* @__PURE__ */ import_react28.default.createElement("tr", null, (!processedColumnGroups || processedColumnGroups.groups.length === 0) && checkboxSelection && /* @__PURE__ */ import_react28.default.createElement(
         "th",
         {
           style: {