@nokecy/qc-ui-components 0.0.0-stage → 2.0.0-beta.1

package/dist/esm/dashboard/widget/selector/filterWidgets.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 部件选择器的筛选与计数。
+ *
+ * 单独抽出来是因为这里踩过一次：布局里存着当前部署已经没有的部件时
+ * （按客户启用的模块清单不同，某个部件这次就是不发），原来的写法会抛 TypeError，
+ * 整个选择器打不开——而用户唯一能看到的现象是「点了没反应」。
+ *
+ * @author nokecy
+ */
+export type WidgetMeta = {
+    name?: string;
+    description?: string;
+    tags?: string[];
+    visible?: boolean;
+    length?: number;
+    [key: string]: any;
+};
+export type LayoutItem = {
+    i: string;
+    [key: string]: any;
+};
+/** 出参一定带上 visible 与 length，调用方不必再判空。 */
+export type FilteredWidget = WidgetMeta & {
+    visible: boolean;
+    length: number;
+};
+export declare const filterWidgets: (widgets: Record<string, WidgetMeta> | undefined | null, currentLayout: LayoutItem[] | undefined | null, keywords?: string, activeMenuKey?: string) => Record<string, FilteredWidget>;

package/dist/esm/dashboard/widget/selector/filterWidgets.js

@@ -0,0 +1,47 @@
+import cloneDeep from 'lodash/cloneDeep';
+
+/**
+ * 部件选择器的筛选与计数。
+ *
+ * 单独抽出来是因为这里踩过一次：布局里存着当前部署已经没有的部件时
+ * （按客户启用的模块清单不同，某个部件这次就是不发），原来的写法会抛 TypeError，
+ * 整个选择器打不开——而用户唯一能看到的现象是「点了没反应」。
+ *
+ * @author nokecy
+ */
+
+/** 出参一定带上 visible 与 length，调用方不必再判空。 */
+
+export var filterWidgets = function filterWidgets(widgets, currentLayout) {
+  var keywords = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : '';
+  var activeMenuKey = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : '';
+  var finData = cloneDeep(widgets || {});
+  var keyword = (keywords || '').toLowerCase();
+  Object.keys(finData).forEach(function (key) {
+    var widget = finData[key];
+    widget.length = 0;
+    widget.visible = true;
+
+    // 菜单切换：部件没声明 tags 时按「不属于任何分类」处理，不该因此抛错
+    if (activeMenuKey && (widget.tags || []).indexOf(activeMenuKey) < 0) {
+      widget.visible = false;
+    }
+
+    // 查询：名称与描述任一命中即保留；两者都可能没写
+    var name = (widget.name || '').toLowerCase();
+    var description = (widget.description || '').toLowerCase();
+    if (name.indexOf(keyword) < 0 && description.indexOf(keyword) < 0) {
+      widget.visible = false;
+    }
+  });
+
+  // 已添加次数。布局里可能存着当前部署没有的部件，跳过即可。
+  (currentLayout || []).forEach(function (item) {
+    var _item$i;
+    var key = String((_item$i = item === null || item === void 0 ? void 0 : item.i) !== null && _item$i !== void 0 ? _item$i : '').split('-')[0];
+    var widget = finData[key];
+    if (!widget) return;
+    widget.length = widget.length ? widget.length + 1 : 1;
+  });
+  return finData;
+};

package/dist/esm/dashboard/widget/selector/index.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import './index.less';
+declare const WidgetSelector: (props: any) => React.JSX.Element;
+export default WidgetSelector;

package/dist/esm/dashboard/widget/selector/index.js

