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

package/dist/cjs/ag-grid-plus/queryForm/queryForm.js

@@ -0,0 +1,162 @@
+"use strict";
+
+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); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getQueryCapacity = exports.default = exports.QueryFormMetaContext = exports.QUERY_MAX_COLUMNS = exports.QUERY_ITEM_WIDTH = void 0;
+var _icons = require("@ant-design/icons");
+var _formilyAntd = require("@nokecy/formily-antd");
+var _formilyReact = require("@nokecy/formily-react");
+var _antd = require("antd");
+var _react = _interopRequireWildcard(require("react"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+/** 查询区外显条件数的上限（DESIGN.md §8）。 */
+var QUERY_MAX_COLUMNS = exports.QUERY_MAX_COLUMNS = 8;
+/** 单个查询项占的最小宽度（px），外显条数 = floor(可用宽度 / 它)，封顶 QUERY_MAX_COLUMNS。 */
+var QUERY_ITEM_WIDTH = exports.QUERY_ITEM_WIDTH = 240;
+
+/** 折叠时外显的条件数：按钮区在表格之外，不再占一格。 */
+var getQueryCapacity = exports.getQueryCapacity = function getQueryCapacity(maxRows, columns) {
+  return Math.max(1, maxRows * Math.max(1, columns));
+};
+
+/** 查询区当前应用的方案名等元信息，经 context 传给查询区，不走 schema。 */
+var QueryFormMetaContext = exports.QueryFormMetaContext = /*#__PURE__*/_react.default.createContext({});
+var useCollapseGrid = function useCollapseGrid(maxRows, defaultExpand) {
+  var grid = (0, _react.useMemo)(function () {
+    return _formilyAntd.FormGrid.createFormGrid({
+      // 外显条数随宽度增长，宽屏不再卡在 4 个。@author nokecy
+      maxColumns: QUERY_MAX_COLUMNS,
+      minWidth: QUERY_ITEM_WIDTH,
+      maxWidth: QUERY_ITEM_WIDTH,
+      maxRows: defaultExpand ? Infinity : maxRows,
+      shouldVisible: function shouldVisible(node, grid) {
+        // 展开状态时，显示所有元素
+        if (grid.maxRows === Infinity) return true;
+        // 查询、重置按钮在表格之外，表格里只有查询项，按当前响应式列数计算首行外显。
+        return node.index !== undefined && node.index < getQueryCapacity(maxRows, grid.columns);
+      }
+    });
+  }, [maxRows, defaultExpand] // 添加依赖项
+  );
+  var expanded = grid.maxRows === Infinity;
+  // 根据完整查询项数量判断，折叠、外部重渲染和容器变宽都不会丢失入口。@author nokecy
+  var capacity = getQueryCapacity(maxRows, grid.columns);
+  var collapsible = grid.childSize > capacity;
+  var toggle = function toggle() {
+    if (grid.maxRows === Infinity) {
+      grid.maxRows = maxRows;
+    } else {
+      grid.maxRows = Infinity;
+    }
+  };
+  return {
+    grid: grid,
+    expanded: expanded,
+    toggle: toggle,
+    collapsible: collapsible
+  };
+};
+var QueryForm = (0, _formilyReact.observer)(function (props) {
+  var onReset = props.onReset,
+    _props$defaultExpand = props.defaultExpand,
+    defaultExpand = _props$defaultExpand === void 0 ? false : _props$defaultExpand,
+    _props$defaultRows = props.defaultRows,
+    defaultRows = _props$defaultRows === void 0 ? 1 : _props$defaultRows;
+  var _useCollapseGrid = useCollapseGrid(defaultRows, defaultExpand),
+    grid = _useCollapseGrid.grid,
+    expanded = _useCollapseGrid.expanded,
+    toggle = _useCollapseGrid.toggle,
+    collapsible = _useCollapseGrid.collapsible;
+  var renderActions = function renderActions() {
+    return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_react.Fragment, {
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_formilyAntd.Submit, {
+        type: "primary",
+        icon: /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.SearchOutlined, {}),
+        children: "\u67E5\u8BE2"
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Button, {
+        icon: /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.ClearOutlined, {}),
+        onClick: onReset,
+        children: "\u91CD\u7F6E"
+      })]
+    });
+  };
+  var renderExpanded = function renderExpanded() {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)("a", {
+      href: "#",
+      "aria-expanded": expanded,
+      onClick: function onClick(e) {
+        e.preventDefault();
+        toggle();
+      },
+      children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+        children: [expanded ? "收起" : "展开", /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.DownOutlined, {
+          style: {
+            marginLeft: "0.5em",
+            transition: "0.3s all",
+            transform: "rotate(".concat(expanded ? 0 : 0.5, "turn)")
+          }
+        })]
+      })
+    });
+  };
+  var _useContext = (0, _react.useContext)(QueryFormMetaContext),
+    schemeName = _useContext.schemeName;
+  var renderButtonGroup = function renderButtonGroup() {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_react.Fragment, {
+      children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_formilyAntd.FormButtonGroup, {
+        align: "right",
+        children: [schemeName ? /*#__PURE__*/(0, _jsxRuntime.jsxs)("span", {
+          "data-query-scheme-name": true,
+          title: schemeName,
+          style: {
+            maxWidth: 160,
+            overflow: "hidden",
+            textOverflow: "ellipsis",
+            whiteSpace: "nowrap"
+          },
+          children: ["\u65B9\u6848\uFF1A", schemeName]
+        }) : null, renderActions(), collapsible ? renderExpanded() : null]
+      })
+    });
+  };
+
+  // 按钮区放在表格之外、固定在首行右侧：展开/收起只改变条件行数，不改变按钮位置（§8）。窄屏时换到条件下方。
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+    "data-query-form": true,
+    style: {
+      display: "flex",
+      flexWrap: "wrap",
+      alignItems: "flex-start",
+      gap: 8,
+      width: "100%"
+    },
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+      style: {
+        flex: "1 1 480px",
+        minWidth: 0
+      },
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_formilyAntd.FormGrid, {
+        grid: grid,
+        colWrap: true,
+        strictAutoFit: true,
+        children: props.children
+      })
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+      "data-query-actions": true,
+      style: {
+        flex: "0 0 auto",
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "flex-end",
+        minHeight: 32,
+        marginInlineStart: "auto"
+      },
+      children: renderButtonGroup()
+    })]
+  });
+});
+var _default = exports.default = QueryForm;

