@dextinity/admin 2.0.0-canary-20260729062014

package/lib/dataGrid/useDataGridUrlState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataGridUrlState.d.ts","sourceRoot":"","sources":["../../src/dataGrid/useDataGridUrlState.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAuB,iBAAiB,EAAiB,MAAM,kBAAkB,CAAC;AAO9H,KAAK,8BAA8B,GAAG;IAClC,WAAW,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC1C,mBAAmB,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAE1D,eAAe,EAAE,WAAW,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC/D,uBAAuB,EAAE,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAElE,SAAS,EAAE,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;IACnD,iBAAiB,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;CACzD,CAAC;AAEF;;IAEI;AACJ,wBAAgB,mBAAmB,CAAC,EAChC,iBAAsB,EACtB,QAAQ,EAAE,eAAoB,EAC9B,WAAW,EACX,aAAa,GAChB,GAAE;IACC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,iBAAiB,CAAA;KAAE,CAAC,CAAC;IAChE,aAAa,CAAC,EAAE,eAAe,CAAC;CAC9B,GAAG,8BAA8B,CAsFtC"}

package/lib/dataGrid/useDataGridUrlState.js

@@ -0,0 +1,108 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+import isEqual from "lodash.isequal";
+import queryString from "query-string";
+import { useCallback, useRef, useState } from "react";
+import { useHistory, useLocation } from "react-router";
+/**
+ * Returns props for DataGrid that turns it into a controlled component that stores it's state as location params
+ **/
+export function useDataGridUrlState() {
+  var _ref2, _ref3, _ref4, _ref5, _ref6, _ref7, _map, _ref8, _ref9;
+  var _ref = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
+    _ref$queryParamsPrefi = _ref.queryParamsPrefix,
+    queryParamsPrefix = _ref$queryParamsPrefi === void 0 ? "" : _ref$queryParamsPrefi,
+    _ref$pageSize = _ref.pageSize,
+    initialPageSize = _ref$pageSize === void 0 ? 25 : _ref$pageSize,
+    initialSort = _ref.initialSort,
+    initialFilter = _ref.initialFilter;
+  var history = useHistory();
+  var location = useLocation();
+
+  // fallback states are used when query param in the Url is lost (e.g. when the user open an EditDialog that creates a new sub route)
+  var _useState = useState(undefined),
+    _useState2 = _slicedToArray(_useState, 2),
+    fallbackSort = _useState2[0],
+    setFallbackSort = _useState2[1];
+  var _useState3 = useState(undefined),
+    _useState4 = _slicedToArray(_useState3, 2),
+    fallbackFilter = _useState4[0],
+    setFallbackFilter = _useState4[1];
+  var _useState5 = useState(undefined),
+    _useState6 = _slicedToArray(_useState5, 2),
+    fallbackPage = _useState6[0],
+    setFallbackPage = _useState6[1];
+  var _useState7 = useState(undefined),
+    _useState8 = _slicedToArray(_useState7, 2),
+    fallbackPageSize = _useState8[0],
+    setFallbackPageSize = _useState8[1];
+  var sortParamName = "".concat(queryParamsPrefix, "sort");
+  var filterParamName = "".concat(queryParamsPrefix, "filter");
+  var pageParamName = "".concat(queryParamsPrefix, "page");
+  var pageSizeParamName = "".concat(queryParamsPrefix, "pageSize");
+  var parsedSearch = queryString.parse(location.search, {
+    parseNumbers: true
+  });
+  var page = (_ref2 = (_ref3 = parsedSearch[pageParamName]) !== null && _ref3 !== void 0 ? _ref3 : fallbackPage) !== null && _ref2 !== void 0 ? _ref2 : 0;
+  var pageSize = (_ref4 = (_ref5 = parsedSearch[pageSizeParamName]) !== null && _ref5 !== void 0 ? _ref5 : fallbackPageSize) !== null && _ref4 !== void 0 ? _ref4 : initialPageSize;
+  var onPaginationModelChange = useCallback(function (model, details) {
+    history.replace(_objectSpread(_objectSpread({}, location), {}, {
+      search: queryString.stringify(_objectSpread(_objectSpread({}, parsedSearch), {}, _defineProperty(_defineProperty({}, pageParamName, model.page), pageSizeParamName, model.pageSize)))
+    }));
+    setFallbackPage(model.page);
+    setFallbackPageSize(model.pageSize);
+  }, [history, location, pageParamName, pageSizeParamName, parsedSearch]);
+  var sortModel = useDeepEqualMemo((_ref6 = (_ref7 = (_map = (_ref8 = !parsedSearch[sortParamName] ? undefined : !Array.isArray(parsedSearch[sortParamName]) ? parsedSearch[sortParamName] === "none" ? [] : [parsedSearch[sortParamName]] : parsedSearch[sortParamName]) === null || _ref8 === void 0 ? void 0 : _ref8.map(function (i) {
+    var parts = i.split(":");
+    return {
+      field: parts[0],
+      sort: parts[1]
+    };
+  })) !== null && _map !== void 0 ? _map : fallbackSort) !== null && _ref7 !== void 0 ? _ref7 : initialSort) !== null && _ref6 !== void 0 ? _ref6 : []);
+  var handleSortModelChange = useCallback(function (sortModel) {
+    var sort = sortModel.length > 0 ? sortModel.map(function (i) {
+      return "".concat(i.field, ":").concat(i.sort);
+    }) : ["none"];
+    history.replace(_objectSpread(_objectSpread({}, location), {}, {
+      search: queryString.stringify(_objectSpread(_objectSpread({}, parsedSearch), {}, _defineProperty({}, sortParamName, sort)))
+    }));
+    setFallbackSort(sortModel);
+  }, [history, location, parsedSearch, sortParamName]);
+  var filterModel = parsedSearch[filterParamName] ? JSON.parse(parsedSearch[filterParamName]) : (_ref9 = fallbackFilter !== null && fallbackFilter !== void 0 ? fallbackFilter : initialFilter) !== null && _ref9 !== void 0 ? _ref9 : {
+    items: []
+  };
+  var handleFilterChange = useCallback(function (filterModel) {
+    history.replace(_objectSpread(_objectSpread({}, location), {}, {
+      search: queryString.stringify(_objectSpread(_objectSpread({}, parsedSearch), {}, _defineProperty({}, filterParamName, JSON.stringify(filterModel))))
+    }));
+    setFallbackFilter(filterModel);
+  }, [history, location, parsedSearch, filterParamName]);
+  return {
+    filterModel: filterModel,
+    onFilterModelChange: handleFilterChange,
+    paginationModel: {
+      pageSize: pageSize,
+      page: page
+    },
+    onPaginationModelChange: onPaginationModelChange,
+    sortModel: sortModel,
+    onSortModelChange: handleSortModelChange
+  };
+}
+function useDeepEqualMemo(value) {
+  var ref = useRef(value);
+  if (!isEqual(ref.current, value)) {
+    ref.current = value;
+  }
+  return ref.current;
+}

