@pisell/materials 1.0.1048 → 1.0.1050

package/lib/components/pisellSort/docs/PisellSort.md

@@ -3,8 +3,8 @@ nav:
   title: 组件
   order: 1
 group:
-  title: DataDisplay
-  order: 3
+  title: Data Entry
+  order: 1
 title: PisellSort
 order: 15
 category: pro
@@ -12,52 +12,36 @@ category: pro
 
 # PisellSort - 排序选择组件
 
-## 简介
+PisellSort 基于 Ant Design Form 封装，提供排序字段与排序方式的下拉选择，适用于列表、表格等需要排序能力的场景。
+
+## 何时使用
 
-PisellSort 是一个排序选择组件，基于 Ant Design Form 封装，提供了便捷的排序字段选择和排序方式配置功能。适用于列表、表格等需要排序功能的场景。
+- 列表/表格需要「按某字段升序/降序」的筛选入口
+- 需要与 Form 联动的排序字段（字段名可配置）
+- 需要支持多类型字段（数字、日期、字符串）的排序配置
 
 ## 特性
 
-- 🎯 **表单集成**: 基于 Ant Design Form 封装，支持表单联动
-- 🎨 **灵活配置**: 支持自定义排序字段和排序方式
-- 📱 **类型支持**: 支持日期、字符串、数字等多种数据类型排序
-- 🔄 **受控模式**: 支持完全受控的选中状态管理
-- ⚡ **轻量级**: 基于已有 Sort 组件封装，体积小巧
-- 🎭 **TypeScript**: 完整的 TypeScript 类型定义
+- 表单集成：基于 Ant Design Form，支持表单联动
+- 灵活配置：自定义排序字段列表与排序方式
+- 类型支持：支持 `date`、`string`、`number` 等类型
+- 受控模式：支持 `value` + `onChange` 受控
+- TypeScript：完整类型定义
 
 ## 基础用法
 
 ```tsx
-import { useState } from 'react';
+import React, { useState } from 'react';
 import { PisellSort } from '@pisell/materials';
 
-const Demo = () => {
-  const [sortValue, setSortValue] = useState('price_asc');
-
-  const sortList = [
-    {
-      type: 'number',
-      label: '价格',
-      name: 'price',
-      isCustom: false,
-      columnKey: 'price',
-    },
-    {
-      type: 'date',
-      label: '创建时间',
-      name: 'created_at',
-      isCustom: false,
-      columnKey: 'created_at',
-    },
-    {
-      type: 'string',
-      label: '名称',
-      name: 'name',
-      isCustom: false,
-      columnKey: 'name',
-    },
-  ];
+const sortList = [
+  { type: 'number', label: '价格', name: 'price', isCustom: false, columnKey: 'price' },
+  { type: 'date', label: '创建时间', name: 'created_at', isCustom: false, columnKey: 'created_at' },
+  { type: 'string', label: '名称', name: 'name', isCustom: false, columnKey: 'name' },
+];
 
+export default () => {
+  const [sortValue, setSortValue] = useState<string>('price_asc');
   return (
     <PisellSort
       list={sortList}
@@ -69,36 +53,34 @@ const Demo = () => {
     />
   );
 };
-
-export default Demo;
 ```
 
 ## API
 
 ### PisellSort Props
 
-| 参数            | 说明               | 类型                                                               | 默认值       | 版本 |
+| 参数            | 说明               | 类型                                                               | 默认值       | 必填 |
 | --------------- | ------------------ | ------------------------------------------------------------------ | ------------ | ---- |
-| list            | 排序字段列表       | `SortItemProps[]`                                                  | `[]`         | -    |
-| value           | 当前选中的排序值   | `any`                                                              | -            | -    |
-| onChange        | 排序变化回调       | `(val: string, detail: MenuInfo) => void`                          | -            | -    |
-| name            | 表单字段名         | `string`                                                           | `'sort_key'` | -    |
-| button          | 自定义触发按钮     | `ReactNode`                                                        | -            | -    |
-| style           | 自定义样式         | `CSSProperties`                                                    | -            | -    |
-| placement       | 下拉菜单弹出位置   | `'bottom' \| 'bottomLeft' \| 'bottomRight' \| 'top' \| 'topLeft' \| 'topRight'` | -            | -    |
-| localPagination | 是否使用本地分页   | `boolean`                                                          | -            | -    |
+| list            | 排序字段列表       | `SortItemProps[]`                                                  | `[]`         | ❌   |
+| value           | 当前选中的排序值   | `string`                                                           | -            | ❌   |
+| onChange        | 排序变化回调       | `(val: string, detail: MenuInfo) => void`                          | -            | ❌   |
+| name            | 表单字段名         | `string`                                                           | `'sort_key'` | ❌   |
+| button          | 自定义触发按钮     | `ReactNode`                                                        | -            | ❌   |
+| style           | 自定义样式         | `CSSProperties`                                                    | -            | ❌   |
+| placement       | 下拉菜单弹出位置   | `'bottom' \| 'bottomLeft' \| 'bottomRight' \| 'top' \| 'topLeft' \| 'topRight'` | -            | ❌   |
+| localPagination | 是否使用本地分页   | `boolean`                                                          | -            | ❌   |
 
 ### SortItemProps
 