package/dist/cjs/ag-grid-plus/queryForm/queryValues.d.ts

@@ -0,0 +1,9 @@
+/** 去掉空值并转成可持久化的普通对象（dayjs 经 toJSON 变为 ISO 字符串）。 */
+export declare function serializeQueryValues(values: Record<string, any> | undefined): Record<string, any>;
+/** 应用方案时还原值：日期字段（含区间）从字符串转回 dayjs，其余原样。 */
+export declare function reviveQueryValues(values: Record<string, any> | undefined, dateFields: ReadonlySet<string>): Record<string, any>;
+/** 查询区向外暴露的操作句柄，供查询方案管理读写条件值。 */
+export interface QueryFormApi {
+    /** 当前条件值（已去空、可持久化） */
+    getValues: () => Record<string, any>;
+}

package/dist/cjs/ag-grid-plus/queryForm/queryValues.js

@@ -0,0 +1,61 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.reviveQueryValues = reviveQueryValues;
+exports.serializeQueryValues = serializeQueryValues;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+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; }
+/**
+ * 查询区条件值与查询方案之间的序列化：
+ * 保存时只留有意义的值并转成可 JSON 化的形态，应用时把日期字段还原回 dayjs。
+ * 存的是查询区表单值，不是列头筛选。@author nokecy
+ */
+
+var isEmptyValue = function isEmptyValue(value) {
+  return value === undefined || value === null || value === '' || Array.isArray(value) && value.every(isEmptyValue);
+};
+
+/** 去掉空值并转成可持久化的普通对象（dayjs 经 toJSON 变为 ISO 字符串）。 */
+function serializeQueryValues(values) {
+  var result = {};
+  Object.entries(values !== null && values !== void 0 ? values : {}).forEach(function (_ref) {
+    var _ref2 = _slicedToArray(_ref, 2),
+      name = _ref2[0],
+      value = _ref2[1];
+    if (isEmptyValue(value)) return;
+    var plain = JSON.parse(JSON.stringify(value));
+    if (!isEmptyValue(plain)) result[name] = plain;
+  });
+  return result;
+}
+var reviveDate = function reviveDate(value) {
+  if (typeof value !== 'string' && typeof value !== 'number') return value;
+  var parsed = (0, _dayjs.default)(value);
+  return parsed.isValid() ? parsed : value;
+};
+
+/** 应用方案时还原值：日期字段（含区间）从字符串转回 dayjs，其余原样。 */
+function reviveQueryValues(values, dateFields) {
+  var result = {};
+  Object.entries(values !== null && values !== void 0 ? values : {}).forEach(function (_ref3) {
+    var _ref4 = _slicedToArray(_ref3, 2),
+      name = _ref4[0],
+      value = _ref4[1];
+    if (!dateFields.has(name)) {
+      result[name] = value;
+    } else {
+      result[name] = Array.isArray(value) ? value.map(reviveDate) : reviveDate(value);
+    }
+  });
+  return result;
+}
+
+/** 查询区向外暴露的操作句柄，供查询方案管理读写条件值。 */

