@rainbow-oh/yee-c 0.6.4 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (123) hide show
  1. package/dist/cjs/Button/style/index.less +5 -4
  2. package/dist/cjs/Drawer/drawer.js +1 -1
  3. package/dist/cjs/Drawer/interface.d.ts +1 -1
  4. package/dist/cjs/Drawer/style/index.less +1 -0
  5. package/dist/cjs/List/demo/virtual.d.ts +3 -0
  6. package/dist/cjs/List/demo/virtual.js +53 -0
  7. package/dist/cjs/List/hooks/useListKeyboard.d.ts +28 -0
  8. package/dist/cjs/List/hooks/useListKeyboard.js +188 -0
  9. package/dist/cjs/List/interface.d.ts +29 -2
  10. package/dist/cjs/List/list.js +141 -21
  11. package/dist/cjs/List/style/index.less +24 -0
  12. package/dist/cjs/Select/demo/columns.d.ts +3 -0
  13. package/dist/cjs/Select/demo/columns.js +62 -0
  14. package/dist/cjs/Select/hooks/useSelectKeyboard.d.ts +13 -1
  15. package/dist/cjs/Select/hooks/useSelectKeyboard.js +81 -10
  16. package/dist/cjs/Select/interface.d.ts +30 -3
  17. package/dist/cjs/Select/option.js +4 -3
  18. package/dist/cjs/Select/options.js +90 -8
  19. package/dist/cjs/Select/select.js +32 -8
  20. package/dist/cjs/Select/style/index.less +14 -0
  21. package/dist/cjs/Selector/interface.d.ts +4 -0
  22. package/dist/cjs/Selector/selector.js +5 -3
  23. package/dist/cjs/Table/interface.d.ts +1 -1
  24. package/dist/cjs/Tree/demo/draggable.js +2 -0
  25. package/dist/cjs/Tree/interface.d.ts +46 -23
  26. package/dist/cjs/Tree/tree-node.d.ts +1 -1
  27. package/dist/cjs/Tree/tree-node.js +30 -23
  28. package/dist/cjs/Tree/tree.d.ts +13 -12
  29. package/dist/cjs/Tree/tree.js +452 -227
  30. package/dist/cjs/Tree/utils/tree-tools.d.ts +43 -10
  31. package/dist/cjs/Tree/utils/tree-tools.js +129 -91
  32. package/dist/cjs/locale/context.d.ts +5 -4
  33. package/dist/cjs/locale/context.js +15 -8
  34. package/dist/cjs/locale/interface.d.ts +20 -0
  35. package/dist/cjs/locale/util.d.ts +3 -3
  36. package/dist/cjs/style/color.css +1 -0
  37. package/dist/cjs/style/size.css +2 -1
  38. package/dist/cjs/style/themes.css +1 -1
  39. package/dist/cjs/style/variables.css +4 -2
  40. package/dist/cjs/utils/isEqual.js +5 -7
  41. package/dist/cjs/version.d.ts +1 -1
  42. package/dist/cjs/version.js +1 -1
  43. package/dist/esm/Button/style/index.less +5 -4
  44. package/dist/esm/Drawer/drawer.js +2 -1
  45. package/dist/esm/Drawer/interface.d.ts +1 -1
  46. package/dist/esm/Drawer/style/index.less +1 -0
  47. package/dist/esm/List/demo/virtual.d.ts +3 -0
  48. package/dist/esm/List/demo/virtual.js +22 -0
  49. package/dist/esm/List/hooks/useListKeyboard.d.ts +28 -0
  50. package/dist/esm/List/hooks/useListKeyboard.js +173 -0
  51. package/dist/esm/List/interface.d.ts +29 -2
  52. package/dist/esm/List/list.js +171 -14
  53. package/dist/esm/List/style/index.less +24 -0
  54. package/dist/esm/Select/demo/columns.d.ts +3 -0
  55. package/dist/esm/Select/demo/columns.js +36 -0
  56. package/dist/esm/Select/hooks/useSelectKeyboard.d.ts +13 -1
  57. package/dist/esm/Select/hooks/useSelectKeyboard.js +91 -14
  58. package/dist/esm/Select/interface.d.ts +30 -3
  59. package/dist/esm/Select/option.js +6 -2
  60. package/dist/esm/Select/options.js +114 -32
  61. package/dist/esm/Select/select.js +40 -11
  62. package/dist/esm/Select/style/index.less +14 -0
  63. package/dist/esm/Selector/interface.d.ts +4 -0
  64. package/dist/esm/Selector/selector.js +10 -4
  65. package/dist/esm/Table/interface.d.ts +1 -1
  66. package/dist/esm/Tree/demo/draggable.js +2 -0
  67. package/dist/esm/Tree/interface.d.ts +46 -23
  68. package/dist/esm/Tree/tree-node.d.ts +1 -1
  69. package/dist/esm/Tree/tree-node.js +26 -31
  70. package/dist/esm/Tree/tree.d.ts +13 -12
  71. package/dist/esm/Tree/tree.js +572 -163
  72. package/dist/esm/Tree/utils/tree-tools.d.ts +43 -10
  73. package/dist/esm/Tree/utils/tree-tools.js +219 -104
  74. package/dist/esm/locale/context.d.ts +5 -4
  75. package/dist/esm/locale/context.js +25 -9
  76. package/dist/esm/locale/interface.d.ts +20 -0
  77. package/dist/esm/locale/util.d.ts +3 -3
  78. package/dist/esm/style/color.css +1 -0
  79. package/dist/esm/style/size.css +2 -1
  80. package/dist/esm/style/themes.css +1 -1
  81. package/dist/esm/style/variables.css +4 -2
  82. package/dist/esm/utils/isEqual.js +5 -7
  83. package/dist/esm/version.d.ts +1 -1
  84. package/dist/esm/version.js +1 -1
  85. package/dist/umd/yee-c.min.css +2 -2
  86. package/dist/umd/yee-c.min.js +1 -1
  87. package/package.json +1 -1
  88. package/src/Button/style/index.less +5 -4
  89. package/src/Drawer/drawer.tsx +1 -1
  90. package/src/Drawer/interface.ts +1 -0
  91. package/src/Drawer/style/index.less +1 -0
  92. package/src/List/demo/virtual.tsx +20 -0
  93. package/src/List/hooks/useListKeyboard.ts +235 -0
  94. package/src/List/index.en-US.md +6 -0
  95. package/src/List/index.zh-CN.md +6 -0
  96. package/src/List/interface.ts +29 -2
  97. package/src/List/list.tsx +157 -19
  98. package/src/List/style/index.less +24 -0
  99. package/src/Select/demo/columns.tsx +35 -0
  100. package/src/Select/hooks/useSelectKeyboard.ts +112 -15
  101. package/src/Select/index.en-US.md +4 -0
  102. package/src/Select/index.zh-CN.md +4 -0
  103. package/src/Select/interface.ts +31 -4
  104. package/src/Select/option.tsx +9 -3
  105. package/src/Select/options.tsx +119 -26
  106. package/src/Select/select.tsx +41 -8
  107. package/src/Select/style/index.less +14 -0
  108. package/src/Selector/interface.ts +4 -0
  109. package/src/Selector/selector.tsx +8 -3
  110. package/src/Table/interface.ts +1 -1
  111. package/src/Tree/demo/draggable.tsx +2 -0
  112. package/src/Tree/interface.ts +46 -23
  113. package/src/Tree/tree-node.tsx +26 -29
  114. package/src/Tree/tree.tsx +573 -274
  115. package/src/Tree/utils/tree-tools.ts +231 -125
  116. package/src/locale/_README.md +22 -13
  117. package/src/locale/context.tsx +33 -16
  118. package/src/locale/interface.ts +24 -0
  119. package/src/locale/util.ts +6 -6
  120. package/src/style/color.css +1 -0
  121. package/src/style/size.css +2 -1
  122. package/src/utils/isEqual.ts +5 -7
  123. package/src/version.ts +1 -1
