@tfdesign/b-end 1.0.4

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 (176) hide show
  1. package/AI_READ_FIRST.md +131 -0
  2. package/LICENSE +21 -0
  3. package/README.md +353 -0
  4. package/package.json +67 -0
  5. package/scripts/check-tfds-contract.mjs +334 -0
  6. package/scripts/check-tfds-integration.mjs +263 -0
  7. package/scripts/postinstall-cursor-skill.mjs +382 -0
  8. package/scripts/setup.mjs +520 -0
  9. package/skills/tfds/CHECKLIST.md +205 -0
  10. package/skills/tfds/COMMON_FAILURES.md +238 -0
  11. package/skills/tfds/DESIGN_PRINCIPLES.md +477 -0
  12. package/skills/tfds/GLOBAL_DESIGN_RULES.md +636 -0
  13. package/skills/tfds/LAYOUT_RECIPES.md +140 -0
  14. package/skills/tfds/LAYOUT_RULES.md +1355 -0
  15. package/skills/tfds/PAGE_ARCHETYPES.md +201 -0
  16. package/skills/tfds/SKILL.md +188 -0
  17. package/skills/tfds/components.index.json +7305 -0
  18. package/skills/tfds/components.summary.json +1809 -0
  19. package/src/_b_end_runtime/components/AiSuggestionShared.jsx +166 -0
  20. package/src/_b_end_runtime/components/Avatar.jsx +325 -0
  21. package/src/_b_end_runtime/components/Avatar.tokens.js +76 -0
  22. package/src/_b_end_runtime/components/AvatarGridPreview.jsx +56 -0
  23. package/src/_b_end_runtime/components/AvatarGroup.jsx +80 -0
  24. package/src/_b_end_runtime/components/AvatarGroup.tokens.js +28 -0
  25. package/src/_b_end_runtime/components/Button.jsx +144 -0
  26. package/src/_b_end_runtime/components/Button.tokens.js +90 -0
  27. package/src/_b_end_runtime/components/Card.jsx +460 -0
  28. package/src/_b_end_runtime/components/Card.tokens.js +124 -0
  29. package/src/_b_end_runtime/components/CardPreview.jsx +51 -0
  30. package/src/_b_end_runtime/components/ChatBubble.jsx +384 -0
  31. package/src/_b_end_runtime/components/ChatBubble.tokens.js +60 -0
  32. package/src/_b_end_runtime/components/ChatBubblePreview.jsx +129 -0
  33. package/src/_b_end_runtime/components/ChatInput.jsx +1399 -0
  34. package/src/_b_end_runtime/components/ChatInput.tokens.js +75 -0
  35. package/src/_b_end_runtime/components/ChatMessage.jsx +2215 -0
  36. package/src/_b_end_runtime/components/ChatMessage.tokens.js +257 -0
  37. package/src/_b_end_runtime/components/ChatMessagePreview.jsx +388 -0
  38. package/src/_b_end_runtime/components/Checkbox.jsx +317 -0
  39. package/src/_b_end_runtime/components/Checkbox.tokens.js +59 -0
  40. package/src/_b_end_runtime/components/ConversationList.jsx +1264 -0
  41. package/src/_b_end_runtime/components/ConversationList.tokens.js +135 -0
  42. package/src/_b_end_runtime/components/ConversationListPreview.jsx +108 -0
  43. package/src/_b_end_runtime/components/CustomerServiceWorkspaceFrame.jsx +324 -0
  44. package/src/_b_end_runtime/components/CustomerServiceWorkspaceFrame.tokens.js +69 -0
  45. package/src/_b_end_runtime/components/DatePicker.jsx +739 -0
  46. package/src/_b_end_runtime/components/DatePicker.tokens.js +99 -0
  47. package/src/_b_end_runtime/components/Empty.jsx +141 -0
  48. package/src/_b_end_runtime/components/Empty.tokens.js +40 -0
  49. package/src/_b_end_runtime/components/Form.jsx +609 -0
  50. package/src/_b_end_runtime/components/Form.tokens.js +77 -0
  51. package/src/_b_end_runtime/components/FormFieldStack.jsx +123 -0
  52. package/src/_b_end_runtime/components/FormFieldStack.tokens.js +12 -0
  53. package/src/_b_end_runtime/components/FormTitle.jsx +119 -0
  54. package/src/_b_end_runtime/components/FormTitle.tokens.js +87 -0
  55. package/src/_b_end_runtime/components/FullScreenPage.jsx +97 -0
  56. package/src/_b_end_runtime/components/FullScreenPage.tokens.js +19 -0
  57. package/src/_b_end_runtime/components/Icon.jsx +172 -0
  58. package/src/_b_end_runtime/components/Icon.tokens.js +26 -0
  59. package/src/_b_end_runtime/components/IconGridPreview.jsx +277 -0
  60. package/src/_b_end_runtime/components/InfoDisplayPanel.jsx +620 -0
  61. package/src/_b_end_runtime/components/InfoDisplayPanel.tokens.js +71 -0
  62. package/src/_b_end_runtime/components/InfoDisplayPanelPreview.jsx +133 -0
  63. package/src/_b_end_runtime/components/Input.jsx +258 -0
  64. package/src/_b_end_runtime/components/Input.tokens.js +68 -0
  65. package/src/_b_end_runtime/components/InputNumber.jsx +242 -0
  66. package/src/_b_end_runtime/components/InputNumber.tokens.js +55 -0
  67. package/src/_b_end_runtime/components/Modal.jsx +155 -0
  68. package/src/_b_end_runtime/components/Modal.tokens.js +73 -0
  69. package/src/_b_end_runtime/components/NavBar.jsx +842 -0
  70. package/src/_b_end_runtime/components/NavBar.tokens.js +97 -0
  71. package/src/_b_end_runtime/components/NavBarPreview.jsx +11 -0
  72. package/src/_b_end_runtime/components/Radio.jsx +227 -0
  73. package/src/_b_end_runtime/components/Radio.tokens.js +59 -0
  74. package/src/_b_end_runtime/components/Select.jsx +766 -0
  75. package/src/_b_end_runtime/components/Select.tokens.js +99 -0
  76. package/src/_b_end_runtime/components/Sheet.jsx +132 -0
  77. package/src/_b_end_runtime/components/Sheet.tokens.js +61 -0
  78. package/src/_b_end_runtime/components/Slider.jsx +346 -0
  79. package/src/_b_end_runtime/components/Slider.tokens.js +47 -0
  80. package/src/_b_end_runtime/components/Switch.jsx +124 -0
  81. package/src/_b_end_runtime/components/Switch.tokens.js +38 -0
  82. package/src/_b_end_runtime/components/Table.jsx +1338 -0
  83. package/src/_b_end_runtime/components/Table.tokens.js +147 -0
  84. package/src/_b_end_runtime/components/TablePreview.jsx +599 -0
  85. package/src/_b_end_runtime/components/Tabs.jsx +149 -0
  86. package/src/_b_end_runtime/components/Tabs.tokens.js +102 -0
  87. package/src/_b_end_runtime/components/Tag.jsx +199 -0
  88. package/src/_b_end_runtime/components/Tag.tokens.js +171 -0
  89. package/src/_b_end_runtime/components/TagBar.jsx +1134 -0
  90. package/src/_b_end_runtime/components/TagBar.tokens.js +75 -0
  91. package/src/_b_end_runtime/components/TagGridPreview.jsx +23 -0
  92. package/src/_b_end_runtime/components/TagInput.jsx +382 -0
  93. package/src/_b_end_runtime/components/TagInput.tokens.js +52 -0
  94. package/src/_b_end_runtime/components/TextArea.jsx +363 -0
  95. package/src/_b_end_runtime/components/TextArea.tokens.js +65 -0
  96. package/src/_b_end_runtime/components/TimePicker.jsx +444 -0
  97. package/src/_b_end_runtime/components/TimePicker.tokens.js +77 -0
  98. package/src/_b_end_runtime/components/Toast.jsx +120 -0
  99. package/src/_b_end_runtime/components/Toast.tokens.js +146 -0
  100. package/src/_b_end_runtime/components/Tooltip.jsx +282 -0
  101. package/src/_b_end_runtime/components/Tooltip.tokens.js +48 -0
  102. package/src/_b_end_runtime/components/TooltipPreview.jsx +50 -0
  103. package/src/_b_end_runtime/components/Upload.jsx +455 -0
  104. package/src/_b_end_runtime/components/Upload.tokens.js +47 -0
  105. package/src/_b_end_runtime/components/avatar-assets/avatar-default.png +0 -0
  106. package/src/_b_end_runtime/components/avatar-group-assets/avatar-group-1.png +0 -0
  107. package/src/_b_end_runtime/components/avatar-group-assets/avatar-group-2.png +0 -0
  108. package/src/_b_end_runtime/components/avatar-group-assets/avatar-group-3.png +0 -0
  109. package/src/_b_end_runtime/components/avatar-group-assets/avatar-group-4.png +0 -0
  110. package/src/_b_end_runtime/components/avatar-group-assets/avatar-group-5.png +0 -0
  111. package/src/_b_end_runtime/components/empty-assets/administrator-1.svg +40 -0
  112. package/src/_b_end_runtime/components/empty-assets/administrator-2.svg +33 -0
  113. package/src/_b_end_runtime/components/empty-assets/construction.svg +33 -0
  114. package/src/_b_end_runtime/components/empty-assets/failure.svg +49 -0
  115. package/src/_b_end_runtime/components/empty-assets/idle.svg +34 -0
  116. package/src/_b_end_runtime/components/empty-assets/no-access.svg +36 -0
  117. package/src/_b_end_runtime/components/empty-assets/no-content.svg +77 -0
  118. package/src/_b_end_runtime/components/empty-assets/no-result.svg +61 -0
  119. package/src/_b_end_runtime/components/empty-assets/not-found.svg +46 -0
  120. package/src/_b_end_runtime/components/empty-assets/success.svg +38 -0
  121. package/src/_b_end_runtime/components/file-type-assets/batch-report.png +0 -0
  122. package/src/_b_end_runtime/components/file-type-assets/catcat.svg +21 -0
  123. package/src/_b_end_runtime/components/file-type-assets/code.png +0 -0
  124. package/src/_b_end_runtime/components/file-type-assets/conversation.png +0 -0
  125. package/src/_b_end_runtime/components/file-type-assets/document.png +0 -0
  126. package/src/_b_end_runtime/components/file-type-assets/feishu-card.png +0 -0
  127. package/src/_b_end_runtime/components/file-type-assets/feishu-sheet.png +0 -0
  128. package/src/_b_end_runtime/components/file-type-assets/feishu.png +0 -0
  129. package/src/_b_end_runtime/components/file-type-assets/image.png +0 -0
  130. package/src/_b_end_runtime/components/file-type-assets/index.js +105 -0
  131. package/src/_b_end_runtime/components/file-type-assets/knowledge.png +0 -0
  132. package/src/_b_end_runtime/components/file-type-assets/pdf.png +0 -0
  133. package/src/_b_end_runtime/components/file-type-assets/pe.png +0 -0
  134. package/src/_b_end_runtime/components/file-type-assets/strategy.png +0 -0
  135. package/src/_b_end_runtime/components/file-type-assets/table.png +0 -0
  136. package/src/_b_end_runtime/components/file-type-assets/webpage.png +0 -0
  137. package/src/_b_end_runtime/components/file-type-assets/xmind.png +0 -0
  138. package/src/_b_end_runtime/components/icons/icon-data.js +12496 -0
  139. package/src/_b_end_runtime/components/nav-bar-assets/bytehi-logo-mark.svg +21 -0
  140. package/src/_b_end_runtime/components/table-assets/avatar.png +0 -0
  141. package/src/_b_end_runtime/components/table-assets/button.png +0 -0
  142. package/src/_b_end_runtime/components/table-assets/icon-chevron-down.png +0 -0
  143. package/src/_b_end_runtime/components/table-cell-assets/avatar.png +0 -0
  144. package/src/_b_end_runtime/components/table-cell-assets/button.png +0 -0
  145. package/src/_b_end_runtime/components/table-cell-assets/checkbox.png +0 -0
  146. package/src/_b_end_runtime/components/table-cell-assets/icon-chevron-right.png +0 -0
  147. package/src/_b_end_runtime/components/table-cell-assets/icon.png +0 -0
  148. package/src/_b_end_runtime/components/table-cell-assets/semi-icons-handle.png +0 -0
  149. package/src/_b_end_runtime/components/table-cell-assets/semi-icons-tree-triangle-right.png +0 -0
  150. package/src/_b_end_runtime/components/table-cell-assets/switch.png +0 -0
  151. package/src/_b_end_runtime/components/tagShared.js +3 -0
  152. package/src/_b_end_runtime/components/team-avatar-assets/chengcheng-murphy.png +0 -0
  153. package/src/_b_end_runtime/components/team-avatar-assets/duan-ran.png +0 -0
  154. package/src/_b_end_runtime/components/team-avatar-assets/guo-zhezhi.png +0 -0
  155. package/src/_b_end_runtime/components/team-avatar-assets/li-siru.png +0 -0
  156. package/src/_b_end_runtime/components/team-avatar-assets/liu-delin.png +0 -0
  157. package/src/_b_end_runtime/components.js +3499 -0
  158. package/src/_b_end_runtime/index.js +9 -0
  159. package/src/_b_end_runtime/page-patterns/BasePageFramePattern.jsx +395 -0
  160. package/src/_b_end_runtime/page-patterns/ChatConversationPattern.jsx +989 -0
  161. package/src/_b_end_runtime/page-patterns/ChatHomePagePattern.jsx +281 -0
  162. package/src/_b_end_runtime/page-patterns/CopilotPagePattern.jsx +380 -0
  163. package/src/_b_end_runtime/page-patterns/CustomerServiceWorkspaceFramePattern.jsx +392 -0
  164. package/src/_b_end_runtime/page-patterns/IMConversationPattern.jsx +590 -0
  165. package/src/_b_end_runtime/page-patterns/McpManagementPage.jsx +237 -0
  166. package/src/_b_end_runtime/page-patterns/StrategyListPage.jsx +189 -0
  167. package/src/_b_end_runtime/page-patterns/TabTopBarListPage.jsx +594 -0
  168. package/src/_b_end_runtime/page-patterns/VariableManagementPage.jsx +87 -0
  169. package/src/_b_end_runtime/page-patterns/pageListShared.jsx +177 -0
  170. package/src/_b_end_runtime/patterns.js +428 -0
  171. package/src/_b_end_runtime/preview-registry.jsx +4719 -0
  172. package/src/_b_end_runtime/teamMembers.js +56 -0
  173. package/src/_b_end_runtime/tokens.js +500 -0
  174. package/src/index.d.ts +1073 -0
  175. package/src/index.js +52 -0
  176. package/theme.css +350 -0