package/dist/cjs/ag-grid-plus/queryForm/schemaKey.d.ts

@@ -0,0 +1,27 @@
+type ColumnStateLike = {
+    colId?: string | null;
+    hide?: boolean | null;
+};
+type QueryColumnLike = {
+    field?: string;
+    colId?: string;
+    queryField?: string;
+    headerName?: string;
+    searchTitle?: string;
+    hide?: boolean;
+    hideInSearch?: boolean;
+    hideInTable?: boolean;
+    visible?: boolean;
+    filter?: unknown;
+    type?: unknown;
+    enum?: unknown;
+    searchComponent?: unknown;
+    searchComponentProps?: unknown;
+};
+/**
+ * 查询区只在有效查询元数据变化时更新 schema，列宽、固定位置和排序不参与。
+ * 接受列状态参数以兼容原调用方；表单传入已经合并状态的有效查询列快照。
+ * @author nokecy
+ */
+export declare const queryFormSchemaKey: (columnStates?: readonly ColumnStateLike[] | null, colDefs?: readonly QueryColumnLike[] | null) => string;
+export {};

package/dist/cjs/ag-grid-plus/queryForm/schemaKey.js

@@ -0,0 +1,77 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.queryFormSchemaKey = void 0;
+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 referenceIds = new WeakMap();
+var nextReferenceId = 1;
+
+/** 保持组件、回调及非普通对象的引用标识稳定。@author nokecy */
+var referenceKey = function referenceKey(value) {
+  if (!referenceIds.has(value)) referenceIds.set(value, nextReferenceId++);
+  return referenceIds.get(value);
+};
+
+/**
+ * 对查询元数据生成稳定签名：普通对象按内容比较，组件与回调按引用比较。
+ * 排除 React 元素的内部 owner；循环引用只终止当前分支。
+ * @author nokecy
+ */
+var metadataKey = function metadataKey(value) {
+  var ancestors = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : new Set();
+  if (typeof value === 'function') return "function:".concat(referenceKey(value));
+  if (value === null || _typeof(value) !== 'object') return "".concat(_typeof(value), ":").concat(JSON.stringify(String(value)));
+  if (ancestors.has(value)) return 'circular';
+  if (value instanceof Date) return "date:".concat(value.getTime());
+  var nextAncestors = new Set(ancestors).add(value);
+  if (Array.isArray(value)) return "[".concat(value.map(function (item) {
+    return metadataKey(item, nextAncestors);
+  }).join(','), "]");
+  var prototype = Object.getPrototypeOf(value);
+  if (prototype !== Object.prototype && prototype !== null) return "reference:".concat(referenceKey(value));
+  var object = value;
+  var keys = Object.keys(object).filter(function (key) {
+    return !object.$$typeof || key !== '_owner';
+  }).sort();
+  return "{".concat(keys.map(function (key) {
+    return "".concat(JSON.stringify(key), ":").concat(metadataKey(object[key], nextAncestors));
+  }).join(','), "}");
+};
+
+/**
+ * 查询区只在有效查询元数据变化时更新 schema，列宽、固定位置和排序不参与。
+ * 接受列状态参数以兼容原调用方；表单传入已经合并状态的有效查询列快照。
+ * @author nokecy
+ */
+var queryFormSchemaKey = exports.queryFormSchemaKey = function queryFormSchemaKey(columnStates, colDefs) {
+  return metadataKey({
+    states: columnStates === null || columnStates === void 0 ? void 0 : columnStates.map(function (_ref) {
+      var colId = _ref.colId,
+        hide = _ref.hide;
+      return {
+        colId: colId,
+        hide: hide
+      };
+    }),
+    columns: colDefs === null || colDefs === void 0 ? void 0 : colDefs.map(function (column) {
+      var _column$searchTitle;
+      return {
+        field: column.field,
+        colId: column.colId,
+        queryField: column.queryField,
+        title: (_column$searchTitle = column.searchTitle) !== null && _column$searchTitle !== void 0 ? _column$searchTitle : column.headerName,
+        hide: column.hide,
+        hideInSearch: column.hideInSearch,
+        hideInTable: column.hideInTable,
+        visible: column.visible,
+        filter: column.filter,
+        type: column.type,
+        enum: column.enum,
+        searchComponent: column.searchComponent,
+        searchComponentProps: column.searchComponentProps
+      };
+    })
+  });
+};