@@ -0,0 +1,238 @@
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _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(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+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(arr) { if (Array.isArray(arr)) return arr; }
+import { AppstoreAddOutlined, PlusOutlined, SearchOutlined } from '@ant-design/icons';
+import { Button, Drawer, Empty, Input } from 'antd';
+import classnames from 'classnames';
+import { isEmpty, get } from 'lodash';
+import { filterWidgets } from "./filterWidgets";
+import React, { useCallback, useEffect, useMemo, useState } from 'react';
+import "./index.less";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Fragment as _Fragment } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+var Search = Input.Search;
+var WidgetSelector = function WidgetSelector(props) {
+  var widgets = props.widgets,
+    currentLayout = props.currentLayout,
+    addWidget = props.addWidget,
+    _props$children = props.children,
+    children = _props$children === void 0 ? /*#__PURE__*/_jsx(Button, {
+      size: "small",
+      type: "primary",
+      icon: /*#__PURE__*/_jsx(PlusOutlined, {}),
+      style: {
+        marginLeft: '10px'
+      },
+      children: '添加'
+    }) : _props$children;
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    visible = _useState2[0],
+    setVisible = _useState2[1];
+  var _useState3 = useState(600),
+    _useState4 = _slicedToArray(_useState3, 1),
+    width = _useState4[0];
+  var _useState5 = useState([]),
+    _useState6 = _slicedToArray(_useState5, 2),
+    menuData = _useState6[0],
+    setMenuData = _useState6[1];
+  var _useState7 = useState(''),
+    _useState8 = _slicedToArray(_useState7, 2),
+    activeMenuKey = _useState8[0],
+    setActiveMenuKey = _useState8[1];
+  var _useState9 = useState(''),
+    _useState10 = _slicedToArray(_useState9, 2),
+    keywords = _useState10[0],
+    setKeywords = _useState10[1];
+
+  //计算左侧菜单
+  var handleCalcMenuData = useCallback(function () {
+    var tags = [];
+    Object.keys(widgets).map(function (key) {
+      var item = widgets[key];
+      tags.push.apply(tags, _toConsumableArray(item['tags']));
+    });
+    var tempObj = {};
+    tags.map(function (item) {
+      if (tempObj[item]) {
+        tempObj[item]['count']++;
+      } else {
+        tempObj[item] = {
+          title: item,
+          count: 1
+        };
+      }
+    });
+    var menuData = [];
+    Object.keys(tempObj).map(function (key, index, arr) {
+      menuData.push(tempObj[key]);
+    });
+    setMenuData(menuData);
+  }, [widgets]);
+
+  //菜单变化
+  var handleMenuChange = useCallback(function (item, index) {
+    setActiveMenuKey(item.title);
+  }, []);
+
+  //查询
+  var handleSearch = useCallback(function (value) {
+    setActiveMenuKey(menuData[0].title);
+    setKeywords(value);
+  }, [menuData]);
+  useEffect(function () {
+    handleCalcMenuData();
+  }, []);
+  var finWidgets = useMemo(function () {
+    return filterWidgets(widgets, currentLayout, keywords, activeMenuKey);
+  }, [currentLayout, widgets, keywords, activeMenuKey, visible]);
+  return /*#__PURE__*/_jsxs(_Fragment, {
+    children: [/*#__PURE__*/_jsx("div", {
+      style: {
+        display: 'inline-block'
+      },
+      onClick: function onClick() {
+        setVisible(true);
+      },
+      children: children
+    }), /*#__PURE__*/_jsx(Drawer
+    // className="react-dashboard-widget-selector"
+    , {
+      size: width,
+      title: /*#__PURE__*/_jsxs(_Fragment, {
+        children: [/*#__PURE__*/_jsx(AppstoreAddOutlined, {
+          style: {
+            margin: '0 5px'
+          }
+        }), '选择小程序']
+      }),
+      open: visible,
+      onClose: function onClose() {
+        setVisible(false);
+      },
+      footer: null,
+      styles: {
+        body: {
+          padding: 0
+        }
+      },
+      zIndex: 1006,
+      children: /*#__PURE__*/_jsxs("div", {
+        className: 'react-dashboard-widget-wrap',
+        children: [/*#__PURE__*/_jsxs("div", {
+          className: 'react-dashboard-widget-leftBar',
+          children: [/*#__PURE__*/_jsx(Search, {
+            placeholder: '请输入小程序名称',
+            value: keywords,
+            onSearch: handleSearch,
+            onChange: function onChange(e) {
+              return handleSearch(e.target.value);
+            },
+            prefix: /*#__PURE__*/_jsx(SearchOutlined, {
+              className: 'react-dashboard-widget-searchIcon'
+            }),
+            allowClear: true,
+            enterButton: true
+          }), /*#__PURE__*/_jsx("div", {
+            style: {
+              marginTop: 10
+            },
+            children: menuData.map(function (item, index) {
+              return /*#__PURE__*/_jsxs("div", {
+                className: classnames('react-dashboard-widget-item', activeMenuKey == item.title ? 'react-dashboard-widget-active' : ''),
+                onClick: function onClick() {
+                  return handleMenuChange(item, index);
+                },
+                children: [/*#__PURE__*/_jsx("div", {
+                  className: 'react-dashboard-widget-name',
+                  children: item['title']
+                }), /*#__PURE__*/_jsx("div", {
+                  className: 'react-dashboard-widget-Badge',
+                  children: item.count
+                })]
+              }, item.title);
+            })
+          })]
+        }), /*#__PURE__*/_jsx("div", {
+          className: classnames('react-dashboard-widget-Layer'),
+          style: {
+            height: '100%',
+            overflowY: 'auto'
+          },
+          children: !isEmpty(finWidgets) ? /*#__PURE__*/_jsx("div", {
+            className: "react-dashboard-widget-waterfall",
+            style: {
+              columnCount: Math.ceil((width - 200) / 200)
+            },
+            children: Object.keys(finWidgets).map(function (key) {
+              var item = finWidgets[key];
+              return /*#__PURE__*/_jsxs("div", {
+                className: classnames('react-dashboard-widget-item'),
+                style: {
+                  display: item.visible ? 'block' : 'none'
+                },
+                children: [/*#__PURE__*/_jsx("img", {
+                  src: item['snapShot'],
+                  className: 'react-dashboard-widget-shortcut'
+                }), /*#__PURE__*/_jsxs("div", {
+                  className: 'react-dashboard-widget-bottombar',
+                  children: [/*#__PURE__*/_jsx("div", {
+                    className: 'react-dashboard-widget-iconWrap',
+                    style: {
+                      backgroundColor: get(widgets, key + '.iconBackground'),
+                      backgroundImage: get(widgets, key + '.iconBackground')
+                    },
+                    children: item.icon
+                  }), /*#__PURE__*/_jsx("div", {
+                    className: 'react-dashboard-widget-name',
+                    children: item.name
+                  }), /*#__PURE__*/_jsx("div", {
+                    className: 'react-dashboard-widget-description',
+                    children: item.description
+                  })]
+                }), /*#__PURE__*/_jsx("div", {
+                  className: 'react-dashboard-widget-mask',
+                  children: item.length < item.maxLength ? /*#__PURE__*/_jsx(Button, {
+                    type: "primary",
+                    shape: "circle",
+                    icon: /*#__PURE__*/_jsx(PlusOutlined, {}),
+                    size: "large",
+                    onClick: function onClick() {
+                      return addWidget(item, key);
+                    }
+                  }) : /*#__PURE__*/_jsxs("div", {
+                    style: {
+                      padding: 20,
+                      color: '#fff',
+                      fontWeight: 'bold'
+                    },
+                    children: ['该小程序最多添加', item.maxLength, '个']
+                  })
+                })]
+              }, key);
+            })
+          }) : /*#__PURE__*/_jsx("div", {
+            className: "react-dashboard-widget-emptyContent",
+            style: {
+              minHeight: 'calc(100% - 20px)'
+            },
+            children: /*#__PURE__*/_jsx(Empty, {
+              description: /*#__PURE__*/_jsx("span", {
+                children: '该条件下暂无小程序'
+              })
+            })
+          })
+        })]
+      })
+    })]
+  });
+};
+export default WidgetSelector;