@@ -0,0 +1,609 @@
1
+ /**
2
+ * Form — B端表单组合组件 (Tailwind 内联)
3
+ *
4
+ * Form 只负责字段标题、说明、错误反馈、top/left 布局与字段编排。
5
+ * 平台已有的表单控件必须复用:Input / TextArea / InputNumber / Select / Checkbox / Radio / Switch / DatePicker / Slider / Upload。
6
+ *
7
+ * @prop {Array} [items=null] — 字段配置列表;为空时使用内置示例字段
8
+ * @prop {'vertical'|'grid'} [layout='vertical'] — 字段排列方式
9
+ * @prop {'top'|'left'} [labelPosition='top'] — 默认标签位置;单项可覆盖
10
+ * @prop {'sm'|'md'} [size='md'] — 传给可复用控件的尺寸
11
+ * @prop {number} [columns=1] — grid 布局列数
12
+ * @prop {boolean} [disabled=false] — 是否禁用整个表单
13
+ * @prop {boolean} [requiredMark=true] — required 字段是否显示红色星号
14
+ * @prop {boolean} [labelOptional=false] — 默认标题是否显示“(可选)”
15
+ * @prop {boolean} [labelRequired=false] — 默认标题是否显示红色星号
16
+ * @prop {boolean} [labelAi=false] — 默认标题是否显示 AI 标签
17
+ * @prop {boolean} [labelHelp=false] — 默认标题是否显示 Help 图标
18
+ * @prop {string} [className=''] — 额外类名
19
+ */
20
+
21
+ import { AlertCircle, HelpCircle } from 'lucide-react';
22
+ import Input from './Input';
23
+ import TextArea from './TextArea';
24
+ import InputNumber from './InputNumber';
25
+ import Select from './Select';
26
+ import CheckboxGroup, { Checkbox } from './Checkbox';
27
+ import RadioGroup, { Radio } from './Radio';
28
+ import Switch from './Switch';
29
+ import Slider from './Slider';
30
+ import Upload from './Upload';
31
+ import DatePicker from './DatePicker';
32
+ import TimePicker from './TimePicker';
33
+ import TagInput from './TagInput';
34
+ import Tag from './Tag';
35
+
36
+ export const FORM_FIELD_TYPES = [
37
+ 'input',
38
+ 'input-number',
39
+ 'textarea',
40
+ 'select',
41
+ 'checkbox',
42
+ 'radio',
43
+ 'switch',
44
+ 'date-picker',
45
+ 'time-picker',
46
+ 'slider',
47
+ 'upload',
48
+ 'input-group',
49
+ 'tag-input',
50
+ ];
51
+
52
+ const FORM_SAMPLE_IMAGE = `data:image/svg+xml;utf8,${encodeURIComponent(
53
+ "<svg xmlns='http://www.w3.org/2000/svg' width='96' height='96' viewBox='0 0 96 96'><defs><linearGradient id='g' x1='0' y1='0' x2='1' y2='1'><stop offset='0%' stop-color='#2B90D9'/><stop offset='100%' stop-color='#0A355A'/></linearGradient></defs><rect width='96' height='96' fill='url(#g)'/><circle cx='72' cy='24' r='10' fill='rgba(255,255,255,0.28)'/><path d='M0 66C13 52 25 49 38 56C50 62 59 60 69 51C76 45 85 43 96 45V96H0Z' fill='rgba(255,255,255,0.24)'/></svg>"
54
+ )}`;
55
+
56
+ export const FORM_SAMPLE_ITEMS = [
57
+ { id: 'name', label: '字段标题', type: 'input', placeholder: '请输入' },
58
+ { id: 'amount', label: '字段标题', type: 'input-number', placeholder: '请输入' },
59
+ { id: 'desc', label: '字段标题', type: 'textarea', placeholder: '请输入', showCount: true, maxLength: 140 },
60
+ { id: 'region', label: '字段标题', type: 'select', placeholder: '请选择' },
61
+ { id: 'checks', label: '字段标题', type: 'checkbox', defaultValue: ['a'] },
62
+ { id: 'radios', label: '字段标题', type: 'radio', defaultValue: 'a' },
63
+ { id: 'enabled', label: '字段标题', type: 'switch' },
64
+ { id: 'date', label: '字段标题', type: 'date-picker' },
65
+ { id: 'time', label: '字段标题', type: 'time-picker' },
66
+ { id: 'range', label: '字段标题', type: 'slider', defaultValue: 24 },
67
+ {
68
+ id: 'cover',
69
+ label: '字段标题',
70
+ type: 'upload',
71
+ defaultValue: [{ uid: 'cover', name: 'cover.png', url: FORM_SAMPLE_IMAGE, status: 'done' }],
72
+ },
73
+ { id: 'combined', label: '字段标题', type: 'input-group' },
74
+ { id: 'tag', label: '字段标题', type: 'tag-input', defaultValue: ['标签', '标签', '标签', '标签', '标签'] },
75
+ ];
76
+
77
+ const DEFAULT_SELECT_OPTIONS = [
78
+ { value: 'a', label: '选项 A' },
79
+ { value: 'b', label: '选项 B' },
80
+ { value: 'c', label: '选项 C' },
81
+ ];
82
+
83
+ const DEFAULT_INLINE_OPTIONS = [
84
+ { value: 'a', label: '选项标题' },
85
+ { value: 'b', label: '选项标题' },
86
+ ];
87
+
88
+ /* ── 表单布局 → 字段排列 ── */
89
+ const FORM_LAYOUT_CLASS = {
90
+ vertical: 'flex w-full min-w-0 flex-col items-stretch gap-6',
91
+ grid: 'grid w-full min-w-0 items-start gap-x-[152px] gap-y-[126px]',
92
+ };
93
+
94
+ /* ── 标签位置 → 单字段结构 ── */
95
+ const FIELD_POSITION_CLASS = {
96
+ top: 'flex w-full min-w-0 max-w-full flex-col items-start gap-1 self-stretch',
97
+ left: 'flex w-full min-w-0 max-w-full items-start gap-6 self-stretch',
98
+ };
99
+
100
+ /* ── 左侧标签列 / 右侧内容区 ── */
101
+ const LABEL_COLUMN = 'flex h-[36px] w-[96px] shrink-0 items-center';
102
+ const FIELD_BODY_CLASS = {
103
+ top: 'flex w-full min-w-0 flex-col items-stretch gap-1',
104
+ left: 'flex w-full min-w-0 flex-1 flex-col items-stretch gap-1',
105
+ };
106
+
107
+ /* ── 文本元素 ── */
108
+ const LABEL_TEXT = 'text-sm [font-weight:var(--font-semibold)] leading-5 text-foreground-secondary';
109
+ const REQUIRED_MARK = 'text-sm [font-weight:var(--font-semibold)] leading-5 text-red-500';
110
+ const HELP_TEXT = 'text-sm leading-5 text-foreground-muted';
111
+ const ERROR_TEXT = 'text-sm leading-5 text-red-500';
112
+ const LABEL_OPTIONAL_TEXT = 'text-sm [font-weight:var(--font-semibold)] leading-5 text-foreground-muted';
113
+ const LABEL_HELP_ICON = 'shrink-0 text-foreground-muted';
114
+
115
+ /* ── 表单控件宽度适配 ── */
116
+ const CONTROL_FULL = '!w-full';
117
+ const COMPACT_INLINE = 'inline-flex items-center gap-4 py-[6px]';
118
+
119
+ function normalizeItems(items) {
120
+ return Array.isArray(items) && items.length > 0 ? items : FORM_SAMPLE_ITEMS;
121
+ }
122
+
123
+ function getStatus(item) {
124
+ if (item.status === 'error' || item.error) return 'error';
125
+ return 'default';
126
+ }
127
+
128
+ function renderRequired(required) {
129
+ if (!required) return null;
130
+ return <span className={REQUIRED_MARK}>*</span>;
131
+ }
132
+
133
+ function renderLabelDecorations(item, defaults = {}) {
134
+ const labelRequired = item.labelRequired ?? defaults.labelRequired ?? false;
135
+ const labelAi = item.labelAi ?? defaults.labelAi ?? false;
136
+ const labelHelp = item.labelHelp ?? defaults.labelHelp ?? false;
137
+ const decorations = [];
138
+
139
+ if (labelRequired) decorations.push(renderRequired(true));
140
+
141
+ if (labelAi) {
142
+ decorations.push(
143
+ <Tag
144
+ key="ai"
145
+ variant="ai"
146
+ size="m"
147
+ radius="full"
148
+ fontWeight="bold"
149
+ className="shrink-0"
150
+ >
151
+ AI
152
+ </Tag>
153
+ );
154
+ }
155
+
156
+ if (labelHelp) {
157
+ decorations.push(
158
+ <HelpCircle
159
+ key="help"
160
+ size={16}
161
+ strokeWidth={1.8}
162
+ aria-hidden="true"
163
+ className={LABEL_HELP_ICON}
164
+ />
165
+ );
166
+ }
167
+
168
+ return decorations;
169
+ }
170
+
171
+ function renderFeedback(item, { helpId, errorId } = {}) {
172
+ if (item.error) {
173
+ return (
174
+ <div className="flex w-full items-start gap-1 text-red-500">
175
+ <span className="flex h-5 shrink-0 items-center">
176
+ <AlertCircle size={16} strokeWidth={1.8} />
177
+ </span>
178
+ <p id={errorId} className={ERROR_TEXT}>{item.errorText || '该项目为必填项'}</p>
179
+ </div>
180
+ );
181
+ }
182
+
183
+ if (!item.helpText) return null;
184
+ return <p id={helpId} className={HELP_TEXT}>{item.helpText}</p>;
185
+ }
186
+
187
+ function InputGroupField({ item, disabled, status, size }) {
188
+ return (
189
+ <div className="flex w-full items-center">
190
+ <Select
191
+ id={`${item.id || 'input-group'}-select`}
192
+ size={size}
193
+ status={status}
194
+ disabled={disabled}
195
+ placeholder="请选择"
196
+ options={item.selectOptions || DEFAULT_SELECT_OPTIONS}
197
+ defaultValue={item.selectDefaultValue}
198
+ className="!w-[116px] rounded-r-none"
199
+ />
200
+ <Input
201
+ id={item.id}
202
+ size={size}
203
+ status={status}
204
+ disabled={disabled}
205
+ placeholder={item.placeholder || '请输入'}
206
+ value={item.value}
207
+ defaultValue={item.defaultValue}
208
+ onChange={item.onChange}
209
+ className="-ml-px w-full [&>div]:rounded-l-none"
210
+ />
211
+ </div>
212
+ );
213
+ }
214
+
215
+ function renderControl(item, {
216
+ disabled,
217
+ size,
218
+ labelledBy,
219
+ describedBy,
220
+ }) {
221
+ const type = item.type || 'input';
222
+ const status = getStatus(item);
223
+ const commonDisabled = disabled || item.disabled;
224
+
225
+ if (item.control) return item.control;
226
+
227
+ if (type === 'input-number') {
228
+ return (
229
+ <InputNumber
230
+ id={item.id}
231
+ size={size}
232
+ status={status}
233
+ disabled={commonDisabled}
234
+ innerButtons={item.innerButtons}
235
+ controls={item.controls !== false}
236
+ min={item.min}
237
+ max={item.max}
238
+ step={item.step}
239
+ precision={item.precision}
240
+ placeholder={item.placeholder || '请输入'}
241
+ value={item.value}
242
+ defaultValue={item.defaultValue}
243
+ onChange={item.onChange}
244
+ onStep={item.onStep}
245
+ className={CONTROL_FULL}
246
+ />
247
+ );
248
+ }
249
+
250
+ if (type === 'textarea') {
251
+ const hasMaxLimit = typeof item.maxLength === 'number';
252
+ const showCountResolved = item.showCount === false
253
+ ? false
254
+ : item.showCount === true
255
+ ? true
256
+ : hasMaxLimit;
257
+ return (
258
+ <TextArea
259
+ id={item.id}
260
+ variant={item.variant === 'code' ? 'code' : 'default'}
261
+ minRows={item.minRows ?? 3}
262
+ status={status}
263
+ disabled={commonDisabled}
264
+ placeholder={item.placeholder || '请输入'}
265
+ value={item.value}
266
+ defaultValue={item.defaultValue}
267
+ onChange={item.onChange}
268
+ aiSuggestion={item.aiSuggestion}
269
+ aiSuggestions={item.aiSuggestions}
270
+ onAdoptSuggestion={item.onAdoptSuggestion}
271
+ onRefreshAiSuggestions={item.onRefreshAiSuggestions}
272
+ {...(hasMaxLimit ? { maxLength: item.maxLength } : {})}
273
+ showCount={showCountResolved}
274
+ enforceMaxLength={item.enforceMaxLength !== false}
275
+ resize={item.resize === 'none' ? 'none' : 'vertical'}
276
+ className={CONTROL_FULL}
277
+ />
278
+ );
279
+ }
280
+
281
+ if (type === 'tag-input') {
282
+ return (
283
+ <TagInput
284
+ id={item.id}
285
+ size={size}
286
+ status={status}
287
+ disabled={commonDisabled}
288
+ placeholder={item.placeholder || '请输入'}
289
+ value={item.value}
290
+ defaultValue={item.defaultValue}
291
+ onChange={item.onChange}
292
+ onRemove={item.onRemove}
293
+ aiSuggestion={item.aiSuggestion}
294
+ aiSuggestions={item.aiSuggestions}
295
+ onAdoptSuggestion={item.onAdoptSuggestion}
296
+ onRefreshAiSuggestions={item.onRefreshAiSuggestions}
297
+ closable={item.closable !== false}
298
+ tagVariant="grey"
299
+ tagSize="m"
300
+ className={CONTROL_FULL}
301
+ />
302
+ );
303
+ }
304
+
305
+ if (type === 'select') {
306
+ return (
307
+ <Select
308
+ id={item.id}
309
+ size={size}
310
+ status={status}
311
+ disabled={commonDisabled}
312
+ placeholder={item.placeholder || '请选择'}
313
+ options={item.options || DEFAULT_SELECT_OPTIONS}
314
+ value={item.value}
315
+ defaultValue={item.defaultValue}
316
+ onChange={item.onChange}
317
+ allowClear={item.allowClear}
318
+ aiSuggestion={item.aiSuggestion}
319
+ aiSuggestions={item.aiSuggestions}
320
+ onAdoptSuggestion={item.onAdoptSuggestion}
321
+ onRefreshAiSuggestions={item.onRefreshAiSuggestions}
322
+ className={CONTROL_FULL}
323
+ />
324
+ );
325
+ }
326
+
327
+ if (type === 'checkbox') {
328
+ return (
329
+ <div className={COMPACT_INLINE}>
330
+ <CheckboxGroup
331
+ variant={item.variant || 'brand'}
332
+ size={size}
333
+ layout={item.layout || 'horizontal'}
334
+ disabled={commonDisabled}
335
+ value={item.value}
336
+ defaultValue={item.defaultValue}
337
+ onChange={item.onChange}
338
+ >
339
+ {(item.options || DEFAULT_INLINE_OPTIONS).map((option) => (
340
+ <Checkbox key={option.value} value={option.value} disabled={option.disabled}>
341
+ {option.label}
342
+ </Checkbox>
343
+ ))}
344
+ </CheckboxGroup>
345
+ </div>
346
+ );
347
+ }
348
+
349
+ if (type === 'radio') {
350
+ return (
351
+ <div className={COMPACT_INLINE}>
352
+ <RadioGroup
353
+ variant={item.variant || 'brand'}
354
+ size={size}
355
+ layout={item.layout || 'horizontal'}
356
+ disabled={commonDisabled}
357
+ value={item.value}
358
+ defaultValue={item.defaultValue}
359
+ onChange={item.onChange}
360
+ >
361
+ {(item.options || DEFAULT_INLINE_OPTIONS).map((option) => (
362
+ <Radio key={option.value} value={option.value} disabled={option.disabled}>
363
+ {option.label}
364
+ </Radio>
365
+ ))}
366
+ </RadioGroup>
367
+ </div>
368
+ );
369
+ }
370
+
371
+ if (type === 'switch') {
372
+ return (
373
+ <div className="flex h-[36px] items-center">
374
+ <Switch
375
+ variant={item.variant || 'black'}
376
+ disabled={commonDisabled}
377
+ checked={item.value}
378
+ defaultChecked={item.defaultChecked}
379
+ onChange={item.onChange}
380
+ />
381
+ </div>
382
+ );
383
+ }
384
+
385
+ if (type === 'date-picker') {
386
+ return (
387
+ <DatePicker
388
+ id={item.id}
389
+ type={item.pickerType || 'date'}
390
+ disabled={commonDisabled}
391
+ placeholder={item.placeholder}
392
+ value={item.value}
393
+ defaultValue={item.defaultValue}
394
+ onChange={item.onChange}
395
+ className={CONTROL_FULL}
396
+ />
397
+ );
398
+ }
399
+
400
+ if (type === 'time-picker') {
401
+ return (
402
+ <TimePicker
403
+ id={item.id}
404
+ type={item.pickerType || 'time'}
405
+ disabled={commonDisabled}
406
+ placeholder={item.placeholder}
407
+ value={item.value}
408
+ defaultValue={item.defaultValue}
409
+ onChange={item.onChange}
410
+ className={CONTROL_FULL}
411
+ />
412
+ );
413
+ }
414
+
415
+ if (type === 'slider') {
416
+ return (
417
+ <div className="flex h-[36px] w-full items-center">
418
+ <Slider
419
+ id={item.id}
420
+ min={item.min}
421
+ max={item.max}
422
+ step={item.step}
423
+ marks={item.marks}
424
+ disabled={commonDisabled}
425
+ value={item.value}
426
+ defaultValue={item.defaultValue}
427
+ onChange={item.onChange}
428
+ onAfterChange={item.onAfterChange}
429
+ showTooltip={item.showTooltip}
430
+ ariaLabel={item.ariaLabel}
431
+ ariaLabelStart={item.ariaLabelStart}
432
+ ariaLabelEnd={item.ariaLabelEnd}
433
+ ariaLabelledBy={labelledBy}
434
+ ariaDescribedBy={describedBy}
435
+ className={CONTROL_FULL}
436
+ />
437
+ </div>
438
+ );
439
+ }
440
+
441
+ if (type === 'upload') {
442
+ return (
443
+ <Upload
444
+ disabled={commonDisabled}
445
+ limit={item.limit || 3}
446
+ value={item.value}
447
+ defaultValue={item.defaultValue}
448
+ onChange={item.onChange}
449
+ />
450
+ );
451
+ }
452
+
453
+ if (type === 'input-group') {
454
+ return <InputGroupField item={item} disabled={commonDisabled} status={status} size={size} />;
455
+ }
456
+
457
+ return (
458
+ <Input
459
+ id={item.id}
460
+ size={size}
461
+ status={status}
462
+ disabled={commonDisabled}
463
+ placeholder={item.placeholder || '请输入'}
464
+ value={item.value}
465
+ defaultValue={item.defaultValue}
466
+ onChange={item.onChange}
467
+ prefix={item.prefix}
468
+ suffix={item.suffix}
469
+ allowClear={item.allowClear}
470
+ aiSuggestion={item.aiSuggestion}
471
+ aiSuggestions={item.aiSuggestions}
472
+ onAdoptSuggestion={item.onAdoptSuggestion}
473
+ onRefreshAiSuggestions={item.onRefreshAiSuggestions}
474
+ className={CONTROL_FULL}
475
+ />
476
+ );
477
+ }
478
+
479
+ export function FormField({
480
+ item,
481
+ labelPosition = 'top',
482
+ size = 'md',
483
+ disabled = false,
484
+ requiredMark = true,
485
+ labelOptional = false,
486
+ labelRequired = false,
487
+ labelAi = false,
488
+ labelHelp = false,
489
+ }) {
490
+ const position = item.labelPosition || labelPosition;
491
+ const fieldContainerClassName = item.fullWidth
492
+ ? 'flex w-full min-w-0 max-w-full flex-col items-start gap-1 self-stretch'
493
+ : (FIELD_POSITION_CLASS[position] || FIELD_POSITION_CLASS.top);
494
+ const fieldBodyClassName = item.fullWidth
495
+ ? 'flex w-full min-w-0 flex-col items-stretch gap-1'
496
+ : (FIELD_BODY_CLASS[position] || FIELD_BODY_CLASS.top);
497
+ const fieldId = item.id || item.name || item.label || 'form-field';
498
+ const labelId = `${fieldId}-label`;
499
+ const middleHelpId = item.middleHelpText ? `${fieldId}-middle-help` : undefined;
500
+ const helpId = item.helpText && !item.error ? `${fieldId}-help` : undefined;
501
+ const errorId = item.error ? `${fieldId}-error` : undefined;
502
+ const describedBy = [middleHelpId, helpId, errorId].filter(Boolean).join(' ') || undefined;
503
+ const isSliderField = item.type === 'slider';
504
+ const showLabelOptional = item.labelOptional ?? labelOptional ?? false;
505
+ const labelNode = item.label !== false ? (
506
+ <label
507
+ id={labelId}
508
+ htmlFor={isSliderField ? undefined : fieldId}
509
+ className="flex min-w-0 flex-wrap items-center gap-[2px]"
510
+ >
511
+ <span className="inline-flex min-w-0 shrink-0 items-center gap-[2px] whitespace-nowrap">
512
+ <span className={LABEL_TEXT}>{item.label || '字段标题'}</span>
513
+ {showLabelOptional ? (
514
+ <span className={LABEL_OPTIONAL_TEXT}>(可选)</span>
515
+ ) : null}
516
+ </span>
517
+ {renderLabelDecorations(item, {
518
+ labelOptional,
519
+ labelRequired,
520
+ labelAi,
521
+ labelHelp,
522
+ })}
523
+ </label>
524
+ ) : null;
525
+
526
+ const fieldBody = (
527
+ <div className={fieldBodyClassName}>
528
+ {item.middleHelpText ? <p id={middleHelpId} className={HELP_TEXT}>{item.middleHelpText}</p> : null}
529
+ {renderControl(item, {
530
+ disabled,
531
+ size,
532
+ labelledBy: labelNode ? labelId : undefined,
533
+ describedBy,
534
+ })}
535
+ {renderFeedback(item, { helpId, errorId })}
536
+ </div>
537
+ );
538
+
539
+ if (position === 'left') {
540
+ return (
541
+ <div className={fieldContainerClassName}>
542
+ <div className={LABEL_COLUMN}>{labelNode}</div>
543
+ {fieldBody}
544
+ </div>
545
+ );
546
+ }
547
+
548
+ return (
549
+ <div className={fieldContainerClassName}>
550
+ {labelNode}
551
+ {fieldBody}
552
+ </div>
553
+ );
554
+ }
555
+
556
+ export default function Form({
557
+ items = null,
558
+ layout = 'vertical',
559
+ labelPosition = 'top',
560
+ size = 'md',
561
+ columns = 1,
562
+ disabled = false,
563
+ requiredMark = true,
564
+ labelOptional = false,
565
+ labelRequired = false,
566
+ labelAi = false,
567
+ labelHelp = false,
568
+ className = '',
569
+ children,
570
+ ...rest
571
+ }) {
572
+ const normalized = normalizeItems(items);
573
+ const useGrid = layout === 'grid';
574
+ const formCls = [
575
+ FORM_LAYOUT_CLASS[layout] || FORM_LAYOUT_CLASS.vertical,
576
+ className,
577
+ ].filter(Boolean).join(' ');
578
+
579
+ const gridStyle = useGrid
580
+ ? { gridTemplateColumns: `repeat(${Math.max(1, Number(columns) || 1)}, minmax(0, 1fr))` }
581
+ : undefined;
582
+
583
+ if (children) {
584
+ return (
585
+ <form className={[`tfds-form`, formCls].filter(Boolean).join(' ')} style={gridStyle} {...rest} data-tfds-component="Form">
586
+ {children}
587
+ </form>
588
+ );
589
+ }
590
+
591
+ return (
592
+ <form className={[`tfds-form`, formCls].filter(Boolean).join(' ')} style={gridStyle} {...rest} data-tfds-component="Form">
593
+ {normalized.map((item) => (
594
+ <FormField
595
+ key={item.id || item.name || `${item.label}-${item.type}`}
596
+ item={item}
597
+ labelPosition={labelPosition}
598
+ size={size}
599
+ disabled={disabled}
600
+ requiredMark={requiredMark}
601
+ labelOptional={labelOptional}
602
+ labelRequired={labelRequired}
603
+ labelAi={labelAi}
604
+ labelHelp={labelHelp}
605
+ />
606
+ ))}
607
+ </form>
608
+ );
609
+ }
@@ -0,0 +1,77 @@
1
+ /**
2
+ * Form — TOKEN_MAP(供平台属性面板展示)
3
+ *
4
+ * 分组顺序:文本元素 → 容器区域 → 尺寸 → 引用组件
5
+ */
6
+ export const FORM_TOKEN_MAP = {
7
+ base: [],
8
+ 标签: [
9
+ { label: '颜色', cssProp: 'color', token: '--text-secondary', value: '#475467', semanticRef: 'text-secondary' },
10
+ { label: '字号', cssProp: 'font-size', token: '--text-sm', value: '14px' },
11
+ { label: '字重', cssProp: 'font-weight', token: '--font-semibold', value: '600' },
12
+ { label: '行高', cssProp: 'line-height', token: '--leading-5', value: '20px' },
13
+ { label: '必填色', cssProp: 'color', token: '--color-red-500', value: '#F74331', semanticRef: 'status-danger', state: 'required' },
14
+ ],
15
+ 提示: [
16
+ { label: '颜色', cssProp: 'color', token: '--text-tertiary', value: '#667085', semanticRef: 'text-tertiary' },
17
+ { label: '字号', cssProp: 'font-size', token: '--text-sm', value: '14px' },
18
+ { label: '行高', cssProp: 'line-height', token: '--leading-5', value: '20px' },
19
+ ],
20
+ AI标签: [
21
+ { label: '引用组件', cssProp: 'component', value: 'Tag variant="ai" radius="full" fontWeight="bold" size="m"' },
22
+ { label: '背景', cssProp: 'background', token: '--bg-chat-outgoing-ai', value: 'linear-gradient(90deg, rgba(230, 247, 244, 1) 0%, rgba(239, 246, 255, 1) 55%, rgba(243, 245, 255, 1) 90%, rgba(252, 243, 255, 1) 100%)', semanticRef: 'bg-chat-outgoing-ai' },
23
+ { label: '文字', cssProp: 'color', token: '--gradient-ai-fill-text', value: 'linear-gradient(135deg, rgba(22, 218, 203, 1) 0%, rgba(49, 134, 212, 1) 20%, rgba(111, 88, 227, 1) 70%, rgba(231, 116, 221, 1) 100%)', semanticRef: 'ai-fill-text' },
24
+ { label: '圆角', cssProp: 'border-radius', token: '--radius-full', value: '999px' },
25
+ { label: '尺寸', cssProp: 'height', value: '20px' },
26
+ ],
27
+ 反馈: [
28
+ { label: '颜色', cssProp: 'color', token: '--color-red-500', value: '#F74331', semanticRef: 'status-danger' },
29
+ { label: '图标尺寸', cssProp: 'width / height', token: '--spacing-4', value: '16px' },
30
+ { label: '图文间距', cssProp: 'gap', token: '--spacing-1', value: '4px' },
31
+ ],
32
+ 字段: [
33
+ { label: '顶部间距', cssProp: 'gap', token: '--spacing-1', value: '4px', state: 'top' },
34
+ { label: '左侧间距', cssProp: 'gap', token: '--spacing-6', value: '24px', state: 'left' },
35
+ { label: '标签列宽', cssProp: 'width', value: '96px', state: 'left' },
36
+ { label: '顶宽度', cssProp: 'width', token: '--size-input-width', value: '300px', state: 'top' },
37
+ { label: '左侧字段总宽', cssProp: 'width', value: '420px', state: 'left' },
38
+ { label: '左侧控件宽度', cssProp: 'width', token: '--size-input-width', value: '300px', state: 'left' },
39
+ ],
40
+ 表单: [
41
+ { label: '纵向间距', cssProp: 'gap', token: '--spacing-6', value: '24px', state: 'vertical' },
42
+ { label: '全集预览间距', cssProp: 'gap', value: '40px', state: 'preview-all' },
43
+ { label: '横向间距', cssProp: 'column-gap', value: '152px', state: 'grid' },
44
+ { label: '行间距', cssProp: 'row-gap', value: '126px', state: 'grid' },
45
+ ],
46
+ 文本域: [
47
+ { label: '背景色', cssProp: 'background', token: '--color-surface', value: '#FFFFFF', semanticRef: 'bg-surface' },
48
+ { label: '边框色', cssProp: 'border-color', token: '--color-border-default', value: '#E4E7EC', semanticRef: 'border-default' },
49
+ { label: '圆角', cssProp: 'border-radius', token: '--radius-md', value: '8px' },
50
+ { label: '最小高', cssProp: 'min-height', value: '92px' },
51
+ { label: '横内距', cssProp: 'padding-inline', token: '--spacing-3', value: '12px' },
52
+ { label: '纵内距', cssProp: 'padding-block', value: '6px' },
53
+ { label: '计数色', cssProp: 'color', token: '--text-tertiary', value: '#667085', semanticRef: 'text-tertiary' },
54
+ ],
55
+ sizes: {
56
+ sm: [
57
+ { label: '控件高度', cssProp: 'height', token: '--size-control-sm', value: '24px' },
58
+ { label: '字号', cssProp: 'font-size', token: '--text-xs', value: '12px' },
59
+ ],
60
+ md: [
61
+ { label: '控件高度', cssProp: 'height', token: '--size-control-md', value: '36px' },
62
+ { label: '字号', cssProp: 'font-size', token: '--text-sm', value: '14px' },
63
+ ],
64
+ },
65
+ 引用组件: [
66
+ { label: '文本输入', cssProp: '—', value: 'Input md/sm' },
67
+ { label: '选择器', cssProp: '—', value: 'Select md/sm' },
68
+ { label: '标签输入', cssProp: '—', value: 'TagInput md/sm' },
69
+ { label: '复选组', cssProp: '—', value: 'CheckboxGroup + Checkbox' },
70
+ { label: '单选组', cssProp: '—', value: 'RadioGroup + Radio' },
71
+ { label: '开关', cssProp: '—', value: 'Switch black sm' },
72
+ { label: '日期', cssProp: '—', value: 'DatePicker date' },
73
+ { label: '时间', cssProp: '—', value: 'TimePicker time' },
74
+ { label: '滑块', cssProp: '—', value: 'Slider single/range' },
75
+ { label: '上传', cssProp: '—', value: 'Upload picture' },
76
+ ],
77
+ };