package/lib/dataGrid/usePersistentColumnState.d.ts

@@ -0,0 +1,16 @@
+import { type DataGridProps } from "@mui/x-data-grid";
+import type { DataGridProProps } from "@mui/x-data-grid-pro";
+import { type RefObject } from "react";
+type GridProps = {
+    columnVisibilityModel: DataGridProps["columnVisibilityModel"];
+    onColumnVisibilityModelChange: DataGridProps["onColumnVisibilityModelChange"];
+    pinnedColumns: DataGridProProps["pinnedColumns"];
+    onPinnedColumnsChange: DataGridProProps["onPinnedColumnsChange"];
+    onColumnWidthChange: DataGridProProps["onColumnWidthChange"];
+    onColumnOrderChange: DataGridProps["onColumnOrderChange"];
+    initialState: DataGridProps["initialState"];
+    apiRef: RefObject<any>;
+};
+export declare function usePersistentColumnState(stateKey: string): GridProps;
+export {};
+//# sourceMappingURL=usePersistentColumnState.d.ts.map

package/lib/dataGrid/usePersistentColumnState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePersistentColumnState.d.ts","sourceRoot":"","sources":["../../src/dataGrid/usePersistentColumnState.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAA8E,MAAM,kBAAkB,CAAC;AAClI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,KAAK,SAAS,EAA6C,MAAM,OAAO,CAAC;AAwDlF,KAAK,SAAS,GAAG;IACb,qBAAqB,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAC9D,6BAA6B,EAAE,aAAa,CAAC,+BAA+B,CAAC,CAAC;IAE9E,aAAa,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC;IACjD,qBAAqB,EAAE,gBAAgB,CAAC,uBAAuB,CAAC,CAAC;IAEjE,mBAAmB,EAAE,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;IAE7D,mBAAmB,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAE1D,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAE5C,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;CAC1B,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAiGpE"}

package/lib/dataGrid/usePersistentColumnState.js