@@ -498,7 +498,7 @@ export interface TableProps extends FooterProps, Omit<HeaderProps, 'pageData'>,
498
498
  /**
499
499
  * Row class name, unlike classNames, this prop can be set dynamically via a function
500
500
  */
501
- rowClassName?: (record: object) => string | undefined;
501
+ rowClassName?: (record: Record<string, any>) => string | undefined;
502
502
  /**
503
503
  * Row style, unlike styles, this prop can be set dynamically via a function
504
504
  */
@@ -53,6 +53,8 @@ export default (function () {
53
53
  return moveTreeNode(prev, {
54
54
  dragKey: info.dragKey,
55
55
  dropKey: info.dropKey,
56
+ dragPath: info.dragPath,
57
+ dropPath: info.dropPath,
56
58
  position: info.position
57
59
  }, FIELD_NAMES);
58
60
  });
@@ -4,13 +4,14 @@ export type DragPosition = 'before' | 'after' | 'inside';
4
4
  export type { MoveInfo } from './utils/tree-tools';
5
5
  export type TreeNode<T> = {
6
6
  /**
7
- * uid
7
+ * Unique internal identifier built from key path joined by '\x00'.
8
+ * Guaranteed unique even when user-provided `key` values repeat across branches.
8
9
  */
9
10
  uid: string;
10
11
  /**
11
- * Unique key
12
- * */
13
- key: string;
12
+ * User-provided key (may not be globally unique)
13
+ */
14
+ key: string | number;
14
15
  /**
15
16
  * Display node text
16
17
  */
@@ -20,7 +21,7 @@ export type TreeNode<T> = {
20
21
  */
21
22
  title?: string;
22
23
  /**
23
- * Child nodes
24
+ * Child nodes (only present in raw tree; not used in flat list)
24
25
  */
25
26
  children?: Array<TreeNode<T>>;
26
27
  /**
@@ -28,16 +29,16 @@ export type TreeNode<T> = {
28
29
  */
29
30
  depth: number;
30
31
  /**
31
- * Parent node key
32
- * */
33
- pKey: string | null;
32
+ * Parent node uid (null for root nodes)
33
+ */
34
+ pUid: string | null;
34
35
  /**
35
36
  * Whether this is a leaf node
36
- * */
37
+ */
37
38
  isLeaf: boolean;
38
39
  /**
39
40
  * Whether this is the last node at its level
40
- * */
41
+ */
41
42
  isLast: boolean;
42
43
  /**
43
44
  * Whether disabled
@@ -48,17 +49,17 @@ export type TreeNode<T> = {
48
49
  */
49
50
  icon?: React.ReactNode | (() => React.ReactNode);
50
51
  /**
51
- * Ancestor keys
52
+ * Ancestor keys (user-provided keys, for building uid path)
52
53
  */
53
- path: string[];
54
+ path: Array<string | number>;
54
55
  /**
55
- * Whether to show connecting lines
56
+ * Whether to show connecting lines at given depth levels
56
57
  */
57
58
  lines: number[];
58
59
  /**
59
- * List of child node keys
60
+ * All descendant uids (collected bottom-up). Used for check/uncheck propagation.
60
61
  */
61
- childKeys?: Array<string | number>;
62
+ childUids?: Array<string>;
62
63
  /**
63
64
  * Original data
64
65
  */
@@ -66,6 +67,7 @@ export type TreeNode<T> = {
66
67
  };
67
68
  export interface TreeNodeProps<T> {
68
69
  node: TreeNode<T>;
70
+ style?: React.CSSProperties;
69
71
  }
70
72
  export interface TreeProps<T> {
71
73
  /**
@@ -89,11 +91,11 @@ export interface TreeProps<T> {
89
91
  */
90
92
  defaultExpandAll?: boolean;
91
93
  /**
92
- * Specify which tree nodes to expand by default
94
+ * Specify which tree nodes to expand by default (user keys)
93
95
  */
94
96
  defaultExpandedKeys?: string[];
95
97
  /**
96
- * Controlled expanded tree nodes
98
+ * Controlled expanded tree nodes (user keys)
97
99
  */
98
100
  expandedKeys?: string[];
99
101
  /**
@@ -124,6 +126,10 @@ export interface TreeProps<T> {
124
126
  dropNode: T;
125
127
  dragKey: string | number;
126
128
  dropKey: string | number;
129
+ /** Full key path from root to the dragged node (for non-unique key support) */
130
+ dragPath: Array<string | number>;
131
+ /** Full key path from root to the drop target (for non-unique key support) */
132
+ dropPath: Array<string | number>;
127
133
  position: DragPosition;
128
134
  /** Convenience flag: true when position is 'before' or 'after' */
129
135
  dropToGap: boolean;
@@ -164,22 +170,39 @@ export interface TreeProps<T> {
164
170
  loadData?: () => void;
165
171
  /**
166
172
  * Data source
167
- * */
173
+ */
168
174
  dataSource?: Array<T> | T;
169
175
  /**
170
- * Checked tree nodes (controlled)
176
+ * Enable virtual scrolling for large datasets.
177
+ * Requires `height` to be set.
178
+ * @default false
179
+ */
180
+ virtual?: boolean;
181
+ /**
182
+ * Height of the scrollable container in pixels.
183
+ * Required when `virtual` is true.
184
+ */
185
+ height?: number;
186
+ /**
187
+ * Fixed height of each tree node row in pixels.
188
+ * Used for virtual scroll calculation.
189
+ * @default 28
190
+ */
191
+ itemHeight?: number;
192
+ /**
193
+ * Checked tree nodes (controlled, user keys)
171
194
  */
172
195
  checkedKeys?: Array<string | number>;
173
196
  /**
174
- * Checked tree nodes (uncontrolled)
197
+ * Checked tree nodes (uncontrolled, user keys)
175
198
  */
176
199
  defaultCheckedKeys?: Array<string | number>;
177
200
  /**
178
- * Set selected tree nodes, set multiple to true for multi-select
201
+ * Set selected tree nodes, set multiple to true for multi-select (user keys)
179
202
  */
180
203
  selectedKeys?: Array<string | number>;
181
204
  /**
182
- * Set default selected tree nodes, set multiple to true for multi-select
205
+ * Set default selected tree nodes (user keys)
183
206
  */
184
207
  defaultSelectedKeys?: Array<string | number>;
185
208
  /**
@@ -204,6 +227,6 @@ export interface TreeProps<T> {
204
227
  onExpand?: (expandedKeys: Array<string | number>, params: {
205
228
  expanded: boolean;
206
229
  expandedNodes: T[];
207
- node: T[];
230
+ node: T;
208
231
  }) => void;
209
232
  }
@@ -1,5 +1,5 @@
1
1
  import React from 'react';
2
2
  import type { TreeNodeProps } from './interface';
3
3
  import './style/index.less';
4
- declare const Node: <T extends Record<string, unknown> = any>(props: TreeNodeProps<T>) => React.JSX.Element | null;
4
+ declare const Node: <T extends Record<string, unknown> = any>(props: TreeNodeProps<T>) => React.JSX.Element;
5
5
  export default Node;
@@ -11,11 +11,11 @@ import Checkbox from "../Checkbox";
11
11
  import { TreeContext } from "./tree";
12
12
  import "./style/index.less";
13
13
  var Node = function Node(props) {
14
- var node = props.node;
15
- var key = node.key,
14
+ var node = props.node,
15
+ nodeStyle = props.style;
16
+ var uid = node.uid,
16
17
  isLeaf = node.isLeaf,
17
18
  isLast = node.isLast,
18
- path = node.path,
19
19
  label = node.label,
20
20
  title = node.title,
21
21
  disabled = node.disabled,
@@ -29,12 +29,13 @@ var Node = function Node(props) {
29
29
  showIcon = _useContext.showIcon,
30
30
  contextIcon = _useContext.icon,
31
31
  showLine = _useContext.showLine,
32
- selectedKeys = _useContext.selectedKeys,
33
- checkedKeys = _useContext.checkedKeys,
34
- expandedKeys = _useContext.expandedKeys,
32
+ selectedUids = _useContext.selectedUids,
33
+ checkedUids = _useContext.checkedUids,
34
+ indeterminateUids = _useContext.indeterminateUids,
35
+ expandedUids = _useContext.expandedUids,
35
36
  switcherIcon = _useContext.switcherIcon,
36
37
  draggable = _useContext.draggable,
37
- draggingKey = _useContext.draggingKey,
38
+ draggingUid = _useContext.draggingUid,
38
39
  dropState = _useContext.dropState,
39
40
  onCheck = _useContext.onCheck,
40
41
  onSelect = _useContext.onSelect,
@@ -43,15 +44,10 @@ var Node = function Node(props) {
43
44
  onNodeDragOver = _useContext.onNodeDragOver,
44
45
  onNodeDragLeave = _useContext.onNodeDragLeave,
45
46
  onNodeDrop = _useContext.onNodeDrop;
46
- var expanded = expandedKeys.includes(key);
47
- var checked = checkedKeys.includes(key);
48
- var selected = selectedKeys.includes(key);
49
-
50
- // All nodes on the path must be visible for this node to display
51
- var visible = path.every(function (p) {
52
- return expandedKeys.includes(p);
53
- });
54
- if (!visible) return null;
47
+ var expanded = expandedUids.has(uid);
48
+ var checked = checkedUids.has(uid);
49
+ var indeterminate = indeterminateUids.has(uid);
50
+ var selected = selectedUids.has(uid);
55
51
  var renderExpandedIcon = function renderExpandedIcon() {
56
52
  var expandedIcon = switcherIcon ? switcherIcon[0] : /*#__PURE__*/React.createElement(ChevronDown, {
57
53
  strokeWidth: 1
@@ -69,7 +65,7 @@ var Node = function Node(props) {
69
65
  type: "text",
70
66
  icon: expanded ? expandedIcon : collapseIcon,
71
67
  onClick: function onClick() {
72
- return onExpand(key);
68
+ return onExpand(uid);
73
69
  }
74
70
  }));
75
71
  };
@@ -78,9 +74,12 @@ var Node = function Node(props) {
78
74
  return /*#__PURE__*/React.createElement("span", {
79
75
  className: "".concat(prefixCls, "-node-checkbox")
80
76
  }, /*#__PURE__*/React.createElement(Checkbox, {
81
- value: key,
77
+ value: uid,
82
78
  checked: checked,
83
- onChange: onCheck
79
+ indeterminate: indeterminate,
80
+ onChange: function onChange(e) {
81
+ return onCheck(e, uid);
82
+ }
84
83
  }));
85
84
  };
86
85
  var renderLabel = function renderLabel() {
@@ -94,13 +93,11 @@ var Node = function Node(props) {
94
93
  title: _title,
95
94
  icon: showIcon ? _icon : undefined,
96
95
  onClick: disabled ? undefined : function () {
97
- return onSelect(key);
96
+ return onSelect(uid);
98
97
  }
99
98
  }, label);
100
99
  };
101
100
  var renderEmptyNodes = function renderEmptyNodes(depth) {
102
- // eslint-disable-line @typescript-eslint/no-unused-vars
103
-
104
101
  var temp = new Array(depth).fill(0);
105
102
  if (showLine) {
106
103
  return temp.map(function (_, index) {
@@ -118,28 +115,26 @@ var Node = function Node(props) {
118
115
  });
119
116
  });
120
117
  };
121
- var isDropTarget = (dropState === null || dropState === void 0 ? void 0 : dropState.key) === key;
118
+ var isDropTarget = (dropState === null || dropState === void 0 ? void 0 : dropState.uid) === uid;
122
119
  var dropPosition = isDropTarget ? dropState.position : null;
123
120
  var dragProps = draggable && !disabled ? {
124
121
  draggable: true,
125
122
  onDragStart: function onDragStart(e) {
126
- return onNodeDragStart(key, e);
123
+ return onNodeDragStart(uid, e);
127
124
  },
128
125
  onDragOver: function onDragOver(e) {
129
- return onNodeDragOver(key, e);
126
+ return onNodeDragOver(uid, e);
130
127
  },
131
128
  onDragLeave: function onDragLeave(e) {
132
- return onNodeDragLeave(key, e);
129
+ return onNodeDragLeave(uid, e);
133
130
  },
134
131
  onDrop: function onDrop(e) {
135
- return onNodeDrop(key, e);
132
+ return onNodeDrop(uid, e);
136
133
  }
137
134
  } : {};
138
135
  return /*#__PURE__*/React.createElement("div", _extends({
139
- className: clsx("".concat(prefixCls, "-node"), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, "".concat(prefixCls, "-node-with-line"), showLine), "".concat(prefixCls, "-leaf-node"), isLeaf), "".concat(prefixCls, "-last-node"), isLast), "".concat(prefixCls, "-node-dragging"), draggingKey === key), "".concat(prefixCls, "-node-drag-over-before"), dropPosition === 'before'), "".concat(prefixCls, "-node-drag-over-after"), dropPosition === 'after'), "".concat(prefixCls, "-node-drag-over-inside"), dropPosition === 'inside'))
140
- // style={{
141
- // paddingLeft: depth * 28 + (isLeaf && checkable ? 24 : 0),
142
- // }}
136
+ className: clsx("".concat(prefixCls, "-node"), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, "".concat(prefixCls, "-node-with-line"), showLine), "".concat(prefixCls, "-leaf-node"), isLeaf), "".concat(prefixCls, "-last-node"), isLast), "".concat(prefixCls, "-node-dragging"), draggingUid === uid), "".concat(prefixCls, "-node-drag-over-before"), dropPosition === 'before'), "".concat(prefixCls, "-node-drag-over-after"), dropPosition === 'after'), "".concat(prefixCls, "-node-drag-over-inside"), dropPosition === 'inside')),
137
+ style: nodeStyle
143
138
  }, dragProps), renderEmptyNodes(depth), renderExpandedIcon(), renderCheckbox(), renderLabel());