-```typescript
+```ts
 interface SortItemProps {
   type: 'date' | 'string' | 'number'; // 排序字段类型
-  label?: string; // 显示标签
-  name?: string | string[]; // 字段名称
-  isCustom: boolean; // 是否为自定义排序
-  columnKey?: string; // 列键值
-  localFilter?: boolean; // 是否本地过滤
-  isHidden?: boolean; // 是否隐藏
+  label?: string;                    // 显示标签
+  name?: string | string[];          // 字段名称
+  isCustom: boolean;                  // 是否为自定义排序
+  columnKey?: string;                 // 列键值
+  localFilter?: boolean;              // 是否本地过滤
+  isHidden?: boolean;                 // 是否隐藏
 }
 ```
 
@@ -107,95 +89,62 @@ interface SortItemProps {
 ### 自定义触发按钮
 
 ```tsx
+import React from 'react';
 import { Button } from 'antd';
 import { PisellSort } from '@pisell/materials';
 
 const sortList = [
-  {
-    type: 'number',
-    label: '价格',
-    name: 'price',
-    isCustom: false,
-    columnKey: 'price',
-  },
+  { type: 'number', label: '价格', name: 'price', isCustom: false, columnKey: 'price' },
 ];
 
-const Demo = () => {
-  return (
-    <PisellSort
-      list={sortList}
-      button={
-        <Button type="primary" icon={<SortAscendingOutlined />}>
-          排序
-        </Button>
-      }
-    />
-  );
-};
-
-export default Demo;
+export default () => (
+  <PisellSort
+    list={sortList}
+    button={<Button type="primary">排序</Button>}
+  />
+);
 ```
 
 ### 自定义下拉位置
 
 ```tsx
+import React from 'react';
 import { PisellSort } from '@pisell/materials';
 
 const sortList = [
-  {
-    type: 'number',
-    label: '价格',
-    name: 'price',
-    isCustom: false,
-    columnKey: 'price',
-  },
+  { type: 'number', label: '价格', name: 'price', isCustom: false, columnKey: 'price' },
 ];
 
-const Demo = () => {
-  return (
-    <PisellSort
-      list={sortList}
-      placement="topLeft"
-    />
-  );
-};
-
-export default Demo;
+export default () => (
+  <PisellSort list={sortList} placement="topLeft" />
+);
 ```
 
 ### 隐藏特定排序项
 
 ```tsx
+import React from 'react';
 import { PisellSort } from '@pisell/materials';
 
 const sortList = [
-  {
-    type: 'number',
-    label: '价格',
-    name: 'price',
-    isCustom: false,
-    columnKey: 'price',
-  },
+  { type: 'number', label: '价格', name: 'price', isCustom: false, columnKey: 'price' },
   {
     type: 'date',
     label: '创建时间',
     name: 'created_at',
     isCustom: false,
     columnKey: 'created_at',
-    isHidden: true, // 隐藏此项
+    isHidden: true,
   },
 ];
 
-const Demo = () => {
-  return <PisellSort list={sortList} />;
-};
-
-export default Demo;
+export default () => <PisellSort list={sortList} />;
 ```
 
 ### 本地排序模式
 
 ```tsx
+import React from 'react';
 import { PisellSort } from '@pisell/materials';
 
 const sortList = [
@@ -205,37 +154,24 @@ const sortList = [
     name: 'price',
     isCustom: false,
     columnKey: 'price',
-    localFilter: true, // 启用本地过滤
+    localFilter: true,
   },
 ];
 