package/dist/esm/dashboard/widget/selector/index.less

@@ -0,0 +1,172 @@
+.react-dashboard-widget-selector{
+  position:fixed;
+  top:50%;
+  left:50%;
+  transform:translate(-50%, -50%);
+  z-index:1006;
+  width:60%;
+  height:60%;
+  max-width:800px;
+  max-height:600px;
+  background:var(--component-background);
+}
+
+.react-dashboard-widget-wrap {
+  display: flex;
+  height:100%;
+  
+  .react-dashboard-widget-leftBar {
+    padding: 10px;
+    width: 180px;
+    border-right: 1px solid rgba(0, 0, 0, 0.1);
+    background: var(--component-background);
+    .react-dashboard-widget-searchIcon {
+      color: var(--text-color);
+    }
+
+    .react-dashboard-widget-item {
+      display: flex;
+      justify-content: space-between;
+      padding: 10px;
+
+      .react-dashboard-widget-Badge {
+
+          .ant-badge-count {
+            color: var(--text-color);
+            background-color: var(--component-background-1) !important;
+          }
+        
+      }
+
+      cursor: pointer;
+
+      &:hover {
+        background: var(--component-background-3);
+        font-weight: bold;
+      }
+    }
+
+    .react-dashboard-widget-active {
+      background: rgba(0, 0, 0, 0.03);
+      font-weight: bold;
+    }
+  }
+
+  .react-dashboard-widget-Layer {
+    flex: 1 1;
+    overflow-y: auto;
+    overflow-x: hidden;
+    padding: 10px;
+    background: rgba(0, 0, 0, 0.01);
+    &::-webkit-scrollbar {
+      width: 1px;
+      height: 1px;
+      overflow: auto;
+    }
+  
+    &::-webkit-scrollbar-thumb {
+      background-color: var(--primary-color);
+      min-height: 25px;
+      min-width: 25px;
+  
+      &:hover {
+        background-color: #a8a8a8;
+      }
+  
+      &:active {
+        background-color: #787878;
+      }
+    }
+  
+    &::-webkit-scrollbar-track {
+      background-color: #f7f7f7;
+      border: 1px solid #efefef;
+    }
+
+      .react-dashboard-widget-waterfall {
+        width: 100%;
+      }
+
+      .ant-popover-inner-content {
+        background: rgba(0, 0, 0, 0.01);
+      }
+    
+
+    .react-dashboard-widget-item {
+      cursor: pointer;
+      height: auto;
+      margin-bottom: 10px;
+      width: 100%;
+      height: auto;
+      border-radius: 5px;
+      overflow: hidden;
+      // box-shadow: 0 0 0px rgba(255, 255, 255, 1);
+      transition: all 0.3s;
+      border: 1px solid rgba(0, 0, 0, 0.1);
+      -webkit-column-break-inside: avoid;
+      position: relative;
+      background: var(--component-background);
+      .react-dashboard-widget-shortcut {
+        width: 100%;
+        height: auto;
+      }
+
+      .react-dashboard-widget-mask {
+        opacity: 0;
+        position: absolute;
+        top: 0;
+        left: 0;
+        width: 100%;
+        height: 100%;
+        background: rgba(0, 0, 0, 0.5);
+        display: flex;
+        justify-content: center;
+        align-items: center;
+        transition: all 0.3s;
+      }
+
+      &:hover {
+        transition: all 0.3s;
+
+        border: 1px solid var(--component-background-3);
+
+        .react-dashboard-widget-mask {
+          opacity: 1;
+          transition: all 0.3s;
+        }
+      }
+
+      .react-dashboard-widget-bottombar {
+        border-top: 1px solid rgba(0, 0, 0, 0.1);
+        width: 100%;
+
+        padding: 5px;
+
+        .react-dashboard-widget-iconWrap {
+          display: inline-block;
+          width: 28px;
+          height: 28px;
+          line-height: 28px;
+          text-align: center;
+          border-radius: 7px;
+          color: #fff;
+          margin-right: 5px;
+          font-size: 16px;
+        }
+
+        .react-dashboard-widget-name {
+          font-size: 16px;
+          flex: 1;
+          color: var(--text-color);
+          line-height: 28px;
+          font-weight: bold;
+          display: inline;
+        }
+
+        .react-dashboard-widget-description {
+          margin-top: 5px;
+        }
+      }
+    }
+  }
+}