@@ -0,0 +1,156 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+import { useGridApiRef } from "@mui/x-data-grid";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useRouteMatch } from "react-router";
+import { useStoredState } from "../hooks/useStoredState";
+var useGridColumns = function useGridColumns(apiRef) {
+  var _useState = useState(),
+    _useState2 = _slicedToArray(_useState, 2),
+    columns = _useState2[0],
+    setColumns = _useState2[1];
+  useEffect(function () {
+    var _apiRef$current, _apiRef$current$getAl;
+    // This will be `undefined` if the free version of DataGrid V5 is used.
+
+    setColumns(// TODO: find a better solution than the `as GridColDef[] | undefined` cast.
+    // The problem is, that due to the more complicated GridColDef type, introduced in Mui-X v6 and the override
+    // GridColDef type from @dextinity/admin, the types returned from apiRef.current?.getAllColumns?.() are not
+    // compatible with the @dextinity/admin GridColDef.
+    (_apiRef$current = apiRef.current) === null || _apiRef$current === void 0 || (_apiRef$current$getAl = _apiRef$current.getAllColumns) === null || _apiRef$current$getAl === void 0 ? void 0 : _apiRef$current$getAl.call(_apiRef$current));
+  }, [apiRef]);
+  return columns;
+};
+var useVisibilityModelFromColumnMediaQueries = function useVisibilityModelFromColumnMediaQueries(columns) {
+  var _useState3 = useState({}),
+    _useState4 = _slicedToArray(_useState3, 2),
+    visibilityModel = _useState4[0],
+    setVisibilityModel = _useState4[1];
+  useEffect(function () {
+    var updateVisibilityModel = function updateVisibilityModel() {
+      var visibilityModel = {};
+      columns === null || columns === void 0 || columns.forEach(function (column) {
+        if (column.visible !== undefined) {
+          if (typeof column.visible === "string") {
+            var mediaQuery = column.visible.replace("@media", "").trim();
+            visibilityModel[column.field] = window.matchMedia(mediaQuery).matches;
+          } else if (column.visible == false) {
+            visibilityModel[column.field] = column.visible;
+          }
+        }
+      });
+      setVisibilityModel(visibilityModel);
+    };
+    updateVisibilityModel();
+    window.addEventListener("resize", updateVisibilityModel);
+    return function () {
+      window.removeEventListener("resize", updateVisibilityModel);
+    };
+  }, [columns]);
+  return visibilityModel;
+};
+export function usePersistentColumnState(stateKey) {
+  var apiRef = useGridApiRef();
+  var columns = useGridColumns(apiRef);
+  var match = useRouteMatch();
+  var storageKeyPrefix = "".concat(match.path).concat(stateKey);
+  var mediaQueryColumnVisibilityModel = useVisibilityModelFromColumnMediaQueries(columns);
+  var _useStoredState = useStoredState("".concat(storageKeyPrefix, "ColumnVisibility"), {}),
+    _useStoredState2 = _slicedToArray(_useStoredState, 2),
+    storedColumnVisibilityModel = _useStoredState2[0],
+    setStoredColumnVisibilityModel = _useStoredState2[1];
+  var handleColumnVisibilityModelChange = useCallback(function (newModel) {
+    var modelToStore = {};
+
+    // Do not store column visibility controlled by media queries.
+    // This prevents stored values from a previous screen size from overriding the values.
+    Object.entries(newModel).forEach(function (_ref) {
+      var _ref2 = _slicedToArray(_ref, 2),
+        field = _ref2[0],
+        visible = _ref2[1];
+      var visibilityChangedByUser = mediaQueryColumnVisibilityModel[field] !== visible;
+      if (visibilityChangedByUser) {
+        modelToStore[field] = visible;
+      }
+    });
+    setStoredColumnVisibilityModel(modelToStore);
+  }, [mediaQueryColumnVisibilityModel, setStoredColumnVisibilityModel]);
+  var _useStoredState3 = useStoredState("".concat(storageKeyPrefix, "PinnedColumns"), {}),
+    _useStoredState4 = _slicedToArray(_useStoredState3, 2),
+    pinnedColumns = _useStoredState4[0],
+    setPinnedColumns = _useStoredState4[1];
+  var handlePinnedColumnsChange = useCallback(function (newModel) {
+    setPinnedColumns(newModel);
+  }, [setPinnedColumns]);
+  useEffect(function () {
+    // During the first render, `columns` is `undefined`, so we cannot set this as the initial values of the `pinnedColumns` state.
+    // We have to wait until the columns are loaded from the `useGridColumns` hook.
+    var pinnedColumnsHaveNotYetBeenSet = Object.keys(pinnedColumns).length === 0;
+    var columnsHaveBeenLoaded = Boolean(columns);
+    if (pinnedColumnsHaveNotYetBeenSet && columnsHaveBeenLoaded) {
+      var _columns$filter, _columns$filter2;
+      setPinnedColumns({
+        left: columns === null || columns === void 0 || (_columns$filter = columns.filter(function (column) {
+          return column.pinned === "left";
+        })) === null || _columns$filter === void 0 ? void 0 : _columns$filter.map(function (column) {
+          return column.field;
+        }),
+        right: columns === null || columns === void 0 || (_columns$filter2 = columns.filter(function (column) {
+          return column.pinned === "right";
+        })) === null || _columns$filter2 === void 0 ? void 0 : _columns$filter2.map(function (column) {
+          return column.field;
+        })
+      });
+    }
+  }, [columns, setPinnedColumns, pinnedColumns]);
+
+  //no API for column dimensions as controlled state, export on change instead
+  var columnDimensionsKey = "".concat(storageKeyPrefix, "ColumnDimensions");
+  var initialColumnDimensions = useMemo(function () {
+    var serializedState = window.localStorage.getItem(columnDimensionsKey);
+    return serializedState ? JSON.parse(serializedState) : undefined;
+  }, [columnDimensionsKey]);
+  var handleColumnWidthChange = useCallback(function () {
+    var _apiRef$current$expor, _apiRef$current2;
+    var newState = (_apiRef$current$expor = (_apiRef$current2 = apiRef.current) === null || _apiRef$current2 === void 0 || (_apiRef$current2 = _apiRef$current2.exportState().columns) === null || _apiRef$current2 === void 0 ? void 0 : _apiRef$current2.dimensions) !== null && _apiRef$current$expor !== void 0 ? _apiRef$current$expor : {};
+    window.localStorage.setItem(columnDimensionsKey, JSON.stringify(newState));
+  }, [columnDimensionsKey, apiRef]);
+
+  //no API for column order as controlled state, export on change instead
+  var columnOrderKey = "".concat(storageKeyPrefix, "ColumnOrder");
+  var initialColumnOrder = useMemo(function () {
+    var serializedState = window.localStorage.getItem(columnOrderKey);
+    return serializedState ? JSON.parse(serializedState) : undefined;
+  }, [columnOrderKey]);
+  var handleColumnOrderChange = useCallback(function () {
+    var _apiRef$current$expor2, _apiRef$current3;
+    var newState = (_apiRef$current$expor2 = (_apiRef$current3 = apiRef.current) === null || _apiRef$current3 === void 0 || (_apiRef$current3 = _apiRef$current3.exportState().columns) === null || _apiRef$current3 === void 0 ? void 0 : _apiRef$current3.orderedFields) !== null && _apiRef$current$expor2 !== void 0 ? _apiRef$current$expor2 : undefined;
+    window.localStorage.setItem(columnOrderKey, JSON.stringify(newState));
+  }, [columnOrderKey, apiRef]);
+  var initialState = {
+    columns: {
+      dimensions: initialColumnDimensions,
+      orderedFields: initialColumnOrder
+    }
+  };
+  return {
+    columnVisibilityModel: _objectSpread(_objectSpread({}, mediaQueryColumnVisibilityModel), storedColumnVisibilityModel),
+    onColumnVisibilityModelChange: handleColumnVisibilityModelChange,
+    pinnedColumns: pinnedColumns,
+    onPinnedColumnsChange: handlePinnedColumnsChange,
+    onColumnWidthChange: handleColumnWidthChange,
+    onColumnOrderChange: handleColumnOrderChange,
+    apiRef: apiRef,
+    initialState: initialState
+  };
+}

