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

package/dist/esm/ag-grid-plus/index.less

@@ -0,0 +1,56 @@
+.grid-spin {
+  height: 100%;
+
+  .ant-spin-container {
+    height: 100%;
+  }
+}
+
+.ag-icon-filter:before {
+  -webkit-mask-image: url(data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBzdGFuZGFsb25lPSJubyI/PjwhRE9DVFlQRSBzdmcgUFVCTElDICItLy9XM0MvL0RURCBTVkcgMS4xLy9FTiIgImh0dHA6Ly93d3cudzMub3JnL0dyYXBoaWNzL1NWRy8xLjEvRFREL3N2ZzExLmR0ZCI+PHN2ZyB0PSIxNzIzNjg0NDAwMDY0IiBjbGFzcz0iaWNvbiIgdmlld0JveD0iMCAwIDEwMjQgMTAyNCIgdmVyc2lvbj0iMS4xIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHAtaWQ9IjI0MjgiIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB3aWR0aD0iMjAwIiBoZWlnaHQ9IjIwMCI+PHBhdGggZD0iTTMyNS43MTQyODYgODg0LjU3MTQyOWMwIDIwLjIyODU3MSAxNi4yMjg1NzEgMzYuNTcxNDI5IDM2LjM0Mjg1NyAzNi41NzE0MjhoMjk5Ljg4NTcxNGMyMC4xMTQyODYgMCAzNi4zNDI4NTctMTYuMzQyODU3IDM2LjM0Mjg1Ny0zNi41NzE0MjhWNjYwLjU3MTQyOUgzMjUuNzE0Mjg2djIyNHogbTYwNi45NzE0MjgtNzgxLjcxNDI4Nkg5MS4zMTQyODZjLTI4IDAtNDUuNDg1NzE0IDMwLjUxNDI4Ni0zMS40Mjg1NzIgNTQuODU3MTQzbDI1Mi45MTQyODYgNDI5LjcxNDI4NWgzOTguNjI4NTcxbDI1Mi45MTQyODYtNDI5LjcxNDI4NWMxMy44Mjg1NzEtMjQuMzQyODU3LTMuNjU3MTQzLTU0Ljg1NzE0My0zMS42NTcxNDMtNTQuODU3MTQzeiIgcC1pZD0iMjQyOSIgZmlsbD0iIzhhOGE4YSI+PC9wYXRoPjwvc3ZnPg==) !important;
+
+  mask-image: url(data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBzdGFuZGFsb25lPSJubyI/PjwhRE9DVFlQRSBzdmcgUFVCTElDICItLy9XM0MvL0RURCBTVkcgMS4xLy9FTiIgImh0dHA6Ly93d3cudzMub3JnL0dyYXBoaWNzL1NWRy8xLjEvRFREL3N2ZzExLmR0ZCI+PHN2ZyB0PSIxNzIzNjg0NDAwMDY0IiBjbGFzcz0iaWNvbiIgdmlld0JveD0iMCAwIDEwMjQgMTAyNCIgdmVyc2lvbj0iMS4xIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHAtaWQ9IjI0MjgiIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB3aWR0aD0iMjAwIiBoZWlnaHQ9IjIwMCI+PHBhdGggZD0iTTMyNS43MTQyODYgODg0LjU3MTQyOWMwIDIwLjIyODU3MSAxNi4yMjg1NzEgMzYuNTcxNDI5IDM2LjM0Mjg1NyAzNi41NzE0MjhoMjk5Ljg4NTcxNGMyMC4xMTQyODYgMCAzNi4zNDI4NTctMTYuMzQyODU3IDM2LjM0Mjg1Ny0zNi41NzE0MjhWNjYwLjU3MTQyOUgzMjUuNzE0Mjg2djIyNHogbTYwNi45NzE0MjgtNzgxLjcxNDI4Nkg5MS4zMTQyODZjLTI4IDAtNDUuNDg1NzE0IDMwLjUxNDI4Ni0zMS40Mjg1NzIgNTQuODU3MTQzbDI1Mi45MTQyODYgNDI5LjcxNDI4NWgzOTguNjI4NTcxbDI1Mi45MTQyODYtNDI5LjcxNDI4NWMxMy44Mjg1NzEtMjQuMzQyODU3LTMuNjU3MTQzLTU0Ljg1NzE0My0zMS42NTcxNDMtNTQuODU3MTQzeiIgcC1pZD0iMjQyOSIgZmlsbD0iIzhhOGE4YSI+PC9wYXRoPjwvc3ZnPg==) !important;
+
+  color: #8a8a8a;
+}
+
+.ag-row-group {
+  display: flex;
+  align-items: center;
+  padding-left: 16px;
+}
+
+.jf-anticon {
+  cursor: pointer;
+  display: inline-block;
+  box-sizing: border-box;
+  margin-right: 16rpx;
+}
+
+.ag-root-wrapper-body .ag-center-cols-viewport .ag-center-cols-container .ag-checkbox .ag-checkbox-input-wrapper {
+  width: 16px !important;
+  height: 16px !important;
+}
+.ag-root-wrapper-body .ag-header-viewport .ag-checkbox .ag-checkbox-input-wrapper {
+  width: 16px !important;
+  height: 16px !important;
+}
+
+// 列内容对齐方式样式
+.custom-cell-left {
+  text-align: left !important;
+}
+
+.custom-cell-centered {
+  text-align: center !important;
+}
+
+.custom-cell-right {
+  text-align: right !important;
+}
+
+// 空态浮层里的「重试」「新建」「清空筛选」要能点：AG-Grid 给 .ag-overlay 设了 pointer-events: none，
+// 只给加载浮层放开，空态浮层里的按钮因此点不到。只放开可交互元素，空白处仍穿透到表格。@author nokecy
+.ag-overlay-no-rows-wrapper :is(button, a, input, [role='button']) {
+  pointer-events: auto;
+}