package/dist/esm/dashboard/widget/utils.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare const getWidgetType: (i: string, widgets: any) => string;
+export declare const ConfigBar: (props: any) => React.JSX.Element;
+export declare const ConfigWrap: (props: any, widgets?: any) => React.JSX.Element;

package/dist/esm/dashboard/widget/utils.js

@@ -0,0 +1,102 @@
+import { Drawer } from 'antd';
+import { get } from 'lodash';
+import React, { useCallback, useEffect, useMemo } from 'react';
+import { DeleteOutlined, SettingOutlined } from '@ant-design/icons';
+
+// import allWidgets from '../../widgets';
+//获取widget的类型
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Fragment as _Fragment } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+export var getWidgetType = function getWidgetType(i, widgets) {
+  var allWidgets = widgets;
+  var widgetType = '';
+  Object.keys(allWidgets).map(function (key) {
+    if (i.indexOf(key) >= 0) {
+      widgetType = key;
+    }
+  });
+  return widgetType;
+};
+
+//widget配置和删除按钮
+export var ConfigBar = function ConfigBar(props) {
+  var widgetKey = props.widgetKey,
+    editMode = props.editMode,
+    onDeleteWidget = props.onDeleteWidget,
+    _props$setConfigShow = props.setConfigShow,
+    setConfigShow = _props$setConfigShow === void 0 ? function () {} : _props$setConfigShow,
+    widgets = props.widgets;
+  var widgetType = getWidgetType(widgetKey, widgets);
+  return /*#__PURE__*/_jsxs(_Fragment, {
+    children: [editMode && /*#__PURE__*/_jsx("div", {
+      className: 'react-dashboard-mask'
+    }), editMode && get('widgets', widgetType + '.configComponent') && /*#__PURE__*/_jsx("div", {
+      className: 'react-dashboard-configicon',
+      onClick: function onClick() {
+        return setConfigShow(true);
+      },
+      children: /*#__PURE__*/_jsx(SettingOutlined, {})
+    }), editMode && /*#__PURE__*/_jsx("div", {
+      className: 'react-dashboard-deleteicon',
+      onClick: function onClick() {
+        return onDeleteWidget();
+      },
+      children: /*#__PURE__*/_jsx(DeleteOutlined, {})
+    })]
+  });
+};
+
+//config的容器
+export var ConfigWrap = function ConfigWrap(props) {
+  var widgets = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : props.widgets || {};
+  var widgetKey = props.widgetKey,
+    visible = props.visible,
+    setVisible = props.setVisible,
+    width = props.width,
+    children = props.children;
+  var afterVisibleChange = useCallback(function (visible) {
+    if (visible) {
+      var widgetConfigPanel = document.getElementsByClassName('widgetConfigPanel')[0];
+      widgetConfigPanel && widgetConfigPanel.addEventListener('mousedown', function (e) {
+        e.stopPropagation();
+      });
+    } else {
+      var _widgetConfigPanel = document.getElementsByClassName('widgetConfigPanel')[0];
+      _widgetConfigPanel && _widgetConfigPanel.removeEventListener('mousedown', function (e) {
+        e.stopPropagation();
+      });
+    }
+  }, [visible]);
+  var title = useMemo(function () {
+    if (!widgetKey) {
+      return;
+    }
+    var widgetType = getWidgetType(widgetKey, widgets);
+    return get(widgets, widgetType + '.name') + '设置';
+  }, [widgetKey, widgets, getWidgetType]);
+  useEffect(function () {
+    afterVisibleChange(visible);
+  }, [visible]);
+  return /*#__PURE__*/_jsx(_Fragment, {
+    children: visible && /*#__PURE__*/_jsx(Drawer, {
+      className: "react-dashboard-widgetConfigPanel",
+      title: title,
+      placement: "right",
+      closable: true,
+      onClose: function onClose() {
+        return setVisible(false);
+      },
+      open: visible,
+      size: width,
+      styles: {
+        body: {
+          padding: '0px'
+        }
+      },
+      afterOpenChange: afterVisibleChange,
+      zIndex: 1005,
+      children: children
+    })
+  });
+};