package/dist/cjs/ag-grid-plus/rowColors.d.ts

@@ -0,0 +1,12 @@
+/** 主色占 percent%，其余为白。 */
+export declare const mixWithWhite: (hex: string, percent: number) => string;
+export interface GridRowColors {
+    hover: string;
+    selected: string;
+    selectedHover: string;
+}
+/**
+ * @param primary 主色，非 6 位 hex 时返回 undefined，由调用方退回 antd token
+ * @param linkText 浅底文字（链接色），缺省按主色
+ */
+export declare function deriveRowColors(primary: string, linkText?: string): GridRowColors | undefined;

package/dist/cjs/ag-grid-plus/rowColors.js

@@ -0,0 +1,58 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.deriveRowColors = deriveRowColors;
+exports.mixWithWhite = void 0;
+var _contrast = require("../shared/contrast");
+/**
+ * 悬浮行 / 选中行 / 选中且悬浮行底色（DESIGN.md §3.5）：主色朝白混合，
+ * 浅底文字（链接色）压其上必须 ≥ 4.5:1，不达标就逐步变浅。
+ * 不直接用 antd 的 colorPrimaryBg 系列：那是对主色的通用派生，绿主题下链接压其上只有 2.3~2.9。
+ * @author nokecy
+ */
+
+var HEX = /^#[0-9a-f]{6}$/i;
+var toHexRgb = function toHexRgb(hex) {
+  var v = parseInt(hex.slice(1), 16);
+  return [v >> 16 & 255, v >> 8 & 255, v & 255];
+};
+
+/** 主色占 percent%，其余为白。 */
+var mixWithWhite = exports.mixWithWhite = function mixWithWhite(hex, percent) {
+  var rgb = toHexRgb(hex);
+  var out = rgb.map(function (c) {
+    return Math.round(255 - (255 - c) * (percent / 100));
+  });
+  return "#".concat(out.map(function (c) {
+    return c.toString(16).padStart(2, '0');
+  }).join(''));
+};
+
+/** 悬浮 6% / 选中 9% / 选中且悬浮 14%（对应规范的 94% / 91% / 86% 起混白）。 */
+var START = {
+  hover: 6,
+  selected: 9,
+  selectedHover: 14
+};
+/**
+ * @param primary 主色，非 6 位 hex 时返回 undefined，由调用方退回 antd token
+ * @param linkText 浅底文字（链接色），缺省按主色
+ */
+function deriveRowColors(primary, linkText) {
+  if (!HEX.test(primary)) return undefined;
+  var text = linkText && HEX.test(linkText) ? linkText : primary;
+  var pick = function pick(start) {
+    for (var p = start; p > 0; p--) {
+      var bg = mixWithWhite(primary, p);
+      if ((0, _contrast.contrastRatio)(text, bg) >= 4.5) return bg;
+    }
+    return '#ffffff';
+  };
+  return {
+    hover: pick(START.hover),
+    selected: pick(START.selected),
+    selectedHover: pick(START.selectedHover)
+  };
+}

package/dist/cjs/ag-grid-plus/setting/ColumnConfigForm.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 列配置表单组件
+ * 使用 Formily ArrayTable 展示和编辑列配置
+ * 支持表头分组的树形结构展示
+ */
+import React from 'react';
+import { Form } from '@nokecy/formily-core';
+interface ColumnConfigFormProps {
+    form: Form;
+    onDeleteNode: (nodeId: string) => void;
+}
+/**
+ * 列配置表单组件
+ */
+declare const ColumnConfigForm: React.FC<ColumnConfigFormProps>;
+export default ColumnConfigForm;