package/lib/dateTime/datePicker/DatePicker.d.ts

@@ -0,0 +1,64 @@
+import { type ComponentsOverrides, type Theme } from "@mui/material";
+import { DatePicker as MuiDatePicker, type DatePickerProps as MuiDatePickerProps } from "@mui/x-date-pickers";
+import { type ReactNode } from "react";
+import { ClearInputAdornment as CometClearInputAdornment } from "../../common/ClearInputAdornment";
+import { OpenPickerAdornment } from "../../common/OpenPickerAdornment";
+import { ReadOnlyAdornment } from "../../common/ReadOnlyAdornment";
+import type { ThemedComponentBaseProps } from "../../helpers/ThemedComponentBaseProps";
+export type DatePickerClassKey = "root" | "clearInputAdornment" | "readOnlyAdornment" | "openPickerAdornment";
+export type DatePickerProps = ThemedComponentBaseProps<{
+    root: typeof MuiDatePicker;
+    clearInputAdornment: typeof CometClearInputAdornment;
+    readOnlyAdornment: typeof ReadOnlyAdornment;
+    openPickerAdornment: typeof OpenPickerAdornment;
+}> & {
+    fullWidth?: boolean;
+    /**
+     * If `true`, the picker will be marked as required and the clear button will be hidden.
+     */
+    required?: boolean;
+    /**
+     * The selected date value in ISO 8601 format (YYYY-MM-DD).
+     */
+    value?: string;
+    /**
+     * Callback fired when the date changes.
+     *
+     * @param date - The new date value in ISO 8601 format (YYYY-MM-DD), or `undefined` if cleared.
+     */
+    onChange?: (date: string | undefined) => void;
+    onBlur?: () => void;
+    onFocus?: () => void;
+    /**
+     * Custom icons for the picker.
+     *
+     * - `openPicker`: Icon to display in the adornment that opens the calendar picker (default: Calendar icon)
+     */
+    iconMapping?: {
+        openPicker?: ReactNode;
+    };
+} & Omit<MuiDatePickerProps, "value" | "onChange" | "slotProps">;
+/**
+ * The DatePicker component allows users to select a date from a calendar interface. It provides a text field
+ * with a calendar icon that opens a date picker dialog. The component handles ISO 8601 date strings and includes
+ * features like clearing, read-only state, and customizable icons.
+ *
+ * - [Storybook](https://storybook.comet-dxp.com/?path=/docs/@dextinity/admin_components-datetime-datepicker--docs)
+ * - [MUI X DatePicker Documentation](https://mui.com/x/react-date-pickers/date-picker/)
+ */
+export declare const DatePicker: (inProps: DatePickerProps) => import("react/jsx-runtime").JSX.Element;
+declare module "@mui/material/styles" {
+    interface ComponentsPropsList {
+        CometAdminDatePicker: DatePickerProps;
+    }
+    interface ComponentNameToClassKey {
+        CometAdminDatePicker: DatePickerClassKey;
+    }
+    interface Components {
+        CometAdminDatePicker?: {
+            defaultProps?: Partial<ComponentsPropsList["CometAdminDatePicker"]>;
+            styleOverrides?: ComponentsOverrides<Theme>["CometAdminDatePicker"];
+        };
+    }
+}
+//# sourceMappingURL=DatePicker.d.ts.map