package/dist/esm/ag-grid-plus/interface.d.ts

@@ -0,0 +1,208 @@
+import { GridApi, ColDef, ColGroupDef, ICellRendererParams } from "ag-grid-community";
+import { AgGridReactProps } from "ag-grid-react";
+import React, { CSSProperties, ReactNode } from "react";
+import type { GridPlusError } from "./errors/index";
+import type { EmptyStateTexts } from "./utils/emptyState";
+import type { DateQueryPrecisionResolver } from "./queryForm/datePrecision";
+interface GridRef {
+    onRefresh: () => void;
+}
+interface GridProps extends AgGridReactProps {
+    /**
+     * 为 true 时，`valueEnum[].color` 按当前主题底色自动收成够读（WCAG 正文 4.5:1）的 CSS 色：
+     * 语义档名（success/warning…）与预设名（cyan/pink…）换成真实色值，过浅的 hex 压暗（深色主题则提亮），
+     * 缺省色写成 `inherit`。默认 false：color 按 CSS 原样输出，保持既有行为。@author nokecy
+     */
+    valueEnumContrast?: boolean;
+    /**
+     * 推断未声明 queryDatePrecision 的列的查询日期精度（如按宿主的审计字段命名约定）。
+     * 不传时只按列声明（控件属性、queryDatePrecision、列类型、筛选器）判定。@author nokecy
+     */
+    dateQueryPrecision?: DateQueryPrecisionResolver;
+    hideTool?: boolean;
+    style?: CSSProperties;
+    params?: any;
+    initParams?: any;
+    loading?: boolean;
+    request?: (params: any, sort: any, filter: any) => Promise<any>;
+    dataSource?: any[];
+    treeKeyName?: string;
+    treeParentName?: string;
+    search?: boolean;
+    headerTitle?: React.ReactNode;
+    columnDefs?: (AgGridColumnPropsClone | ColGroupDef<any>)[] | null;
+    toolBarRender?: (gridApi?: GridApi, filter?: string, queryFilter?: any, paginationInfo?: {
+        /** @deprecated 改用 page */
+        current: number;
+        /** @deprecated 改用 page/pageSize */
+        skipCount: number;
+        /** @deprecated 改用 page/pageSize */
+        maxResultCount: number;
+        /** 当前页码（1-based）
+         * @author nokecy */
+        page?: number;
+        /** 每页条数
+         * @author nokecy */
+        pageSize?: number;
+    }) => React.ReactNode[];
+    defaultSearchExpand?: Boolean;
+    /**
+     * 用于标识grid唯一标识，用于保存列方案
+     */
+    gridKey?: string;
+    /**
+     * 列方案
+     */
+    gridColumnState?: any[];
+    /**
+     * 列表空数据文字提示。
+     * 传了它就一律用它（最高优先级），保持既有调用点行为不变；
+     * 想按「无数据 / 筛选无结果 / 无权限 / 加载失败」分别给文案，用 `emptyState`。
+     */
+    overlayNoRowsTemplateText?: string;
+    /**
+     * 空态四分文案覆盖：{ noData, noResult, noPermission, error }。
+     * 不传就用内置默认：加载失败说加载失败并给「重试」，没筛选就说「暂无数据」，
+     * 不再一律引导用户去调筛选条件。
+     * @author nokecy
+     */
+    emptyState?: EmptyStateTexts;
+    /**
+     * 当前用户是否有权查看该列表。传 false 时空态说「没有权限」而不是「暂无数据」，
+     * 免得用户以为是数据还没录进来。
+     * @author nokecy
+     */
+    accessible?: boolean;
+    /**
+     * 查询Form默认展示行数
+     */
+    queryDefaultRows?: number;
+    /**
+     * 列表分页选择配置
+     */
+    pageSizeOptions?: number[];
+    /**
+     * 分页大小，支持外部传入，优先级高于pageSizeOptions的默认值
+     */
+    pageSize?: number;
+    hidePagination?: boolean;
+    gridRef?: React.Ref<GridRef | undefined>;
+    /**
+     * 选中行变化回调函数
+     */
+    onSelectedRowsChange?: (selectedRows: any[]) => void;
+    /**
+     * 查询区条件值变化时回调（输入、默认值落位、重置都会触发），参数为当前条件快照，以查询字段名为键。
+     * 只通知、不发起查询；宿主可据此与上次查询用的条件比较，提示「条件已变更，请查询」。
+     * @author nokecy
+     */
+    onQueryValuesChange?: (values: Record<string, any>) => void;
+    /**
+     * 错误处理回调函数
+     * 当组件发生错误时调用，可用于自定义错误处理逻辑
+     */
+    onError?: (error: GridPlusError) => void;
+    /**
+     * 是否启用点击行选择功能
+     * - true: 启用行点击选择（默认）
+     * - false: 禁用点击行选择（仅复选框可选择）
+     *
+     * 默认值: true
+     *
+     * AG-Grid v33+ 默认行为：
+     * 1. **默认单选模式** (`mode: 'singleRow'`)
+     * 2. 点击行即可选择/取消选择
+     * 3. 用户可通过 `rowSelection` prop 覆盖为多选模式
+     *
+     * 多选模式示例：
+     * ```tsx
+     * <AgGridPlus
+     *   rowSelection={{ mode: 'multiRow', enableSelectionWithoutKeys: true }}
+     *   // 或使用旧 API
+     *   rowSelection="multiple"
+     * />
+     * ```
+     *
+     * 内部实现：
+     * - 使用 v33+ 对象化 rowSelection API
+     * - 自动配置 enableClickSelection
+     * - 多选模式下自动配置 enableSelectionWithoutKeys
+     * - 兼容旧的字符串 API（'single' | 'multiple'）
+     */
+    enableClickSelection?: boolean;
+    /**
+     * 是否使用 AG-Grid 原生树形数据过滤
+     * - true: 使用原生 treeDataParentIdField 配置，列头过滤器可以过滤所有层级的数据
+     * - false: 使用旧的 flatten(toTree()) 逻辑（默认，保持兼容）
+     *
+     * @default false
+     */
+    useNativeTreeFilter?: boolean;
+    /**
+     * 实体类型全名，用于自动注入扩展字段列
+     * 当配置此属性时，组件会自动从 context 的 hostEntityExtensions
+     * 获取对应实体的扩展字段并转换为列定义
+     *
+     * @example "Burn.Product.Domain.Product"
+     * @author nokecy
+     */
+    entityType?: string;
+}
+interface AgGridColumnPropsClone extends ColDef {
+    /**
+     * 是否精确查询
+     */
+    exactQuery?: boolean;
+    hideInTable?: boolean;
+    hideInSearch?: boolean;
+    queryField?: string;
+    /** 查询区独立标题；优先于列方案中的表头名称。@author nokecy */
+    searchTitle?: string;
+    /**
+     * 是否文本缩略显示,并使用tooltip
+     */
+    ellipsis?: boolean;
+    /**
+     * 枚举值配置，支持数组形式：
+     * [
+     *   { value: any, label: string, color?: string, default?: boolean }
+     * ]
+     * - 用于渲染查询下拉、标签、过滤等
+     * - 支持设置默认值（default: true）
+     * - 支持多选（多个 default: true）
+     */
+    valueEnum?: Array<{
+        value: any;
+        label: string;
+        color?: string;
+        default?: boolean;
+    }>;
+    /**
+     * `valueEnum` **未命中**时的渲染接管（`null` / `undefined` / 空串 / 后端新增码值都走这里）。
+     *
+     * 不传则原样输出该值（历史行为，向后兼容）。业务侧用它输出中性「—」/「未知（原码）」：
+     * ```tsx
+     * enumFallbackRenderer: ({ value }) => <span style={{ color: '#595959' }}>{enumDisplayText(value)}</span>
+     * ```
+     * 命中枚举项时不会调用它（那一支有固定的上色渲染）。
+     */
+    enumFallbackRenderer?: (params: ICellRendererParams) => ReactNode;
+    searchComponent?: ReactNode | React.JSX.Element | ((props: any) => React.JSX.Element);
+    searchComponentProps?: any;
+    searchSort?: number;
+    enum?: {
+        value: any;
+        label: any;
+    }[];
+    /**
+     * 列计算类型配置
+     * - "sum": 求和计算
+     * - "avg": 平均值计算
+     * - "standardDeviation": 标准差计算
+     * - false: 禁用计算
+     * 当设置后，会在表格底部固定行显示计算结果
+     */
+    calculateType?: "sum" | "avg" | "standardDeviation" | false;
+}
+declare function AgGridColumn(props: AgGridColumnPropsClone | ColGroupDef): React.JSX.Element;
+export { GridProps, AgGridColumn, GridRef, AgGridColumnPropsClone };

package/dist/esm/ag-grid-plus/interface.js

@@ -0,0 +1,17 @@
+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(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(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); }
+import React from "react";
+// 注意: QueryStorageAdapter 和 ColumnStorageAdapter 已废弃
+// 请使用集中式方案管理 API
+
+//column的行内传参
+import { jsx as _jsx } from "react/jsx-runtime";
+function AgGridColumn(props) {
+  ///@ts-ignore
+  return /*#__PURE__*/_jsx(AgGridColumnClone, _objectSpread({}, props));
+}
+export { AgGridColumn };