@h-ai/ui 1.0.0-beta.2 → 1.0.0-beta.21

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 (167) hide show
  1. package/README.en.md +252 -70
  2. package/README.ja.md +251 -69
  3. package/README.md +253 -72
  4. package/auto-import.d.ts +5 -0
  5. package/auto-import.js +242 -65
  6. package/dist/components/compounds/Accordion.svelte +6 -2
  7. package/dist/components/compounds/BottomNav.svelte +14 -2
  8. package/dist/components/compounds/Card.svelte +3 -1
  9. package/dist/components/compounds/Combobox.svelte +41 -5
  10. package/dist/components/compounds/DataTable.svelte +28 -8
  11. package/dist/components/compounds/DatePicker.svelte +6 -1
  12. package/dist/components/compounds/Drawer.svelte +12 -4
  13. package/dist/components/compounds/Dropdown.svelte +135 -59
  14. package/dist/components/compounds/Empty.svelte +10 -2
  15. package/dist/components/compounds/FormField.svelte +10 -2
  16. package/dist/components/compounds/JsonViewer.svelte +18 -6
  17. package/dist/components/compounds/Modal.svelte +8 -2
  18. package/dist/components/compounds/Pagination.svelte +22 -7
  19. package/dist/components/compounds/Popover.svelte +93 -12
  20. package/dist/components/compounds/Steps.svelte +24 -8
  21. package/dist/components/compounds/SwipeCell.svelte +3 -1
  22. package/dist/components/compounds/TableToolbar.svelte +32 -9
  23. package/dist/components/compounds/Tabs.svelte +25 -5
  24. package/dist/components/compounds/TagInput.svelte +2 -0
  25. package/dist/components/compounds/Timeline.svelte +6 -2
  26. package/dist/components/compounds/ToastContainer.svelte +41 -10
  27. package/dist/components/compounds/Tooltip.svelte +1 -1
  28. package/dist/components/compounds/Tooltip.svelte.d.ts +1 -1
  29. package/dist/components/control-size.js +48 -8
  30. package/dist/components/primitives/Avatar.svelte +9 -3
  31. package/dist/components/primitives/BareInput.svelte +3 -1
  32. package/dist/components/primitives/Button.svelte +6 -2
  33. package/dist/components/primitives/Checkbox.svelte +5 -0
  34. package/dist/components/primitives/IconButton.svelte +3 -1
  35. package/dist/components/primitives/Input.svelte +19 -3
  36. package/dist/components/primitives/Radio.svelte +4 -1
  37. package/dist/components/primitives/Range.svelte +3 -1
  38. package/dist/components/primitives/Rating.svelte +9 -3
  39. package/dist/components/primitives/Select.svelte +21 -5
  40. package/dist/components/primitives/Tag.svelte +6 -10
  41. package/dist/components/primitives/Textarea.svelte +14 -2
  42. package/dist/components/scenes/ai/AiDocumentEditor.svelte +40 -12
  43. package/dist/components/scenes/ai/document-download.js +6 -2
  44. package/dist/components/scenes/ai/document-parse.js +24 -8
  45. package/dist/components/scenes/ai/editor-markdown-extensions.js +9 -3
  46. package/dist/components/scenes/ai/highlight.js +18 -1
  47. package/dist/components/scenes/ai/markdown-parse.js +81 -28
  48. package/dist/components/scenes/ai/mermaid-render.js +13 -1
  49. package/dist/components/scenes/ai/safe-html.js +9 -3
  50. package/dist/components/scenes/ai/table/AiTableEditor.svelte +27 -9
  51. package/dist/components/scenes/app/FeedbackDetail.svelte +102 -24
  52. package/dist/components/scenes/app/FeedbackForm.svelte +70 -16
  53. package/dist/components/scenes/app/FeedbackList.svelte +138 -21
  54. package/dist/components/scenes/app/FeedbackRecorder.svelte +18 -5
  55. package/dist/components/scenes/app/FeedbackReplay.svelte +15 -3
  56. package/dist/components/scenes/app/FeedbackScreenshot.svelte +64 -13
  57. package/dist/components/scenes/app/LanguageSwitch.svelte +6 -2
  58. package/dist/components/scenes/app/SettingsLayout.svelte +3 -1
  59. package/dist/components/scenes/app/ThemeSelector.svelte +29 -5
  60. package/dist/components/scenes/app/ThemeToggle.svelte +6 -2
  61. package/dist/components/scenes/app/WorkspaceLayout.svelte +1 -1
  62. package/dist/components/scenes/app/feedback-functions.js +6 -2
  63. package/dist/components/scenes/charts/Chart.svelte +55 -21
  64. package/dist/components/scenes/charts/Chart.svelte.d.ts +0 -1
  65. package/dist/components/scenes/charts/ChartLoadError.svelte +13 -0
  66. package/dist/components/scenes/charts/ChartLoadError.svelte.d.ts +6 -0
  67. package/dist/components/scenes/charts/DashboardGrid.svelte +34 -0
  68. package/dist/components/scenes/charts/DashboardGrid.svelte.d.ts +15 -0
  69. package/dist/components/scenes/charts/MetricCard.svelte +69 -0
  70. package/dist/components/scenes/charts/MetricCard.svelte.d.ts +15 -0
  71. package/dist/components/scenes/charts/ReportCard.svelte +48 -0
  72. package/dist/components/scenes/charts/ReportCard.svelte.d.ts +15 -0
  73. package/dist/components/scenes/charts/chart-presets.d.ts +15 -0
  74. package/dist/components/scenes/charts/chart-presets.js +56 -0
  75. package/dist/components/scenes/charts/chart-types.d.ts +13 -2
  76. package/dist/components/scenes/charts/dashboard-types.d.ts +79 -0
  77. package/dist/components/scenes/charts/dashboard-types.js +1 -0
  78. package/dist/components/scenes/charts/index.d.ts +6 -2
  79. package/dist/components/scenes/charts/index.js +4 -1
  80. package/dist/components/scenes/charts/renderers/AreaChart.svelte +1 -0
  81. package/dist/components/scenes/charts/renderers/AreaChart.svelte.d.ts +1 -0
  82. package/dist/components/scenes/charts/renderers/BarChart.svelte +1 -0
  83. package/dist/components/scenes/charts/renderers/BarChart.svelte.d.ts +1 -0
  84. package/dist/components/scenes/charts/renderers/LineChart.svelte +39 -12
  85. package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +1 -0
  86. package/dist/components/scenes/charts/renderers/PieChart.svelte +1 -0
  87. package/dist/components/scenes/charts/renderers/PieChart.svelte.d.ts +1 -0
  88. package/dist/components/scenes/charts/renderers/ScatterChart.svelte +1 -0
  89. package/dist/components/scenes/charts/renderers/ScatterChart.svelte.d.ts +1 -0
  90. package/dist/components/scenes/code/CodeWorkspace.svelte +946 -0
  91. package/dist/components/scenes/code/CodeWorkspace.svelte.d.ts +21 -0
  92. package/dist/components/scenes/code/CodeWorkspaceEditor.svelte +737 -0
  93. package/dist/components/scenes/code/CodeWorkspaceEditor.svelte.d.ts +37 -0
  94. package/dist/components/scenes/code/CodeWorkspaceGutter.svelte +246 -0
  95. package/dist/components/scenes/code/CodeWorkspaceGutter.svelte.d.ts +23 -0
  96. package/dist/components/scenes/code/CodeWorkspaceSearch.svelte +234 -0
  97. package/dist/components/scenes/code/CodeWorkspaceSearch.svelte.d.ts +23 -0
  98. package/dist/components/scenes/code/CodeWorkspaceTree.svelte +519 -0
  99. package/dist/components/scenes/code/CodeWorkspaceTree.svelte.d.ts +26 -0
  100. package/dist/components/scenes/code/code-editor.d.ts +12 -0
  101. package/dist/components/scenes/code/code-editor.js +93 -0
  102. package/dist/components/scenes/code/code-types.d.ts +346 -0
  103. package/dist/components/scenes/code/code-types.js +1 -0
  104. package/dist/components/scenes/code/index.d.ts +2 -0
  105. package/dist/components/scenes/code/index.js +1 -0
  106. package/dist/components/scenes/code/workers/css.worker.d.ts +1 -0
  107. package/dist/components/scenes/code/workers/css.worker.js +1 -0
  108. package/dist/components/scenes/code/workers/editor.worker.d.ts +1 -0
  109. package/dist/components/scenes/code/workers/editor.worker.js +1 -0
  110. package/dist/components/scenes/code/workers/html.worker.d.ts +1 -0
  111. package/dist/components/scenes/code/workers/html.worker.js +1 -0
  112. package/dist/components/scenes/code/workers/json.worker.d.ts +1 -0
  113. package/dist/components/scenes/code/workers/json.worker.js +1 -0
  114. package/dist/components/scenes/code/workers/ts.worker.d.ts +1 -0
  115. package/dist/components/scenes/code/workers/ts.worker.js +1 -0
  116. package/dist/components/scenes/crud/CrudDetailDrawer.svelte +6 -2
  117. package/dist/components/scenes/crud/CrudDetailPanel.svelte +6 -2
  118. package/dist/components/scenes/crud/CrudEditPanel.svelte +41 -12
  119. package/dist/components/scenes/crud/CrudPage.svelte +34 -9
  120. package/dist/components/scenes/crud/crud-controller.svelte.js +23 -8
  121. package/dist/components/scenes/crud/crud-form-validation.js +27 -9
  122. package/dist/components/scenes/crypto/EncryptedInput.svelte +9 -3
  123. package/dist/components/scenes/error/error-presets.js +30 -5
  124. package/dist/components/scenes/guide/GuideHostContent.svelte +7 -1
  125. package/dist/components/scenes/guide/HelpCenter.svelte +23 -4
  126. package/dist/components/scenes/iam/AgreementNotice.svelte +9 -3
  127. package/dist/components/scenes/iam/AuthPanel.svelte +74 -16
  128. package/dist/components/scenes/iam/ChangePasswordForm.svelte +6 -2
  129. package/dist/components/scenes/iam/ForgotPasswordForm.svelte +9 -3
  130. package/dist/components/scenes/iam/LoginForm.svelte +32 -8
  131. package/dist/components/scenes/iam/PasswordInput.svelte +50 -12
  132. package/dist/components/scenes/iam/RegisterForm.svelte +11 -3
  133. package/dist/components/scenes/iam/ResetPasswordForm.svelte +6 -2
  134. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte +3 -1
  135. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte +4 -1
  136. package/dist/components/scenes/iam/UserProfile.svelte +41 -14
  137. package/dist/components/scenes/iam/auth-captcha.js +9 -2
  138. package/dist/components/scenes/iam/auth-error-message.d.ts +2 -2
  139. package/dist/components/scenes/iam/auth-error-message.js +16 -3
  140. package/dist/components/scenes/iam/password-utils.js +9 -2
  141. package/dist/components/scenes/iam/sensitive-actions.svelte.js +4 -1
  142. package/dist/components/scenes/index.d.ts +1 -0
  143. package/dist/components/scenes/index.js +2 -0
  144. package/dist/components/scenes/storage/FileList.svelte +3 -1
  145. package/dist/components/scenes/storage/FileUpload.svelte +7 -2
  146. package/dist/components/scenes/types.d.ts +2 -2
  147. package/dist/guide-storage.js +12 -4
  148. package/dist/guide.svelte.js +59 -16
  149. package/dist/i18n.svelte.js +9 -3
  150. package/dist/internal/dialog-focus.d.ts +19 -0
  151. package/dist/internal/dialog-focus.js +104 -4
  152. package/dist/internal/form-validation.svelte.js +46 -15
  153. package/dist/internal/icon-safety.js +6 -2
  154. package/dist/message.svelte.js +6 -2
  155. package/dist/messagebox.svelte.js +6 -2
  156. package/dist/messages/en-US.json +60 -1
  157. package/dist/messages/ja-JP.json +60 -1
  158. package/dist/messages/zh-CN.json +60 -1
  159. package/dist/styles/eye-care.css +55 -0
  160. package/dist/styles/global.css +16 -0
  161. package/dist/styles/theme.css +1 -0
  162. package/dist/theme-config.d.ts +1 -1
  163. package/dist/theme-config.js +136 -21
  164. package/dist/toast.svelte.js +14 -3
  165. package/dist/types.d.ts +3 -3
  166. package/dist/utils.js +6 -2
  167. package/package.json +25 -19