package/lib/dateTime/datePicker/DatePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../src/dateTime/datePicker/DatePicker.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,mBAAmB,EAA0B,KAAK,KAAK,EAAiB,MAAM,eAAe,CAAC;AAC5G,OAAO,EAAE,UAAU,IAAI,aAAa,EAAE,KAAK,eAAe,IAAI,kBAAkB,EAA2B,MAAM,qBAAqB,CAAC;AACvI,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAGjD,OAAO,EAAE,mBAAmB,IAAI,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAGvF,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,qBAAqB,GAAG,mBAAmB,GAAG,qBAAqB,CAAC;AAE9G,MAAM,MAAM,eAAe,GAAG,wBAAwB,CAAC;IACnD,IAAI,EAAE,OAAO,aAAa,CAAC;IAC3B,mBAAmB,EAAE,OAAO,wBAAwB,CAAC;IACrD,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;CACnD,CAAC,GAAG;IACD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC9C,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE;QACV,UAAU,CAAC,EAAE,SAAS,CAAC;KAC1B,CAAC;CACL,GAAG,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;AAEjE;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,eAAe,4CA+FlD,CAAC;AAoBF,OAAO,QAAQ,sBAAsB,CAAC;IAClC,UAAU,mBAAmB;QACzB,oBAAoB,EAAE,eAAe,CAAC;KACzC;IAED,UAAU,uBAAuB;QAC7B,oBAAoB,EAAE,kBAAkB,CAAC;KAC5C;IAED,UAAU,UAAU;QAChB,oBAAoB,CAAC,EAAE;YACnB,YAAY,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,sBAAsB,CAAC,CAAC,CAAC;YACpE,cAAc,CAAC,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC,sBAAsB,CAAC,CAAC;SACvE,CAAC;KACL;CACJ"}

package/lib/dateTime/datePicker/DatePicker.js