package/dist/esm/dateCellEditor/DateCellEditor.d.ts

@@ -0,0 +1,53 @@
+import type { CustomCellEditorProps } from 'ag-grid-react';
+import type { Dayjs } from 'dayjs';
+import React from 'react';
+/** 默认的显示与提交格式。 @author nokecy */
+export declare const DEFAULT_DATE_CELL_FORMAT = "YYYY-MM-DD";
+/**
+ * 日期单元格编辑器的可选参数，通过列定义的 `cellEditorParams` 传入。
+ * @author nokecy
+ */
+export interface DateCellEditorParams {
+    /** 显示与提交的日期格式，默认 `YYYY-MM-DD`；初始值优先按此格式严格解析，ISO 日期时间也可识别。 */
+    format?: string;
+    /** 禁用日期的判断函数，语义与 antd `DatePicker` 的 `disabledDate` 一致。 */
+    disabledDate?: (current: Dayjs) => boolean;
+    /** 是否允许清空；为 `true` 时清空并提交 `null`，默认 `false`。 */
+    allowClear?: boolean;
+    /**
+     * 进入编辑时是否自动展开日期面板，默认 `true`：键盘到达即展开，保持原有行为。
+     * 只想聚焦输入、直接键入覆盖时传 `false`。
+     */
+    defaultOpen?: boolean;
+}
+/**
+ * 日期单元格编辑器的完整属性：AG Grid 编辑器属性与 {@link DateCellEditorParams} 的合并。
+ * @author nokecy
+ */
+export type DateCellEditorProps = CustomCellEditorProps<any, string | null> & DateCellEditorParams;
+/**
+ * 将单元格值解析为 dayjs 对象。空值或无法识别的值返回 `undefined`，选择器显示为空而不抛错。
+ * @param value 单元格值，通常为 `YYYY-MM-DD` 字符串
+ * @param format 值格式，用于严格解析字符串
+ * @returns 有效的日期对象，否则返回 `undefined`
+ * @author nokecy
+ */
+export declare function parseDateCellValue(value: unknown, format: string): Dayjs | undefined;
+/**
+ * 通用日期单元格编辑器（antd DatePicker 版），用于 AG Grid 的自定义单元格编辑。
+ *
+ * 使用方式：列定义设置 `cellEditor: DateCellEditor, cellEditorPopup: true`，需要参数时通过 `cellEditorParams` 传入
+ * `format`、`disabledDate`、`allowClear`。
+ *
+ * 行为要点：
+ * - 下拉面板挂在编辑器自身容器内，避免表格把面板点击当作“点到编辑器外”而提前结束编辑。
+ * - 选中日期后先写入值，再通过 `setTimeout` 调用 `stopEditing()` 提交，保证表格取到新日期。
+ * - 按 Esc 调用 `stopEditing(true)` 取消编辑。
+ * - 清空仅在 `allowClear` 为 `true` 时生效，并提交 `null`。
+ *
+ * @param props AG Grid 编辑器属性与日期选项
+ * @returns 日期选择器
+ * @author nokecy
+ */
+export declare const DateCellEditor: React.FC<DateCellEditorProps>;
+export default DateCellEditor;