@@ -0,0 +1,346 @@
1
+ import type { Snippet } from 'svelte';
2
+ /**
3
+ * 文件和目录旁的宿主标记。label 提供给辅助技术,text 用于显示简短标记。
4
+ *
5
+ * @example
6
+ * ```ts
7
+ * import type { CodeWorkspaceMarker } from '@h-ai/ui/components/scenes/code/index'
8
+ * const marker: CodeWorkspaceMarker = { label: 'Uncommitted changes', text: 'M', tone: 'warning' }
9
+ * ```
10
+ */
11
+ export interface CodeWorkspaceMarker {
12
+ label: string;
13
+ text?: string;
14
+ tone?: 'neutral' | 'info' | 'success' | 'warning' | 'error';
15
+ }
16
+ /**
17
+ * 目录 ID 在同一个数据源中唯一。
18
+ *
19
+ * @example
20
+ * ```ts
21
+ * import type { CodeWorkspaceFolder } from '@h-ai/ui/components/scenes/code/index'
22
+ * const folder: CodeWorkspaceFolder = { kind: 'folder', id: 'src', name: 'src' }
23
+ * ```
24
+ */
25
+ export interface CodeWorkspaceFolder {
26
+ kind: 'folder';
27
+ id: string;
28
+ name: string;
29
+ markers?: readonly CodeWorkspaceMarker[];
30
+ }
31
+ /**
32
+ * 同一文件 ID 可以对应多个版本,标签按 ID 和版本去重。
33
+ *
34
+ * @example
35
+ * ```ts
36
+ * import type { CodeWorkspaceFileNode } from '@h-ai/ui/components/scenes/code/index'
37
+ * const file: CodeWorkspaceFileNode = { kind: 'file', id: 'src/app.ts', name: 'app.ts', version: 'rev-1' }
38
+ * ```
39
+ */
40
+ export interface CodeWorkspaceFileNode {
41
+ kind: 'file';
42
+ id: string;
43
+ name: string;
44
+ version?: string;
45
+ markers?: readonly CodeWorkspaceMarker[];
46
+ }
47
+ /**
48
+ * 文件树可呈现的节点。
49
+ *
50
+ * @example
51
+ * ```ts
52
+ * import type { CodeWorkspaceNode } from '@h-ai/ui/components/scenes/code/index'
53
+ * const node: CodeWorkspaceNode = { kind: 'file', id: 'readme', name: 'README.md' }
54
+ * ```
55
+ */
56
+ export type CodeWorkspaceNode = CodeWorkspaceFolder | CodeWorkspaceFileNode;
57
+ /**
58
+ * 坐标从 1 开始,列按 UTF-16 计数,结束位置不包含在范围内。起止相同表示一个位置。
59
+ *
60
+ * @example
61
+ * ```ts
62
+ * import type { CodeWorkspaceRange } from '@h-ai/ui/components/scenes/code/index'
63
+ * const firstWord: CodeWorkspaceRange = { startLine: 1, startColumn: 1, endLine: 1, endColumn: 6 }
64
+ * ```
65
+ */
66
+ export interface CodeWorkspaceRange {
67
+ startLine: number;
68
+ startColumn: number;
69
+ endLine: number;
70
+ endColumn: number;
71
+ }
72
+ /**
73
+ * 代码文件随内容加载的行或范围标注。
74
+ *
75
+ * @example
76
+ * ```ts
77
+ * import type { CodeWorkspaceAnnotation } from '@h-ai/ui/components/scenes/code/index'
78
+ * const annotation: CodeWorkspaceAnnotation = {
79
+ * label: 'Local changes',
80
+ * range: { startLine: 4, startColumn: 1, endLine: 5, endColumn: 1 },
81
+ * tone: 'info',
82
+ * hoverText: 'This line has uncommitted changes.',
83
+ * }
84
+ * ```
85
+ */
86
+ export interface CodeWorkspaceAnnotation {
87
+ range: CodeWorkspaceRange;
88
+ label: string;
89
+ tone?: CodeWorkspaceMarker['tone'];
90
+ display?: 'gutter' | 'range' | 'both';
91
+ /** 在标注起始行显示图标与纯文本浮层,仅适用于含行前标记的标注。 */
92
+ hoverText?: string;
93
+ }
94
+ /**
95
+ * 行前图标和浮层收到的当前文件及标注。
96
+ *
97
+ * @example
98
+ * ```ts
99
+ * import type { CodeWorkspaceAnnotationContext } from '@h-ai/ui/components/scenes/code/index'
100
+ * function tooltip({ file, annotation }: CodeWorkspaceAnnotationContext) {
101
+ * return file.node.name + ': ' + (annotation.hoverText ?? annotation.label)
102
+ * }
103
+ * ```
104
+ */
105
+ export interface CodeWorkspaceAnnotationContext {
106
+ file: CodeWorkspaceFile;
107
+ annotation: CodeWorkspaceAnnotation;
108
+ }
109
+ /**
110
+ * 读取文件返回的文档,可指定 Monaco 语言 ID,例如 typescript。
111
+ *
112
+ * @example
113
+ * ```ts
114
+ * import type { CodeWorkspaceFileContent } from '@h-ai/ui/components/scenes/code/index'
115
+ * const content: CodeWorkspaceFileContent = { text: 'export const value = 1', language: 'typescript' }
116
+ * ```
117
+ */
118
+ export interface CodeWorkspaceFileContent {
119
+ text: string;
120
+ language?: string;
121
+ version?: string;
122
+ annotations?: readonly CodeWorkspaceAnnotation[];
123
+ }
124
+ /**
125
+ * 提供给宿主界面的当前文档。
126
+ *
127
+ * @example
128
+ * ```ts
129
+ * import type { CodeWorkspaceFile } from '@h-ai/ui/components/scenes/code/index'
130
+ * const file: CodeWorkspaceFile = {
131
+ * node: { kind: 'file', id: 'readme', name: 'README.md' },
132
+ * text: '# Getting started',
133
+ * language: 'markdown',
134
+ * }
135
+ * ```
136
+ */
137
+ export interface CodeWorkspaceFile extends CodeWorkspaceFileContent {
138
+ node: CodeWorkspaceFileNode;
139
+ }
140
+ /**
141
+ * 工作区搜索请求。cursor 是数据源上一次返回的分页游标。
142
+ *
143
+ * @example
144
+ * ```ts
145
+ * import type { CodeWorkspaceSearchQuery } from '@h-ai/ui/components/scenes/code/index'
146
+ * const query: CodeWorkspaceSearchQuery = { mode: 'content', query: 'summarize', cursor: 'page-2' }
147
+ * ```
148
+ */
149
+ export interface CodeWorkspaceSearchQuery {
150
+ mode: 'files' | 'content';
151
+ query: string;
152
+ cursor?: string;
153
+ }
154
+ /**
155
+ * 工作区命中。目录链从根下第一个目录到父目录,range 对应 node.version。
156
+ *
157
+ * @example
158
+ * ```ts
159
+ * import type { CodeWorkspaceSearchHit } from '@h-ai/ui/components/scenes/code/index'
160
+ * const hit: CodeWorkspaceSearchHit = {
161
+ * node: { kind: 'file', id: 'readme', name: 'README.md', version: 'rev-1' },
162
+ * range: { startLine: 1, startColumn: 3, endLine: 1, endColumn: 8 },
163
+ * preview: '# Hello',
164
+ * }
165
+ * ```
166
+ */
167
+ export interface CodeWorkspaceSearchHit {
168
+ node: CodeWorkspaceFileNode;
169
+ ancestors?: readonly CodeWorkspaceFolder[];
170
+ range?: CodeWorkspaceRange;
171
+ preview?: string;
172
+ }
173
+ /**
174
+ * 工作区搜索结果。省略 nextCursor 表示已到末页。
175
+ *
176
+ * @example
177
+ * ```ts
178
+ * import type { CodeWorkspaceSearchPage } from '@h-ai/ui/components/scenes/code/index'
179
+ * const page: CodeWorkspaceSearchPage = { hits: [], nextCursor: 'page-2' }
180
+ * ```
181
+ */
182
+ export interface CodeWorkspaceSearchPage {
183
+ hits: readonly CodeWorkspaceSearchHit[];
184
+ nextCursor?: string;
185
+ }
186
+ /**
187
+ * 工作区的读取能力。保持对象引用稳定,切换仓库或分支时替换整个对象。
188
+ * 宿主负责授权和搜索索引,回调可返回数据或 Promise,失败时抛错或拒绝。
189
+ *
190
+ * @example
191
+ * ```ts
192
+ * import type { CodeWorkspaceSource } from '@h-ai/ui/components/scenes/code/index'
193
+ * const source: CodeWorkspaceSource = {
194
+ * listChildren: () => [{ kind: 'file', id: 'readme', name: 'README.md' }],
195
+ * readFile: () => ({ text: '# Hello' }),
196
+ * }
197
+ * ```
198
+ */
199
+ export interface CodeWorkspaceSource {
200
+ /** parent 为 null 时读取根节点。 */
201
+ listChildren: (parent: CodeWorkspaceFolder | null, signal: AbortSignal) => readonly CodeWorkspaceNode[] | Promise<readonly CodeWorkspaceNode[]>;
202
+ readFile: (node: CodeWorkspaceFileNode, signal: AbortSignal) => CodeWorkspaceFileContent | Promise<CodeWorkspaceFileContent>;
203
+ search?: (query: CodeWorkspaceSearchQuery, signal: AbortSignal) => CodeWorkspaceSearchPage | Promise<CodeWorkspaceSearchPage>;
204
+ }
205
+ /**
206
+ * 编辑区的初始显示选项,使用者可在工作区内切换。
207
+ *
208
+ * @example
209
+ * ```ts
210
+ * import type { CodeWorkspaceDisplay } from '@h-ai/ui/components/scenes/code/index'
211
+ * const display: CodeWorkspaceDisplay = { lineNumbers: 'relative', minimap: false }
212
+ * ```
213
+ */
214
+ export interface CodeWorkspaceDisplay {
215
+ lineNumbers?: boolean | 'relative';
216
+ minimap?: boolean;
217
+ breadcrumbs?: boolean;
218
+ wordWrap?: boolean;
219
+ }
220
+ /**
221
+ * 可作为自定义主题基础的预设。
222
+ *
223
+ * @example
224
+ * ```ts
225
+ * import type { CodeWorkspaceThemeBase } from '@h-ai/ui/components/scenes/code/index'
226
+ * const base: CodeWorkspaceThemeBase = 'hc-dark'
227
+ * ```
228
+ */
229
+ export type CodeWorkspaceThemeBase = 'vs-light' | 'vs-dark' | 'hc-light' | 'hc-dark';
230
+ /**
231
+ * Monaco 编辑区主题。同一页面中的 Monaco 实例共用主题。
232
+ *
233
+ * @example
234
+ * ```ts
235
+ * import type { CodeWorkspaceTheme } from '@h-ai/ui/components/scenes/code/index'
236
+ * const theme: CodeWorkspaceTheme = {
237
+ * base: 'vs-dark',
238
+ * colors: { 'editor.background': '#121820' },
239
+ * }
240
+ * ```
241
+ */
242
+ export type CodeWorkspaceTheme = 'inherit' | CodeWorkspaceThemeBase | 'github-dark' | {
243
+ base: CodeWorkspaceThemeBase;
244
+ colors?: Readonly<Record<string, string>>;
245
+ tokens?: readonly {
246
+ token: string;
247
+ foreground?: string;
248
+ background?: string;
249
+ fontStyle?: string;
250
+ }[];
251
+ };
252
+ /**
253
+ * 当前文件的主要选区。
254
+ *
255
+ * @example
256
+ * ```ts
257
+ * import type { CodeWorkspaceSelection } from '@h-ai/ui/components/scenes/code/index'
258
+ * const selection: CodeWorkspaceSelection = {
259
+ * text: 'const',
260
+ * range: { startLine: 1, startColumn: 1, endLine: 1, endColumn: 6 },
261
+ * }
262
+ * ```
263
+ */
264
+ export interface CodeWorkspaceSelection {
265
+ range: CodeWorkspaceRange;
266
+ text: string;
267
+ }
268
+ /**
269
+ * 编辑器内部传递的文件与选区快照。
270
+ *
271
+ * @example 模块内部上下文
272
+ * ```ts
273
+ * function selectedText(context: CodeWorkspaceSelectionContext) {
274
+ * return context.selection.text
275
+ * }
276
+ * ```
277
+ */
278
+ export interface CodeWorkspaceSelectionContext {
279
+ file: CodeWorkspaceFile;
280
+ selection: CodeWorkspaceSelection;
281
+ }
282
+ /**
283
+ * 右侧检查区的渲染上下文。reveal 仅对生成该上下文的文档生效。
284
+ *
285
+ * @example
286
+ * ```ts
287
+ * import type { CodeWorkspaceInspectorContext } from '@h-ai/ui/components/scenes/code/index'
288
+ * function revealFirstAnnotation(context: CodeWorkspaceInspectorContext) {
289
+ * const first = context.file.annotations?.[0]
290
+ * if (first)
291
+ * context.reveal(first.range)
292
+ * }
293
+ * ```
294
+ */
295
+ export interface CodeWorkspaceInspectorContext {
296
+ file: CodeWorkspaceFile;
297
+ selection: CodeWorkspaceSelection | null;
298
+ reveal: (range: CodeWorkspaceRange) => void;
299
+ }
300
+ /**
301
+ * 浮动操作的渲染上下文。
302
+ *
303
+ * @example
304
+ * ```ts
305
+ * import type { CodeWorkspaceActionContext } from '@h-ai/ui/components/scenes/code/index'
306
+ * function inspectSelection({ selection, openInspector }: CodeWorkspaceActionContext) {
307
+ * if (selection.text.trim())
308
+ * openInspector()
309
+ * }
310
+ * ```
311
+ */
312
+ export interface CodeWorkspaceActionContext extends CodeWorkspaceSelectionContext {
313
+ reveal: (range: CodeWorkspaceRange) => void;
314
+ openInspector: () => void;
315
+ }
316
+ /**
317
+ * CodeWorkspace 的参数。只需传入 source 即可浏览文件,按需接入搜索和自定义内容。
318
+ *
319
+ * @example
320
+ * ```ts
321
+ * import type { CodeWorkspaceProps } from '@h-ai/ui/components/scenes/code/index'
322
+ * const props: CodeWorkspaceProps = {
323
+ * source: {
324
+ * listChildren: () => [{ kind: 'file', id: 'hello', name: 'hello.ts' }],
325
+ * readFile: () => ({ text: 'export const hello = 1', language: 'typescript' }),
326
+ * },
327
+ * }
328
+ * ```
329
+ */
330
+ export interface CodeWorkspaceProps {
331
+ source: CodeWorkspaceSource;
332
+ initialFile?: CodeWorkspaceFileNode;
333
+ initialAncestors?: readonly CodeWorkspaceFolder[];
334
+ options?: CodeWorkspaceDisplay;
335
+ theme?: CodeWorkspaceTheme;
336
+ inspector?: Snippet<[CodeWorkspaceInspectorContext]>;
337
+ /** 自定义行前图标。使用装饰性内容,图标按钮的名称来自标注 label。 */
338
+ annotationIcon?: Snippet<[CodeWorkspaceAnnotationContext]>;
339
+ /** 自定义行前浮层。可以包含按钮、链接或其他可交互组件。 */
340
+ annotationHover?: Snippet<[CodeWorkspaceAnnotationContext]>;
341
+ selectionActions?: Snippet<[CodeWorkspaceActionContext]>;
342
+ /** 工作区容器高度,默认 38rem。 */
343
+ height?: string;
344
+ label?: string;
345
+ class?: string;
346
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,2 @@
1
+ export type { CodeWorkspaceActionContext, CodeWorkspaceAnnotation, CodeWorkspaceAnnotationContext, CodeWorkspaceDisplay, CodeWorkspaceFile, CodeWorkspaceFileContent, CodeWorkspaceFileNode, CodeWorkspaceFolder, CodeWorkspaceInspectorContext, CodeWorkspaceMarker, CodeWorkspaceNode, CodeWorkspaceProps, CodeWorkspaceRange, CodeWorkspaceSearchHit, CodeWorkspaceSearchPage, CodeWorkspaceSearchQuery, CodeWorkspaceSelection, CodeWorkspaceSource, CodeWorkspaceTheme, CodeWorkspaceThemeBase, } from './code-types.js';
2
+ export { default as CodeWorkspace } from './CodeWorkspace.svelte';
@@ -0,0 +1 @@
1
+ export { default as CodeWorkspace } from './CodeWorkspace.svelte';
@@ -0,0 +1 @@
1
+ import 'monaco-editor/language/css/css.worker.js';
@@ -0,0 +1 @@
1
+ import 'monaco-editor/language/css/css.worker.js';
@@ -0,0 +1 @@
1
+ import 'monaco-editor/editor/editor.worker.js';
@@ -0,0 +1 @@
1
+ import 'monaco-editor/editor/editor.worker.js';
@@ -0,0 +1 @@
1
+ import 'monaco-editor/language/html/html.worker.js';
@@ -0,0 +1 @@
1
+ import 'monaco-editor/language/html/html.worker.js';
@@ -0,0 +1 @@
1
+ import 'monaco-editor/language/json/json.worker.js';
@@ -0,0 +1 @@
1
+ import 'monaco-editor/language/json/json.worker.js';
@@ -0,0 +1 @@
1
+ import 'monaco-editor/language/typescript/ts.worker.js';
@@ -0,0 +1 @@
1
+ import 'monaco-editor/language/typescript/ts.worker.js';
@@ -71,13 +71,17 @@
71
71
 
72
72
  const dataAttributes = $derived(getDataAttributes(restProps))
73
73
  function resolveText(text: string | (() => string)): string {
74
- return typeof text === 'function' ? text() : text
74
+ return typeof text === 'function'
75
+ ? text()
76
+ : text
75
77
  }
76
78
 
77
79
  function resolveOptions(options?: FieldDef['options']): Array<{ label: string, value: string | number | boolean }> {
78
80
  if (!options)
79
81
  return []
80
- return typeof options === 'function' ? options() : options
82
+ return typeof options === 'function'
83
+ ? options()
84
+ : options
81
85
  }
82
86
 
83
87
  function formatValue(field: FieldDef, value: unknown): string {
@@ -87,13 +87,17 @@
87
87
 
88
88
  const dataAttributes = $derived(getDataAttributes(restProps))
89
89
  function resolveText(text: string | (() => string)): string {
90
- return typeof text === 'function' ? text() : text
90
+ return typeof text === 'function'
91
+ ? text()
92
+ : text
91
93
  }
92
94
 
93
95
  function resolveOptions(options?: FieldDef['options']): Array<{ label: string, value: string | number | boolean }> {
94
96
  if (!options)
95
97
  return []
96
- return typeof options === 'function' ? options() : options
98
+ return typeof options === 'function'
99
+ ? options()
100
+ : options
97
101
  }
98
102
 
99
103
  function formatValue(field: FieldDef, value: unknown): string {
@@ -103,7 +103,9 @@
103
103
  function resolveOptions(options?: CrudFieldDef['options']): Array<{ label: string, value: string | number | boolean }> {
104
104
  if (!options)
105
105
  return []
106
- return typeof options === 'function' ? options() : options
106
+ return typeof options === 'function'
107
+ ? options()
108
+ : options
107
109
  }
108
110
 
109
111
  const sortedFields = $derived(
@@ -115,8 +117,11 @@
115
117
  if ((!attempted && !touched[field.id]) || (mode === 'edit' && field.readonly))
116
118
  continue
117
119
  const issue = getCrudValidationIssue(field, formData[field.id])
118
- if (issue)
119
- errors[field.id] = field.validation?.message ? resolveText(field.validation.message) : uiM(issue.key, issue.params)
120
+ if (issue) {
121
+ errors[field.id] = field.validation?.message
122
+ ? resolveText(field.validation.message)
123
+ : uiM(issue.key, issue.params)
124
+ }
120
125
  }
121
126
  return errors
122
127
  })
@@ -204,14 +209,23 @@
204
209
  {@const isReadonly = field.readonly && mode === 'edit'}
205
210
  {@const isRequired = field.validation?.required}
206
211
  {@const fieldValue = formData[field.id]}
207
- {@const placeholder = field.placeholder ? resolveText(field.placeholder) : ''}
212
+ {@const placeholder = field.placeholder
213
+ ? resolveText(field.placeholder)
214
+ : ''}
208
215
  {@const controlId = `${panelId}-${field.id}`}
209
216
  <FormField
210
217
  for={controlId}
211
218
  label={resolveText(field.label)}
212
219
  required={isRequired}
213
220
  error={fieldErrors[field.id]}
214
- colSpan={field.colSpan ?? (['textarea', 'multi-select', 'date-range', 'custom'].includes(field.type) ? 2 : 'auto')}
221
+ colSpan={field.colSpan ?? ([
222
+ 'textarea',
223
+ 'multi-select',
224
+ 'date-range',
225
+ 'custom',
226
+ ].includes(field.type)
227
+ ? 2
228
+ : 'auto')}
215
229
  data-field={field.id}
216
230
  >
217
231
 
@@ -240,7 +254,10 @@
240
254
  disabled={submitting || isReadonly}
241
255
  options={[
242
256
  { value: '', label: placeholder || uiM('crud_filter_all') },
243
- ...opts.map(opt => ({ value: String(opt.value), label: opt.label })),
257
+ ...opts.map(opt => ({
258
+ value: String(opt.value),
259
+ label: opt.label,
260
+ })),
244
261
  ]}
245
262
  onchange={value => updateField(field.id, opts.find(opt => String(opt.value) === value)?.value ?? value)}
246
263
  />
@@ -285,11 +302,21 @@
285
302
  disabled={submitting || isReadonly}
286
303
  required={isRequired}
287
304
  pattern={field.validation?.pattern}
288
- minlength={field.type !== 'number' ? field.validation?.min : undefined}
289
- maxlength={field.type !== 'number' ? field.validation?.max : undefined}
290
- min={field.type === 'number' ? field.validation?.min : undefined}
291
- max={field.type === 'number' ? field.validation?.max : undefined}
292
- oninput={e => updateField(field.id, field.type === 'number' && e.currentTarget.value !== '' ? Number(e.currentTarget.value) : e.currentTarget.value)}
305
+ minlength={field.type !== 'number'
306
+ ? field.validation?.min
307
+ : undefined}
308
+ maxlength={field.type !== 'number'
309
+ ? field.validation?.max
310
+ : undefined}
311
+ min={field.type === 'number'
312
+ ? field.validation?.min
313
+ : undefined}
314
+ max={field.type === 'number'
315
+ ? field.validation?.max
316
+ : undefined}
317
+ oninput={e => updateField(field.id, field.type === 'number' && e.currentTarget.value !== ''
318
+ ? Number(e.currentTarget.value)
319
+ : e.currentTarget.value)}
293
320
  />
294
321
  {/if}
295
322
  </FormField>
@@ -311,7 +338,9 @@
311
338
  {#if submitting}
312
339
  <span class='loading loading-spinner loading-xs mr-2'></span>
313
340
  {/if}
314
- {mode === 'create' ? uiM('crud_create') : uiM('crud_save')}
341
+ {mode === 'create'
342
+ ? uiM('crud_create')
343
+ : uiM('crud_save')}
315
344
  </Button>
316
345
  {/snippet}
317
346
 
@@ -361,7 +361,9 @@
361
361
 
362
362
  /** 解析静态或延迟读取的显示文案。 */
363
363
  function resolveText(text: string | (() => string)): string {
364
- return typeof text === 'function' ? text() : text
364
+ return typeof text === 'function'
365
+ ? text()
366
+ : text
365
367
  }
366
368
 
367
369
  // 同步 data.filters → 本地过滤/排序状态;没有 filters 时也要清空旧状态。
@@ -369,7 +371,9 @@
369
371
  const filters = data.filters ?? {}
370
372
  searchValue = String(filters.search ?? '')
371
373
  sortBy = String(filters.sortBy ?? '')
372
- sortDirection = filters.sortDirection === 'asc' ? 'asc' : 'desc'
374
+ sortDirection = filters.sortDirection === 'asc'
375
+ ? 'asc'
376
+ : 'desc'
373
377
  const fv: Record<string, unknown> = {}
374
378
  for (const f of crud.getFilterFields()) {
375
379
  if (filters[f.id] !== undefined) {
@@ -405,9 +409,18 @@
405
409
  sortBy,
406
410
  sortDirection,
407
411
  ...Object.fromEntries(
408
- Object.entries(conditions).filter(([key]) => !['search', 'sortBy', 'sortDirection', 'page', 'pageSize'].includes(key))
412
+ Object.entries(conditions).filter(([key]) => ![
413
+ 'search',
414
+ 'sortBy',
415
+ 'sortDirection',
416
+ 'page',
417
+ 'pageSize',
418
+ ].includes(key))
409
419
  .filter(([, v]) => v !== undefined && v !== '')
410
- .map(([k, v]) => [k, String(v)]),
420
+ .map(([k, v]) => [
421
+ k,
422
+ String(v),
423
+ ]),
411
424
  ),
412
425
  ...overrides,
413
426
  }
@@ -423,7 +436,9 @@
423
436
  /** 序列化后的查询字符串。 */
424
437
  const qs = params.toString()
425
438
  /** 交给宿主路由的目标 URL。 */
426
- const url = `${currentBasePath}${qs ? `?${qs}` : ''}`
439
+ const url = `${currentBasePath}${qs
440
+ ? `?${qs}`
441
+ : ''}`
427
442
  void Promise.resolve(nav.navigate(url)).then(() => nav.refresh?.())
428
443
  }
429
444
 
@@ -469,7 +484,9 @@
469
484
  /** 打开新建面板并填充默认值。 */
470
485
  function openCreate() {
471
486
  selectedItem = null
472
- formData = { ...crud.getDefaultValues() }
487
+ formData = {
488
+ ...crud.getDefaultValues(),
489
+ }
473
490
  formError = ''
474
491
  panelMode = 'create'
475
492
  }
@@ -644,7 +661,11 @@
644
661
  : undefined,
645
662
  })),
646
663
  )
647
- useToastFeedback(() => error ? typeof error === 'string' ? error : uiM('crud_load_failed') : '')
664
+ useToastFeedback(() => error
665
+ ? typeof error === 'string'
666
+ ? error
667
+ : uiM('crud_load_failed')
668
+ : '')
648
669
  useToastFeedback(() => deleteError)
649
670
  </script>
650
671
 
@@ -845,8 +866,12 @@
845
866
  <!-- 编辑/新建:抽屉或弹窗 -->
846
867
  <CrudEditPanel
847
868
  open={editOpen}
848
- mode={panelMode === 'create' ? 'create' : 'edit'}
849
- fields={panelMode === 'create' ? createFields : editFields}
869
+ mode={panelMode === 'create'
870
+ ? 'create'
871
+ : 'edit'}
872
+ fields={panelMode === 'create'
873
+ ? createFields
874
+ : editFields}
850
875
  {density}
851
876
  bind:formData
852
877
  title={panelTitle}