@@ -0,0 +1,137 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _templateObject;
+var _excluded = ["iconMapping", "fullWidth", "required", "slotProps", "disabled", "value", "onChange", "onBlur", "onFocus", "readOnly"];
+function _taggedTemplateLiteral(e, t) { return t || (t = e.slice(0)), Object.freeze(Object.defineProperties(e, { raw: { value: Object.freeze(t) } })); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
+import { Calendar } from "@dextinity/admin-icons";
+import { css, inputLabelClasses, useThemeProps } from "@mui/material";
+import { DatePicker as MuiDatePicker, pickersInputBaseClasses } from "@mui/x-date-pickers";
+import { useState } from "react";
+import { useIntl } from "react-intl";
+import { ClearInputAdornment as CometClearInputAdornment } from "../../common/ClearInputAdornment";
+import { OpenPickerAdornment } from "../../common/OpenPickerAdornment";
+import { ReadOnlyAdornment } from "../../common/ReadOnlyAdornment";
+import { createComponentSlot } from "../../helpers/createComponentSlot";
+import { getDateValue, getIsoDateString, isValidDate } from "../utils";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The DatePicker component allows users to select a date from a calendar interface. It provides a text field
+ * with a calendar icon that opens a date picker dialog. The component handles ISO 8601 date strings and includes
+ * features like clearing, read-only state, and customizable icons.
+ *
+ * - [Storybook](https://storybook.comet-dxp.com/?path=/docs/@dextinity/admin_components-datetime-datepicker--docs)
+ * - [MUI X DatePicker Documentation](https://mui.com/x/react-date-pickers/date-picker/)
+ */
+export var DatePicker = function DatePicker(inProps) {
+  var _slotProps$root;
+  var _useThemeProps = useThemeProps({
+      props: inProps,
+      name: "CometAdminDatePicker"
+    }),
+    _useThemeProps$iconMa = _useThemeProps.iconMapping,
+    iconMapping = _useThemeProps$iconMa === void 0 ? {} : _useThemeProps$iconMa,
+    fullWidth = _useThemeProps.fullWidth,
+    required = _useThemeProps.required,
+    slotProps = _useThemeProps.slotProps,
+    disabled = _useThemeProps.disabled,
+    stringValue = _useThemeProps.value,
+    _onChange = _useThemeProps.onChange,
+    onBlur = _useThemeProps.onBlur,
+    onFocus = _useThemeProps.onFocus,
+    readOnly = _useThemeProps.readOnly,
+    restProps = _objectWithoutProperties(_useThemeProps, _excluded);
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    open = _useState2[0],
+    setOpen = _useState2[1];
+  var intl = useIntl();
+  var dateValue = getDateValue(stringValue);
+  var _iconMapping$openPick = iconMapping.openPicker,
+    openPickerIcon = _iconMapping$openPick === void 0 ? /*#__PURE__*/_jsx(Calendar, {
+      color: "inherit"
+    }) : _iconMapping$openPick;
+  return /*#__PURE__*/_jsx(Root, _objectSpread(_objectSpread(_objectSpread({
+    disabled: disabled,
+    readOnly: readOnly,
+    open: open,
+    onOpen: function onOpen() {
+      return setOpen(true);
+    },
+    onClose: function onClose() {
+      return setOpen(false);
+    },
+    value: dateValue,
+    onChange: function onChange(date) {
+      var newStringValue = undefined;
+      if (date && isValidDate(date)) {
+        newStringValue = getIsoDateString(date);
+      }
+      return _onChange === null || _onChange === void 0 ? void 0 : _onChange(newStringValue);
+    }
+  }, slotProps === null || slotProps === void 0 ? void 0 : slotProps.root), restProps), {}, {
+    slotProps: _objectSpread(_objectSpread({}, slotProps === null || slotProps === void 0 || (_slotProps$root = slotProps.root) === null || _slotProps$root === void 0 ? void 0 : _slotProps$root.slotProps), {}, {
+      textField: function textField(ownerState) {
+        var _slotProps$root2, _slotProps$openPicker, _slotProps$openPicker2;
+        var textFieldProps = _objectSpread(_objectSpread({}, slotProps === null || slotProps === void 0 || (_slotProps$root2 = slotProps.root) === null || _slotProps$root2 === void 0 || (_slotProps$root2 = _slotProps$root2.slotProps) === null || _slotProps$root2 === void 0 ? void 0 : _slotProps$root2.textField), {}, {
+          ownerState: ownerState
+        });
+        return _objectSpread(_objectSpread({
+          fullWidth: fullWidth,
+          required: required,
+          onBlur: onBlur,
+          onFocus: onFocus
+        }, textFieldProps), {}, {
+          InputProps: {
+            startAdornment: /*#__PURE__*/_jsx(OpenPickerAdornment, _objectSpread(_objectSpread({
+              inputIsDisabled: disabled,
+              inputIsReadOnly: readOnly,
+              onClick: function onClick() {
+                return setOpen(true);
+              }
+            }, slotProps === null || slotProps === void 0 ? void 0 : slotProps.openPickerAdornment), {}, {
+              slotProps: _objectSpread(_objectSpread({}, slotProps === null || slotProps === void 0 || (_slotProps$openPicker = slotProps.openPickerAdornment) === null || _slotProps$openPicker === void 0 ? void 0 : _slotProps$openPicker.slotProps), {}, {
+                openPickerButton: _objectSpread({
+                  "aria-label": intl.formatMessage({
+                    id: "comet.datePicker.openPicker",
+                    defaultMessage: "Open date picker"
+                  })
+                }, slotProps === null || slotProps === void 0 || (_slotProps$openPicker2 = slotProps.openPickerAdornment) === null || _slotProps$openPicker2 === void 0 || (_slotProps$openPicker2 = _slotProps$openPicker2.slotProps) === null || _slotProps$openPicker2 === void 0 ? void 0 : _slotProps$openPicker2.openPickerButton)
+              }),
+              children: openPickerIcon
+            })),
+            endAdornment: /*#__PURE__*/_jsxs(_Fragment, {
+              children: [/*#__PURE__*/_jsx(ReadOnlyAdornment, _objectSpread({
+                inputIsReadOnly: Boolean(readOnly)
+              }, slotProps === null || slotProps === void 0 ? void 0 : slotProps.readOnlyAdornment)), dateValue !== null && !required && !disabled && !readOnly && /*#__PURE__*/_jsx(ClearInputAdornment, _objectSpread({
+                position: "end",
+                onClick: function onClick() {
+                  return _onChange === null || _onChange === void 0 ? void 0 : _onChange(undefined);
+                }
+              }, slotProps === null || slotProps === void 0 ? void 0 : slotProps.clearInputAdornment))]
+            })
+          }
+        });
+      }
+    })
+  }));
+};
+var Root = createComponentSlot(MuiDatePicker)({
+  componentName: "DatePicker",
+  slotName: "root"
+})(css(_templateObject || (_templateObject = _taggedTemplateLiteral(["\n    .", " {\n        display: none;\n\n        & + .", " {\n            margin-top: 0;\n        }\n    }\n"])), inputLabelClasses.root, pickersInputBaseClasses.root));
+var ClearInputAdornment = createComponentSlot(CometClearInputAdornment)({
+  componentName: "DatePicker",
+  slotName: "clearInputAdornment"
+})();

package/lib/dateTime/datePickerField/DatePickerField.d.ts

@@ -0,0 +1,15 @@
+import { type FieldProps } from "../../form/Field";
+import { type DatePickerProps } from "../datePicker/DatePicker";
+type FinalFormDatePickerProps = DatePickerProps;
+export type DatePickerFieldProps = FinalFormDatePickerProps & FieldProps<string, HTMLInputElement>;
+/**
+ * A Final Form field wrapper for the DatePicker component. This integrates the DatePicker with react-final-form,
+ * providing automatic form state management, validation, and error handling.
+ *
+ * Use this component when working with Final Form. For standalone usage, use `DatePicker` instead.
+ *
+ * - [Storybook](https://storybook.comet-dxp.com/?path=/docs/@dextinity/admin_components-datetime-datepickerfield--docs)
+ */
+export declare const DatePickerField: (props: DatePickerFieldProps) => import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=DatePickerField.d.ts.map

package/lib/dateTime/datePickerField/DatePickerField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatePickerField.d.ts","sourceRoot":"","sources":["../../../src/dateTime/datePickerField/DatePickerField.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE5E,KAAK,wBAAwB,GAAG,eAAe,CAAC;AAKhD,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,GAAG,UAAU,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAEnG;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,oBAAoB,4CAE1D,CAAC"}

package/lib/dateTime/datePickerField/DatePickerField.js

@@ -0,0 +1,31 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _excluded = ["meta", "input"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
+import { Field } from "../../form/Field";
+import { DatePicker } from "../datePicker/DatePicker";
+import { jsx as _jsx } from "react/jsx-runtime";
+var FinalFormDatePicker = function FinalFormDatePicker(_ref) {
+  var meta = _ref.meta,
+    input = _ref.input,
+    restProps = _objectWithoutProperties(_ref, _excluded);
+  return /*#__PURE__*/_jsx(DatePicker, _objectSpread(_objectSpread({}, input), restProps));
+};
+/**
+ * A Final Form field wrapper for the DatePicker component. This integrates the DatePicker with react-final-form,
+ * providing automatic form state management, validation, and error handling.
+ *
+ * Use this component when working with Final Form. For standalone usage, use `DatePicker` instead.
+ *
+ * - [Storybook](https://storybook.comet-dxp.com/?path=/docs/@dextinity/admin_components-datetime-datepickerfield--docs)
+ */
+export var DatePickerField = function DatePickerField(props) {
+  return /*#__PURE__*/_jsx(Field, _objectSpread({
+    component: FinalFormDatePicker
+  }, props));
+};

package/lib/dateTime/dateRangePicker/DateRangePicker.d.ts

@@ -0,0 +1,71 @@
+import { type ComponentsOverrides, type Theme } from "@mui/material";
+import type { DateRangePickerProps as MuiDateRangePickerProps } from "@mui/x-date-pickers-pro";
+import { type ComponentType, type ReactNode } from "react";
+import { ClearInputAdornment as CometClearInputAdornment } from "../../common/ClearInputAdornment";
+import { OpenPickerAdornment } from "../../common/OpenPickerAdornment";
+import { ReadOnlyAdornment } from "../../common/ReadOnlyAdornment";
+import type { ThemedComponentBaseProps } from "../../helpers/ThemedComponentBaseProps";
+/**
+ * Represents a date range with start and end dates in ISO 8601 format (YYYY-MM-DD).
+ */
+export type DateRange = {
+    start: string | null;
+    end: string | null;
+};
+export type DateRangePickerClassKey = "root" | "clearInputAdornment" | "readOnlyAdornment" | "openPickerAdornment";
+export type DateRangePickerProps = ThemedComponentBaseProps<{
+    root: ComponentType<MuiDateRangePickerProps>;
+    clearInputAdornment: typeof CometClearInputAdornment;
+    readOnlyAdornment: typeof ReadOnlyAdornment;
+    openPickerAdornment: typeof OpenPickerAdornment;
+}> & {
+    fullWidth?: boolean;
+    /**
+     * If `true`, the picker will be marked as required and the clear button will be hidden.
+     */
+    required?: boolean;
+    /**
+     * The selected date range value with start and end dates in ISO 8601 format.
+     */
+    value?: DateRange;
+    /**
+     * Callback fired when the date range changes.
+     *
+     * @param date - The new date range value, or `undefined` if cleared.
+     */
+    onChange?: (date: DateRange | undefined) => void;
+    onBlur?: () => void;
+    onFocus?: () => void;
+    /**
+     * Custom icons for the picker.
+     *
+     * - `openPicker`: Icon to display in the adornment that opens the calendar picker (default: Calendar icon)
+     */
+    iconMapping?: {
+        openPicker?: ReactNode;
+    };
+} & Omit<MuiDateRangePickerProps, "value" | "onChange">;
+/**
+ * The DateRangePicker component allows users to select a date range from a calendar interface. It provides two
+ * text fields with a calendar icon that opens a date range picker dialog. The component handles ISO 8601 date strings
+ * and includes features like clearing, read-only state, and customizable icons.
+ *
+ * - [Storybook](https://storybook.comet-dxp.com/?path=/docs/@dextinity/admin_components-datetime-daterangepicker--docs)
+ * - [MUI X DateRangePicker Documentation](https://mui.com/x/react-date-pickers/date-range-picker/)
+ */
+export declare const DateRangePicker: (inProps: DateRangePickerProps) => import("react/jsx-runtime").JSX.Element;
+declare module "@mui/material/styles" {
+    interface ComponentsPropsList {
+        CometAdminDateRangePicker: DateRangePickerProps;
+    }
+    interface ComponentNameToClassKey {
+        CometAdminDateRangePicker: DateRangePickerClassKey;
+    }
+    interface Components {
+        CometAdminDateRangePicker?: {
+            defaultProps?: Partial<ComponentsPropsList["CometAdminDateRangePicker"]>;
+            styleOverrides?: ComponentsOverrides<Theme>["CometAdminDateRangePicker"];
+        };
+    }
+}
+//# sourceMappingURL=DateRangePicker.d.ts.map

package/lib/dateTime/dateRangePicker/DateRangePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateRangePicker.d.ts","sourceRoot":"","sources":["../../../src/dateTime/dateRangePicker/DateRangePicker.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,mBAAmB,EAA0B,KAAK,KAAK,EAAiB,MAAM,eAAe,CAAC;AAC5G,OAAO,KAAK,EAAE,oBAAoB,IAAI,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC/F,OAAO,EAAE,KAAK,aAAa,EAAQ,KAAK,SAAS,EAAsB,MAAM,OAAO,CAAC;AAGrF,OAAO,EAAE,mBAAmB,IAAI,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAGvF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,qBAAqB,GAAG,mBAAmB,GAAG,qBAAqB,CAAC;AAEnH,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;IACxD,IAAI,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAC7C,mBAAmB,EAAE,OAAO,wBAAwB,CAAC;IACrD,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;CACnD,CAAC,GAAG;IACD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE;QACV,UAAU,CAAC,EAAE,SAAS,CAAC;KAC1B,CAAC;CACL,GAAG,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC;AAMxD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,oBAAoB,4CAsG5D,CAAC;AA4BF,OAAO,QAAQ,sBAAsB,CAAC;IAClC,UAAU,mBAAmB;QACzB,yBAAyB,EAAE,oBAAoB,CAAC;KACnD;IAED,UAAU,uBAAuB;QAC7B,yBAAyB,EAAE,uBAAuB,CAAC;KACtD;IAED,UAAU,UAAU;QAChB,yBAAyB,CAAC,EAAE;YACxB,YAAY,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,2BAA2B,CAAC,CAAC,CAAC;YACzE,cAAc,CAAC,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC,2BAA2B,CAAC,CAAC;SAC5E,CAAC;KACL;CACJ"}