144
139
  };
145
140
  export default Node;
@@ -2,7 +2,7 @@ import React, { ChangeEvent } from 'react';
2
2
  import type { DragPosition, TreeProps } from './interface';
3
3
  import './style/index.less';
4
4
  type DropState = {
5
- key: string | number;
5
+ uid: string;
6
6
  position: DragPosition;
7
7
  } | null;
8
8
  export declare const TreeContext: React.Context<{
@@ -12,19 +12,20 @@ export declare const TreeContext: React.Context<{
12
12
  icon?: React.ReactNode | ((props: any) => React.ReactNode);
13
13
  showLine?: boolean | undefined;
14
14
  switcherIcon?: [React.ReactNode, React.ReactNode] | undefined;
15
- selectedKeys: Array<string | number>;
16
- checkedKeys: Array<string | number>;
17
- expandedKeys: Array<string | number>;
15
+ selectedUids: Set<string>;
16
+ checkedUids: Set<string>;
17
+ indeterminateUids: Set<string>;
18
+ expandedUids: Set<string>;
18
19
  draggable?: boolean | undefined;
19
- draggingKey: string | number | null;
20
+ draggingUid: string | null;
20
21
  dropState: DropState;
21
- onCheck: (event: ChangeEvent<HTMLInputElement>) => void;
22
- onSelect: (key: string | number) => void;
23
- onExpand: (key: string | number) => void;
24
- onNodeDragStart: (key: string | number, e: React.DragEvent) => void;
25
- onNodeDragOver: (key: string | number, e: React.DragEvent) => void;
26
- onNodeDragLeave: (key: string | number, e: React.DragEvent) => void;
27
- onNodeDrop: (key: string | number, e: React.DragEvent) => void;
22
+ onCheck: (event: ChangeEvent<HTMLInputElement>, uid: string) => void;
23
+ onSelect: (uid: string) => void;
24
+ onExpand: (uid: string) => void;
25
+ onNodeDragStart: (uid: string, e: React.DragEvent) => void;
26
+ onNodeDragOver: (uid: string, e: React.DragEvent) => void;
27
+ onNodeDragLeave: (uid: string, e: React.DragEvent) => void;
28
+ onNodeDrop: (uid: string, e: React.DragEvent) => void;
28
29
  }>;
29
30
  declare const Tree: <T extends Record<string, unknown> = any>(baseprops: TreeProps<T>) => React.JSX.Element;
30
31
  export default Tree;