conditional-selection 1.1.5 → 1.1.7

package/README.md

@@ -1,9 +1,5 @@
 # conditional-selection
 
-<p>
-  <a href="./README.md">English</a> | <a href="./README.zh-CN.md">中文</a>
-</p>
-
 A lightweight React component library for building conditional rule trees. Supports recursive nesting, AND/OR grouping, dynamic add/remove, and fully customizable condition rows via render props.
 
 ## Installation
@@ -195,3 +191,5 @@ Components are exported from `packages/index.ts`. Styles are written in Less (`p
 ## License
 
 MIT
+
+---

package/package.json

@@ -12,8 +12,8 @@
     "vite-plugin-lib-inject-css": "^2.2.2"
   },
   "name": "conditional-selection",
-  "version": "1.1.5",
-  "description": "",
+  "version": "1.1.7",
+  "description": "conditional-selection",
   "main": "dist/ui.cjs.js",
   "module": "dist/ui.es.js",
   "types": "dist/types/ui.es.d.ts",

package/README.zh-CN.md

@@ -1,197 +0,0 @@
-# conditional-selection
-
-<p>
-  <a href="./README.md">English</a> | <a href="./README.zh-CN.md">中文</a>
-</p>
-
-一个轻量级的 React 条件规则树组件库，支持递归嵌套、AND/OR 分组、动态增删，以及通过 render props 完全自定义条件行内容。
-
-## 安装
-
-```bash
-npm install conditional-selection
-```
-
-> **同级依赖（peerDependencies）：** `react >= 16.8.0`，`react-dom >= 16.8.0`
-
-## 快速开始
-
-```tsx
-import { ConditionalSelection } from 'conditional-selection';
-import type { TConditionalSelection } from 'conditional-selection';
-
-export default function App() {
-  const [rules, setRules] = useState<TConditionalSelection | undefined>();
-
-  return (
-    <ConditionalSelection
-      conditionalRules={rules}
-      maxDeep={3}
-      onChange={setRules}
-      renderConditionRules={(item, change) => (
-        <MyConditionRow item={item} onChange={change} />
-      )}
-    />
-  );
-}
-```
-
-## Props 参数说明
-
-| 参数 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| `conditionalRules` | `TConditionalSelection \| null` | `undefined` | 条件树数据，传入 `null` 或 `undefined` 时自动初始化 |
-| `maxDeep` | `number` | `1` | 最大递归层级，必须大于 `0` |
-| `disabled` | `boolean \| TConditionalSelectionDisabledProps` | `false` | 禁用全部或部分操作 |
-| `onChange` | `(value: TConditionalSelection \| undefined) => void` | — | 数据变更回调 |
-| `renderConditionRules` | `(item, change) => ReactNode` | — | 条件行渲染插槽，参数为当前 `INDIVIDUAL` 节点和更新 handler |
-| `renderCreateCondition` | `(params) => ReactNode` | — | 自定义"添加条件"按钮的渲染插槽 |
-
-### `disabled` 对象格式
-
-```ts
-type TConditionalSelectionDisabledProps = {
-  addItem?: boolean;    // 禁用添加条件
-  delItem?: boolean;    // 禁用删除条件
-  linkChange?: boolean; // 禁用 AND/OR 切换
-};
-```
-
-## 数据结构
-
-```ts
-type TConditionalSelection<T = any> = {
-  _id: string;
-  framework: 'group' | 'individual';
-  link?: 'and' | 'or';
-  group?: TConditionalSelection<T>[];
-  individual?: Record<string, any>;
-  level: number;
-};
-```
-
-- **`group`** 节点 — 包含子节点，支持 AND/OR 关系切换
-- **`individual`** 节点 — 单个条件行，自定义数据存放在 `individual` 字段中
-
-### 数据示例
-
-**扁平结构** — 两个 `individual` 条件以 AND 连接：
-
-```json
-{
-  "_id": "2dfd8d9d-4bbf-4bc3-aae6-6c747ccbdd10",
-  "framework": "group",
-  "level": 0,
-  "link": "and",
-  "group": [
-    {
-      "_id": "02399b6c-10a3-41d4-9722-cce2db9ae056",
-      "framework": "individual",
-      "individual": { "field": 1, "function": 1, "value": 1 },
-      "level": 1
-    },
-    {
-      "_id": "6c627903-b970-43a8-a3f5-f5aba89f2200",
-      "framework": "individual",
-      "individual": { "field": 1, "function": 1, "value": 1 },
-      "level": 1
-    }
-  ]
-}
-```
-
-**嵌套结构** — 一个 `individual` 与一个嵌套 `group`（OR）并列于第 1 层：
-
-```json
-{
-  "_id": "2dfd8d9d-4bbf-4bc3-aae6-6c747ccbdd10",
-  "framework": "group",
-  "level": 0,
-  "link": "and",
-  "group": [
-    {
-      "_id": "02399b6c-10a3-41d4-9722-cce2db9ae056",
-      "framework": "individual",
-      "individual": { "field": 1, "function": 1, "value": 1 },
-      "level": 1
-    },
-    {
-      "_id": "2f808fe6-4dd8-488d-9b79-d2888915fddc",
-      "framework": "group",
-      "level": 1,
-      "link": "or",
-      "group": [
-        {
-          "_id": "17336bf2-2885-4350-8055-233b0058ec39",
-          "framework": "individual",
-          "individual": { "field": 1, "function": 1, "value": 1 },
-          "level": 2
-        },
-        {
-          "_id": "6e21bd9a-f994-474a-bba5-d77ac9013a65",
-          "framework": "individual",
-          "individual": { "field": 1, "function": 1, "value": 1 },
-          "level": 2
-        }
-      ]
-    }
-  ]
-}
-```
-
-## 通过 Ref 获取数据
-
-```tsx
-const ref = useRef<any>(null);
-
-<ConditionalSelection ref={ref} ... />
-
-// 返回当前条件树的深拷贝
-const data = await ref.current.getConditionalSelectionData();
-```
-
-## 自定义条件行示例
-
-```tsx
-const MyConditionRow = ({ item, onChange }) => {
-  const data = item.individual ?? {};
-  return (
-    <div style={{ display: 'flex', gap: 8 }}>
-      <select value={data.field ?? ''} onChange={e => onChange({ field: e.target.value })}>
-        <option value="">选择字段</option>
-        <option value="name">名称</option>
-      </select>
-      <select value={data.operator ?? ''} onChange={e => onChange({ ...data, operator: e.target.value })}>
-        <option value="">选择操作符</option>
-        <option value="eq">等于</option>
-        <option value="ne">不等于</option>
-      </select>
-      <input
-        value={data.value ?? ''}
-        onChange={e => onChange({ ...data, value: e.target.value })}
-        placeholder="输入值"
-      />
-    </div>
-  );
-};
-```
-
-## 性能优化建议
-
-- 将 handler 和 render props 用 `useCallback` 包裹，避免不必要的重渲染
-- 如需深度性能分析，可借助 [React Profiler](https://react.dev/reference/react/Profiler)
-
-## 贡献与开发
-
-```bash
-git clone https://github.com/1512-Yolo/conditional-selection.git
-cd conditional-selection
-npm install
-npm run dev
-```
-
-组件统一从 `packages/index.ts` 导出，样式使用 Less（`packages/ConditionalSelection/index.less`）编写。
-
-## License
-
-MIT