-const Demo = () => {
-  return (
-    <PisellSort
-      list={sortList}
-      localPagination={true}
-    />
-  );
-};
-
-export default Demo;
+export default () => (
+  <PisellSort list={sortList} localPagination />
+);
 ```
 
 ## 注意事项
 
-1. **表单集成**: PisellSort 组件内部已集成 Form，使用时无需再包裹 Form 组件
-2. **字段名称**: 默认表单字段名为 `sort_key`，可通过 `name` 属性自定义
-3. **数据类型**: 不同的 `type` 类型会影响排序的行为，请根据实际数据类型选择
-4. **回调参数**: `onChange` 回调会返回排序值和详细的菜单信息，方便进行更复杂的处理
-
-## 设计指南
-
-详见 [设计文档](./PisellSort.$tab-design.md)
-
-## 开发指南
-
-详见 [开发文档](./PisellSort.$tab-dev.md)
+1. **表单集成**：组件内部已集成 Form，无需再包一层 Form
+2. **字段名称**：默认表单字段名为 `sort_key`，可通过 `name` 自定义
+3. **数据类型**：`list` 中每项的 `type`（`date` / `string` / `number`）会影响排序行为，需与实际数据一致
+4. **回调参数**：`onChange(val, detail)` 返回当前排序值与菜单详情，便于联动请求或表格排序
 
-## 测试指南
+## 相关文档
 
-详见 [测试文档](./PisellSort.$tab-test.md)
+- [设计文档](./PisellSort.$tab-design.md)
+- [开发文档](./PisellSort.$tab-dev.md)
+- [测试文档](./PisellSort.$tab-test.md)

package/lib/components/pisellSort/index.js

@@ -2,9 +2,9 @@ const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
 const require_objectSpread2 = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js');
 const require_objectWithoutProperties = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectWithoutProperties.js');
 const require_index = require('../sort/index.js');
-let antd = require("antd");
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);
+let antd = require("antd");
 
 //#region src/components/pisellSort/index.tsx
 const _excluded = ["name", "hasForm"];

package/lib/components/pisellStatisticList/index.d.ts

@@ -22,4 +22,4 @@ interface PisellStatisticListProps extends React.HTMLAttributes<HTMLDivElement>
 }
 declare const PisellStatisticList: (props: PisellStatisticListProps) => React.JSX.Element;
 //#endregion
-export { PisellStatisticList };
+export { PisellStatisticList, PisellStatisticListProps };

package/lib/components/pisellStatisticList/index.js

@@ -1,11 +1,11 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
 const require_objectSpread2 = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js');
 const require_objectWithoutProperties = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectWithoutProperties.js');
-const require_index = require('../iconfont/index.js');
-const require_index$1 = require('../pisellTooltip/index.js');
-let antd = require("antd");
+const require_index = require('../pisellTooltip/index.js');
+const require_index$1 = require('../iconfont/index.js');
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);
+let antd = require("antd");
 require("./index.less");
 
 //#region src/components/pisellStatisticList/index.tsx
@@ -37,7 +37,7 @@ const PisellStatisticList = (props) => {
 		}, /* @__PURE__ */ react.default.createElement("div", {
 			className: "pisell-lowcode-statistic-list-item-label",
 			style: { color: labelColor }
-		}, item.label, item.tip && /* @__PURE__ */ react.default.createElement(require_index$1.default, { title: item.tip }, /* @__PURE__ */ react.default.createElement(require_index.default, {
+		}, item.label, item.tip && /* @__PURE__ */ react.default.createElement(require_index.default, { title: item.tip }, /* @__PURE__ */ react.default.createElement(require_index$1.default, {
 			style: { color: labelColor },
 			type: "pisell2-help-circle",
 			className: "pisell-lowcode-statistic-list-item-label-tip-icon"

package/lib/components/pisellTags/index.js

@@ -2,10 +2,10 @@ const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
 const require_objectSpread2 = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js');
 const require_objectWithoutProperties = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectWithoutProperties.js');
 const require_utils = require('./utils.js');
-let classnames = require("classnames");
-classnames = require_rolldown_runtime.__toESM(classnames);
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);
+let classnames = require("classnames");
+classnames = require_rolldown_runtime.__toESM(classnames);
 require("./index.less");
 
 //#region src/components/pisellTags/index.tsx

package/lib/components/pisellText/components/Amount/index.js

@@ -1,6 +1,6 @@
 const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.js');
-const require_usePisellConfig = require('../../../pisell-config-provider/hooks/usePisellConfig.js');
 const require_objectWithoutProperties = require('../../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectWithoutProperties.js');
+const require_usePisellConfig = require('../../../pisell-config-provider/hooks/usePisellConfig.js');
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);
 let _pisell_utils = require("@pisell/utils");

package/lib/components/pisellText/components/Editable/index.js

@@ -1,15 +1,15 @@
 const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.js');
 const require_objectSpread2 = require('../../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js');
 const require_objectWithoutProperties = require('../../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectWithoutProperties.js');
-const require_index = require('../../../icon/index.js');
 const require_useEngineContext = require('../../../../hooks/useEngineContext.js');
+const require_index = require('../../../icon/index.js');
 const require_index$1 = require('../../../translation/index.js');
-let antd = require("antd");
-let classnames = require("classnames");
-classnames = require_rolldown_runtime.__toESM(classnames);
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);
 let _pisell_utils = require("@pisell/utils");
+let antd = require("antd");
+let classnames = require("classnames");
+classnames = require_rolldown_runtime.__toESM(classnames);
 require("./index.less");
 
 //#region src/components/pisellText/components/Editable/index.tsx

package/lib/components/pisellToast/squareToast/toast.js

@@ -1,12 +1,12 @@
 const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.js');
 const require_objectSpread2 = require('../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js');
-const require_index = require('../../modal/index.js');
 const require_objectWithoutProperties = require('../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectWithoutProperties.js');
+const require_index = require('../../modal/index.js');
 const require_index$1 = require('../../icon/index.js');
-let classnames = require("classnames");
-classnames = require_rolldown_runtime.__toESM(classnames);
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);
+let classnames = require("classnames");
+classnames = require_rolldown_runtime.__toESM(classnames);
 require("./index.less");
 
 //#region src/components/pisellToast/squareToast/toast.tsx

package/lib/components/pisellTooltip/index.js

@@ -1,10 +1,10 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
 const require_objectSpread2 = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js');
+let react = require("react");
+react = require_rolldown_runtime.__toESM(react);
 let antd = require("antd");
 let classnames = require("classnames");
 classnames = require_rolldown_runtime.__toESM(classnames);
-let react = require("react");
-react = require_rolldown_runtime.__toESM(react);
 require("./index.less");
 
 //#region src/components/pisellTooltip/index.tsx

package/lib/components/pisellUpload/index.d.ts

@@ -1,5 +1,5 @@
-import { UploadProps } from "antd";
 import React from "react";
+import { UploadProps } from "antd";
 import "./index.less";
 
 //#region src/components/pisellUpload/index.d.ts

package/lib/components/pisellUpload/index.js

@@ -1,11 +1,11 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
 const require_objectSpread2 = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js');
-let antd = require("antd");
-let classnames = require("classnames");
-classnames = require_rolldown_runtime.__toESM(classnames);
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);
+let antd = require("antd");
 let _ant_design_icons = require("@ant-design/icons");
+let classnames = require("classnames");
+classnames = require_rolldown_runtime.__toESM(classnames);
 require("./index.less");
 
 //#region src/components/pisellUpload/index.tsx

package/lib/components/pisellUrl/components/EditView.js

@@ -2,10 +2,10 @@ const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.js'
 const require_objectSpread2 = require('../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js');
 const require_urlValidator = require('../utils/urlValidator.js');
 const require_urlHelper = require('../utils/urlHelper.js');
-let antd = require("antd");
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);
 let _pisell_utils = require("@pisell/utils");
+let antd = require("antd");
 let _ant_design_icons = require("@ant-design/icons");
 
 //#region src/components/pisellUrl/components/EditView.tsx

package/lib/components/pisellUrl/components/ReadOnlyView.js

@@ -1,9 +1,9 @@
 const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.js');
 const require_urlHelper = require('../utils/urlHelper.js');
 const require_urlFormatter = require('../utils/urlFormatter.js');
-let antd = require("antd");
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);
+let antd = require("antd");
 let _ant_design_icons = require("@ant-design/icons");
 
 //#region src/components/pisellUrl/components/ReadOnlyView.tsx

package/lib/components/pisellViewGrid/index.d.ts

@@ -16,4 +16,4 @@ interface PisellViewGridProps {
 }
 declare const PisellViewGrid: React.FC<PisellViewGridProps>;
 //#endregion
-export { PisellViewGrid };
+export { PisellViewGrid, PisellViewGridProps };

package/lib/components/pisellViewGrid/index.js

@@ -1,10 +1,10 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
 const require_objectSpread2 = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js');
 const require_index = require('../pisellLoading/index.js');
-let classnames = require("classnames");
-classnames = require_rolldown_runtime.__toESM(classnames);
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);
+let classnames = require("classnames");
+classnames = require_rolldown_runtime.__toESM(classnames);
 require("./index.less");
 
 //#region src/components/pisellViewGrid/index.tsx