@h-ai/ui 1.0.0-beta.30 → 1.0.0-beta.31

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 (48) hide show
  1. package/README.en.md +10 -1183
  2. package/README.ja.md +9 -1182
  3. package/README.md +12 -1183
  4. package/auto-import.d.ts +4 -0
  5. package/auto-import.js +4 -0
  6. package/dist/components/compounds/Popover.svelte +1 -0
  7. package/dist/components/scenes/ai/AiDocumentEditor.svelte +73 -7
  8. package/dist/components/scenes/ai/document-download.js +49 -86
  9. package/dist/components/scenes/ai/document-parse.js +6 -28
  10. package/dist/components/scenes/ai/document-pdf-pages.d.ts +26 -0
  11. package/dist/components/scenes/ai/document-pdf-pages.js +111 -0
  12. package/dist/components/scenes/ai/document-pdf-worker.d.ts +11 -0
  13. package/dist/components/scenes/ai/document-pdf-worker.js +29 -0
  14. package/dist/components/scenes/ai/document-render-pool.d.ts +19 -0
  15. package/dist/components/scenes/ai/document-render-pool.js +20 -0
  16. package/dist/components/scenes/ai/document-render-worker.d.ts +13 -0
  17. package/dist/components/scenes/ai/document-render-worker.js +7 -0
  18. package/dist/components/scenes/ai/document-types.d.ts +2 -0
  19. package/dist/components/scenes/ai/index.d.ts +3 -0
  20. package/dist/components/scenes/ai/index.js +2 -0
  21. package/dist/components/scenes/ai/mind/AiMindMapEditor.svelte +519 -0
  22. package/dist/components/scenes/ai/mind/AiMindMapEditor.svelte.d.ts +8 -0
  23. package/dist/components/scenes/ai/mind/mind-adapter.d.ts +38 -0
  24. package/dist/components/scenes/ai/mind/mind-adapter.js +59 -0
  25. package/dist/components/scenes/ai/mind/mind-types.d.ts +116 -0
  26. package/dist/components/scenes/ai/mind/mind-types.js +1 -0
  27. package/dist/components/scenes/index.d.ts +1 -0
  28. package/dist/components/scenes/index.js +2 -0
  29. package/dist/components/scenes/tools/ArtifactWorkspace.svelte +561 -0
  30. package/dist/components/scenes/tools/ArtifactWorkspace.svelte.d.ts +17 -0
  31. package/dist/components/scenes/tools/ToolWorkspace.svelte +435 -0
  32. package/dist/components/scenes/tools/ToolWorkspace.svelte.d.ts +17 -0
  33. package/dist/components/scenes/tools/artifact-data.d.ts +35 -0
  34. package/dist/components/scenes/tools/artifact-data.js +127 -0
  35. package/dist/components/scenes/tools/artifact-markdown.d.ts +58 -0
  36. package/dist/components/scenes/tools/artifact-markdown.js +308 -0
  37. package/dist/components/scenes/tools/artifact-preview.d.ts +9 -0
  38. package/dist/components/scenes/tools/artifact-preview.js +31 -0
  39. package/dist/components/scenes/tools/index.d.ts +4 -0
  40. package/dist/components/scenes/tools/index.js +3 -0
  41. package/dist/components/scenes/tools/tool-form.d.ts +74 -0
  42. package/dist/components/scenes/tools/tool-form.js +179 -0
  43. package/dist/components/scenes/tools/workspace-types.d.ts +221 -0
  44. package/dist/components/scenes/tools/workspace-types.js +1 -0
  45. package/dist/messages/en-US.json +99 -1
  46. package/dist/messages/ja-JP.json +99 -1
  47. package/dist/messages/zh-CN.json +99 -1
  48. package/package.json +8 -2
@@ -16,5 +16,8 @@ export { highlightCode, isLanguageSupported } from './highlight.js';
16
16
  export { parseMarkdown } from './markdown-parse.js';
17
17
  export type { MarkdownParseOptions } from './markdown-parse.js';
18
18
  export { default as MarkdownRenderer } from './MarkdownRenderer.svelte';
19
+ export { default as AiMindMapEditor } from './mind/AiMindMapEditor.svelte';
20
+ export { fromMindElixirData, toMindElixirData } from './mind/mind-adapter.js';
21
+ export type { AiMindMapChangePayload, AiMindMapData, AiMindMapEditorProps, AiMindMapExportFormat, AiMindMapNode, AiMindMapSelection } from './mind/mind-types.js';
19
22
  export { default as AiTableEditor } from './table/AiTableEditor.svelte';
20
23
  export type { AiTableColumn, AiTableColumnType, AiTableCopyPayload, AiTableData, AiTableDownloadPayload, AiTableEditorChangeAction, AiTableEditorChangePayload, AiTableEditorProps, AiTableRow, } from './table/table-types.js';
@@ -13,4 +13,6 @@ export { renderMarkdownDocument } from './document-parse.js';
13
13
  export { highlightCode, isLanguageSupported } from './highlight.js';
14
14
  export { parseMarkdown } from './markdown-parse.js';
15
15
  export { default as MarkdownRenderer } from './MarkdownRenderer.svelte';
16
+ export { default as AiMindMapEditor } from './mind/AiMindMapEditor.svelte';
17
+ export { fromMindElixirData, toMindElixirData } from './mind/mind-adapter.js';
16
18
  export { default as AiTableEditor } from './table/AiTableEditor.svelte';
@@ -0,0 +1,519 @@
1
+ <script lang='ts'>
2
+ import type { LangPack } from 'mind-elixir/i18n'
3
+ import type { AiMindMapData, AiMindMapEditorProps, AiMindMapNode, AiMindMapSelection } from './mind-types.js'
4
+ import { en, ja, zh_CN } from 'mind-elixir/i18n'
5
+ import { onMount } from 'svelte'
6
+ import { getUILocale, uiM } from '../../../../messages.js'
7
+ import { getDataAttributes } from '../../../../utils.js'
8
+ import AiDocumentDownloadMenu from '../AiDocumentDownloadMenu.svelte'
9
+ import { fromMindElixirData, toMindElixirData } from './mind-adapter.js'
10
+
11
+ const {
12
+ data,
13
+ artifactKey,
14
+ title = '',
15
+ editable = true,
16
+ dark = false,
17
+ saveState = '',
18
+ class: className = '',
19
+ onchange,
20
+ onerror,
21
+ onexport,
22
+ onclose,
23
+ onimportjson,
24
+ onselectionchange,
25
+ onrewrite,
26
+ ...restProps
27
+ }: AiMindMapEditorProps = $props()
28
+
29
+ const dataAttributes = $derived(getDataAttributes(restProps))
30
+
31
+ let canvas = $state<HTMLDivElement>()
32
+ let importInput = $state<HTMLInputElement>()
33
+ let engine = $state.raw<import('mind-elixir').default>()
34
+ let loadError = $state(false)
35
+ let lastArtifactKey = ''
36
+ let suppressChange = false
37
+ let lastDataSnapshot = ''
38
+ /** 最近交给宿主的持久化快照,用于合并操作事件与历史栈事件。 */
39
+ let lastEmittedSnapshot = ''
40
+ let selectedNodeIds = $state<string[]>([])
41
+ let selectedSummary = $state('')
42
+ // 菜单命令通过另一个点击事件触发,单独保存显示菜单时命中的节点 ID。
43
+ let contextNodeId = ''
44
+ /** 按 Mind Elixir 公共历史栈状态启用撤销和重做按钮。 */
45
+ let canUndo = $state(false)
46
+ let canRedo = $state(false)
47
+ /** 当前用户界面布局,同时用于后续引擎快照序列化。 */
48
+ let layoutSelection = $state<'right' | 'left' | 'both'>('right')
49
+ /** 跟随宿主主题设置更新编辑引擎的配色。 */
50
+ let themeDark = $state(false)
51
+
52
+ /** 把已提交到历史栈的引擎状态转换为项目协议后交给宿主保存。 */
53
+ function emitCurrentChange(reason: string): void {
54
+ if (!engine || !editable)
55
+ return
56
+ try {
57
+ const nextData = fromMindElixirData(engine.getData(), layoutSelection)
58
+ const nextSnapshot = JSON.stringify(nextData)
59
+ if (nextSnapshot === lastEmittedSnapshot)
60
+ return
61
+ lastEmittedSnapshot = nextSnapshot
62
+ onchange?.({ data: nextData, reason })
63
+ }
64
+ catch (error) {
65
+ onerror?.(error instanceof Error
66
+ ? error
67
+ : new Error(String(error)))
68
+ }
69
+ }
70
+
71
+ /** Mind Elixir 菜单跟随宿主当前 UI 语言,而不是引擎固定的英文默认值。 */
72
+ function resolveContextMenuLocale(): LangPack {
73
+ const locale = getUILocale().toLowerCase()
74
+ if (locale.startsWith('zh'))
75
+ return zh_CN
76
+ if (locale.startsWith('ja'))
77
+ return ja
78
+ return en
79
+ }
80
+
81
+ /** 右键菜单和工具栏共用节点 ID,引用当前选中节点的实际文字。 */
82
+ function requestRewrite(nodeIds = selectedNodeIds): void {
83
+ if (!onrewrite || nodeIds.length === 0)
84
+ return
85
+ const text = nodeIds
86
+ .map(id => engine?.getObjById(id, engine.nodeData)?.topic ?? findNode(data.root, id)?.text)
87
+ .filter((value): value is string => Boolean(value?.trim()))
88
+ .join('\n')
89
+ if (!text)
90
+ return
91
+ onrewrite({ nodeIds, scope: 'subtree', text })
92
+ }
93
+
94
+ /** 点击右键 AI 改写时关闭引擎菜单,再把引用交给宿主聊天输入框。 */
95
+ function handleContextRewrite(event: MouseEvent): void {
96
+ const nodeIds = contextNodeId
97
+ ? [contextNodeId]
98
+ : selectedNodeIds
99
+ requestRewrite(nodeIds)
100
+ if (event.currentTarget instanceof HTMLElement)
101
+ event.currentTarget.closest('.context-menu')?.setAttribute('hidden', '')
102
+ }
103
+
104
+ /** 保存右键事件的真实节点目标,扩展菜单回调本身不包含该节点参数。 */
105
+ function handleContextMenuShown(event: MouseEvent): void {
106
+ const target = event.target
107
+ const topic = target instanceof Element
108
+ ? target.closest<HTMLElement>('.me-tpc')
109
+ : null
110
+ const node = topic as (HTMLElement & { nodeObj?: { id?: string } }) | null
111
+ contextNodeId = node?.nodeObj?.id ?? ''
112
+ }
113
+
114
+ /** 统一承接下拉菜单的格式选择,所有格式使用同一刻的完整 mind/v1 快照。 */
115
+ function handleDownloadAction(actionId: string): void {
116
+ if (actionId === 'json' || actionId === 'csv' || actionId === 'xlsx' || actionId === 'xmind')
117
+ void onexport?.(actionId, currentSnapshot())
118
+ }
119
+
120
+ /** 关闭查看器前先让正在编辑的 Mind Elixir 输入框失焦并进入保存队列。 */
121
+ async function handleClose(): Promise<void> {
122
+ if (await flushPendingChange())
123
+ onclose?.()
124
+ }
125
+
126
+ // 引擎依赖 DOM 且带有全局样式,因此仅在客户端挂载后按需加载。
127
+ onMount(() => {
128
+ let disposed = false
129
+ let observer: ResizeObserver | undefined
130
+ let resizeTimer: ReturnType<typeof setTimeout> | undefined
131
+ /** 监听宿主主题类或 data-theme 的变化。 */
132
+ let themeObserver: MutationObserver | undefined
133
+ /** 解绑引擎历史栈监听器,避免组件销毁后保留闭包。 */
134
+ let unsubscribeHistory: (() => void) | undefined
135
+ void (async () => {
136
+ try {
137
+ const [{ default: MindElixir }] = await Promise.all([
138
+ import('mind-elixir'),
139
+ import('mind-elixir/style'),
140
+ ])
141
+ if (disposed)
142
+ return
143
+ if (!canvas)
144
+ return
145
+ layoutSelection = data.layout
146
+ const resolveDarkTheme = () => dark || document.documentElement.dataset.theme === 'dark' || document.documentElement.classList.contains('dark')
147
+ themeDark = resolveDarkTheme()
148
+ const instance = new MindElixir({
149
+ el: canvas,
150
+ direction: MindElixir.RIGHT,
151
+ editable,
152
+ allowUndo: true,
153
+ theme: themeDark ? MindElixir.DARK_THEME : MindElixir.THEME,
154
+ contextMenu: {
155
+ locale: resolveContextMenuLocale(),
156
+ extend: onrewrite
157
+ ? [
158
+ {
159
+ name: uiM('mind_context_ai_rewrite'),
160
+ onclick: handleContextRewrite,
161
+ },
162
+ ]
163
+ : [],
164
+ },
165
+ })
166
+ const initError = await instance.init(toMindElixirData(data))
167
+ if (initError)
168
+ throw initError
169
+ if (disposed) {
170
+ instance.destroy()
171
+ return
172
+ }
173
+ // Expose the engine only after init installs its plugins and history stack.
174
+ engine = instance
175
+ lastArtifactKey = artifactKey
176
+ lastDataSnapshot = JSON.stringify(data)
177
+ lastEmittedSnapshot = lastDataSnapshot
178
+ unsubscribeHistory = engine.historyStack?.subscribe(() => {
179
+ canUndo = Boolean(engine?.historyStack?.canUndo)
180
+ canRedo = Boolean(engine?.historyStack?.canRedo)
181
+ // Mind Elixir records text and structural edits in its history stack before
182
+ // notifying operation listeners, so this is the reliable persistence boundary.
183
+ if (!suppressChange)
184
+ emitCurrentChange('history')
185
+ })
186
+ canUndo = Boolean(engine.historyStack?.canUndo)
187
+ canRedo = Boolean(engine.historyStack?.canRedo)
188
+ engine.bus.addListener('operation', (operation) => {
189
+ if (
190
+ suppressChange
191
+ || operation.silent
192
+ || operation.name === 'beginEdit'
193
+ || operation.name === 'expandNode'
194
+ || operation.name === 'collapseNode'
195
+ ) {
196
+ return
197
+ }
198
+ emitCurrentChange(operation.name)
199
+ })
200
+ engine.bus.addListener('showContextMenu', handleContextMenuShown)
201
+ engine.bus.addListener('selectNodes', (nodes) => {
202
+ selectedNodeIds = [
203
+ ...new Set(nodes.map(node => node.id)),
204
+ ]
205
+ const selectedNodes = selectedNodeIds
206
+ .map(id => engine?.getObjById(id, engine.nodeData))
207
+ .filter((node): node is NonNullable<typeof node> => Boolean(node))
208
+ const count = selectedNodes.reduce((total, node) => total + countMindElixirNodes(node), 0)
209
+ selectedSummary = selectedNodes.length === 1
210
+ ? `${selectedNodes[0]!.topic} · ${count}`
211
+ : `${selectedNodes.length} · ${count}`
212
+ const selection: AiMindMapSelection | null = selectedNodeIds.length > 0
213
+ ? { nodeIds: selectedNodeIds, scope: 'subtree', text: selectedSummary }
214
+ : null
215
+ onselectionchange?.(selection)
216
+ })
217
+ engine.bus.addListener('unselectNodes', () => {
218
+ selectedNodeIds = []
219
+ selectedSummary = ''
220
+ onselectionchange?.(null)
221
+ })
222
+ observer = new ResizeObserver(() => {
223
+ clearTimeout(resizeTimer)
224
+ resizeTimer = setTimeout(() => engine?.scaleFit(), 100)
225
+ })
226
+ observer.observe(canvas)
227
+ themeObserver = new MutationObserver(() => {
228
+ themeDark = resolveDarkTheme()
229
+ engine?.changeTheme(themeDark ? MindElixir.DARK_THEME : MindElixir.THEME)
230
+ })
231
+ themeObserver.observe(document.documentElement, {
232
+ attributes: true,
233
+ attributeFilter: ['class', 'data-theme'],
234
+ })
235
+ }
236
+ catch (error) {
237
+ loadError = true
238
+ onerror?.(error instanceof Error
239
+ ? error
240
+ : new Error(String(error)))
241
+ }
242
+ })()
243
+
244
+ return () => {
245
+ disposed = true
246
+ observer?.disconnect()
247
+ clearTimeout(resizeTimer)
248
+ themeObserver?.disconnect()
249
+ unsubscribeHistory?.()
250
+ engine?.destroy()
251
+ engine = undefined
252
+ }
253
+ })
254
+
255
+ /**
256
+ * 等待画布初始化后将数据适配层用于更新;flush 保持与宿主协议兼容。
257
+ *
258
+ * @example
259
+ * ```ts
260
+ * import { mount, unmount } from 'svelte'
261
+ * import { AiMindMapEditor } from '@h-ai/ui'
262
+ * const editor = mount(AiMindMapEditor, { target: document.body, props: { data: { kind: 'mind/v1', layout: 'right', root: { id: 'root', text: '中心主题', children: [] } }, artifactKey: 'mind-1' } })
263
+ * await editor.flushPendingChange()
264
+ * await unmount(editor)
265
+ * ```
266
+ */
267
+ export function flushPendingChange(): Promise<boolean> {
268
+ if (canvas?.contains(document.activeElement) && document.activeElement instanceof HTMLElement)
269
+ document.activeElement.blur()
270
+ return Promise.resolve(true)
271
+ }
272
+
273
+ /** 点击导出时从引擎读取同一刻的快照,避免异步保存期间混入后续编辑。 */
274
+ function currentSnapshot(): AiMindMapData {
275
+ return engine
276
+ ? fromMindElixirData(engine.getData(), layoutSelection)
277
+ : data
278
+ }
279
+
280
+ /**
281
+ * 使用引擎自己的历史栈撤销最近一次编辑。
282
+ *
283
+ * @example
284
+ * ```ts
285
+ * import { mount, unmount } from 'svelte'
286
+ * import { AiMindMapEditor } from '@h-ai/ui'
287
+ * const editor = mount(AiMindMapEditor, { target: document.body, props: { data: { kind: 'mind/v1', layout: 'right', root: { id: 'root', text: '中心主题', children: [] } }, artifactKey: 'mind-1' } })
288
+ * editor.undo()
289
+ * await unmount(editor)
290
+ * ```
291
+ */
292
+ export function undo(): void {
293
+ if (editable)
294
+ engine?.undo()
295
+ }
296
+
297
+ /**
298
+ * 使用引擎自己的历史栈重做已撤销编辑。
299
+ *
300
+ * @example
301
+ * ```ts
302
+ * import { mount, unmount } from 'svelte'
303
+ * import { AiMindMapEditor } from '@h-ai/ui'
304
+ * const editor = mount(AiMindMapEditor, { target: document.body, props: { data: { kind: 'mind/v1', layout: 'right', root: { id: 'root', text: '中心主题', children: [] } }, artifactKey: 'mind-1' } })
305
+ * editor.redo()
306
+ * await unmount(editor)
307
+ * ```
308
+ */
309
+ export function redo(): void {
310
+ if (editable)
311
+ engine?.redo()
312
+ }
313
+
314
+ /** 更新编辑引擎方向并将可持久化布局写入宿主草稿。 */
315
+ function handleLayoutChange(event: Event): void {
316
+ const target = event.currentTarget
317
+ if (!editable || !(target instanceof HTMLSelectElement))
318
+ return
319
+ const nextLayout = target.value
320
+ if (nextLayout !== 'right' && nextLayout !== 'left' && nextLayout !== 'both')
321
+ return
322
+ layoutSelection = nextLayout
323
+ if (nextLayout === 'left')
324
+ engine?.initLeft()
325
+ else if (nextLayout === 'both')
326
+ engine?.initSide()
327
+ else
328
+ engine?.initRight()
329
+ emitCurrentChange('changeDirection')
330
+ }
331
+
332
+ /** 读取单个 JSON 文件后交由宿主的共享领域校验器作最终判定。 */
333
+ async function handleImportInput(event: Event): Promise<void> {
334
+ const input = event.currentTarget
335
+ if (!(input instanceof HTMLInputElement))
336
+ return
337
+ const file = input.files?.[0]
338
+ input.value = ''
339
+ if (!file || !onimportjson)
340
+ return
341
+ try {
342
+ await onimportjson(await file.text())
343
+ }
344
+ catch (error) {
345
+ onerror?.(error instanceof Error
346
+ ? error
347
+ : new Error(String(error)))
348
+ }
349
+ }
350
+
351
+ function findNode(root: AiMindMapNode, targetId: string): AiMindMapNode | undefined {
352
+ const stack = [root]
353
+ while (stack.length > 0) {
354
+ const node = stack.pop()!
355
+ if (node.id === targetId)
356
+ return node
357
+ stack.push(...node.children)
358
+ }
359
+ return undefined
360
+ }
361
+
362
+ function countMindElixirNodes(root: { children?: Array<{ children?: unknown[] }> }): number {
363
+ let count = 0
364
+ const stack = [root]
365
+ while (stack.length > 0) {
366
+ const node = stack.pop()!
367
+ count += 1
368
+ stack.push(...(node.children ?? []) as typeof stack)
369
+ }
370
+ return count
371
+ }
372
+
373
+ $effect(() => {
374
+ if (engine) {
375
+ editable
376
+ ? engine.enableEdit()
377
+ : engine.disableEdit()
378
+ }
379
+ })
380
+
381
+ $effect(() => {
382
+ const nextSnapshot = JSON.stringify(data)
383
+ if (!engine || !artifactKey)
384
+ return
385
+ const artifactChanged = artifactKey !== lastArtifactKey
386
+ if (nextSnapshot === lastDataSnapshot && !artifactChanged)
387
+ return
388
+ suppressChange = true
389
+ try {
390
+ if (nextSnapshot !== lastDataSnapshot) {
391
+ engine.diffRefresh(toMindElixirData(data))
392
+ const direction = data.layout === 'left'
393
+ ? 0
394
+ : data.layout === 'both'
395
+ ? 2
396
+ : 1
397
+ if (engine.direction !== direction) {
398
+ if (data.layout === 'left')
399
+ engine.initLeft()
400
+ else if (data.layout === 'both')
401
+ engine.initSide()
402
+ else
403
+ engine.initRight()
404
+ }
405
+ }
406
+ layoutSelection = data.layout
407
+ if (artifactChanged)
408
+ engine.clearHistory?.()
409
+ lastArtifactKey = artifactKey
410
+ lastDataSnapshot = nextSnapshot
411
+ lastEmittedSnapshot = nextSnapshot
412
+ }
413
+ finally {
414
+ suppressChange = false
415
+ }
416
+ })
417
+ </script>
418
+
419
+ <section {...dataAttributes} class={`mind-editor ${className}`} class:dark={themeDark} aria-label={title}>
420
+ <header class='mind-topbar'>
421
+ <div class='mind-heading'>
422
+ <h2 title={title}>{title}</h2>
423
+ </div>
424
+ {#if editable || onexport || onrewrite || onclose}
425
+ <nav class='mind-actions' aria-label={title}>
426
+ {#if editable}
427
+ <button type='button' class='mind-icon-button' title={`${uiM('markdown_undo')} (Ctrl/Cmd+Z)`} aria-label={uiM('markdown_undo')} disabled={!canUndo} onclick={undo}>
428
+ <svg viewBox='0 0 24 24' aria-hidden='true'><path d='M10.2 6.05a7.25 7.25 0 1 1-4.82 6.83.75.75 0 0 1 1.5 0 5.75 5.75 0 1 0 3.82-5.42V10a.75.75 0 1 1-1.5 0V4a.75.75 0 0 1 .75-.75h6a.75.75 0 0 1 0 1.5H10.2v1.3Z'></path></svg>
429
+ </button>
430
+ <button type='button' class='mind-icon-button' title={`${uiM('markdown_redo')} (Ctrl/Cmd+Shift+Z)`} aria-label={uiM('markdown_redo')} disabled={!canRedo} onclick={redo}>
431
+ <svg viewBox='0 0 24 24' aria-hidden='true'><path d='M13.8 6.05V4.75h-5.75a.75.75 0 0 1 0-1.5h6A.75.75 0 0 1 14.8 4v6a.75.75 0 1 1-1.5 0V7.46a5.75 5.75 0 1 0 3.82 5.42.75.75 0 0 1 1.5 0 7.25 7.25 0 1 1-4.82-6.83Z'></path></svg>
432
+ </button>
433
+ {#if onimportjson}
434
+ <button type='button' title={uiM('mind_import_json')} aria-label={uiM('mind_import_json')} onclick={() => importInput?.click()}>{uiM('mind_import_json')}</button>
435
+ <input bind:this={importInput} class='mind-import-input' type='file' accept='application/json,.json' aria-label={uiM('mind_import_json')} onchange={handleImportInput} />
436
+ {/if}
437
+ {/if}
438
+ {#if onrewrite}
439
+ <button type='button' title={selectedNodeIds.length
440
+ ? uiM('mind_rewrite_selection')
441
+ : uiM('mind_rewrite_selection_disabled')} aria-label={uiM('mind_rewrite_selection')} disabled={selectedNodeIds.length === 0 || !editable} onclick={() => requestRewrite()}>{uiM('mind_rewrite_selection')}</button>
442
+ {/if}
443
+ {#if editable}
444
+ <select aria-label={uiM('mind_layout')} title={uiM('mind_layout')} value={layoutSelection} disabled={!engine} onchange={handleLayoutChange}>
445
+ <option value='right'>{uiM('mind_layout_right')}</option>
446
+ <option value='left'>{uiM('mind_layout_left')}</option>
447
+ <option value='both'>{uiM('mind_layout_both')}</option>
448
+ </select>
449
+ {/if}
450
+ <button type='button' title={uiM('mind_fit')} aria-label={uiM('mind_fit')} disabled={!engine} onclick={() => engine?.scaleFit()}>{uiM('mind_fit')}</button>
451
+ {#if saveState}
452
+ <output class='mind-save-state' aria-live='polite'>{saveState}</output>
453
+ {/if}
454
+ {#if onexport}
455
+ <AiDocumentDownloadMenu
456
+ actions={[
457
+ {
458
+ id: 'json',
459
+ label: uiM('mind_export_json'),
460
+ },
461
+ {
462
+ id: 'csv',
463
+ label: uiM('mind_export_csv'),
464
+ },
465
+ {
466
+ id: 'xlsx',
467
+ label: uiM('mind_export_xlsx'),
468
+ },
469
+ {
470
+ id: 'xmind',
471
+ label: uiM('mind_export_xmind'),
472
+ },
473
+ ]}
474
+ ondownload={handleDownloadAction}
475
+ triggerTitle={uiM('mind_download_title')}
476
+ triggerClass='mind-toolbar-button mind-download-trigger'
477
+ menuClass='mind-download-menu'
478
+ />
479
+ {/if}
480
+ {#if onclose}
481
+ <button type='button' class='mind-toolbar-button mind-close-button' title={uiM('markdown_close')} aria-label={uiM('markdown_close')} onclick={() => void handleClose()}>
482
+ <svg viewBox='0 0 24 24' aria-hidden='true'><path d='M6.97 5.91a.75.75 0 0 1 1.06 0L12 9.88l3.97-3.97a.75.75 0 1 1 1.06 1.06L13.06 10.94l3.97 3.97a.75.75 0 0 1-1.06 1.06L12 12l-3.97 3.97a.75.75 0 1 1-1.06-1.06l3.97-3.97-3.97-3.97a.75.75 0 0 1 0-1.06Z'></path></svg>
483
+ </button>
484
+ {/if}
485
+ </nav>
486
+ {/if}
487
+ </header>
488
+ {#if loadError}
489
+ <div class='mind-error' role='alert'>{uiM('mind_load_error')}</div>
490
+ {:else}
491
+ <div bind:this={canvas} class='mind-canvas' aria-label={title || uiM('mind_default_title')}></div>
492
+ {/if}
493
+ </section>
494
+
495
+ <style>
496
+ .mind-editor { display: flex; flex-direction: column; width: 100%; height: 100%; min-height: 20rem; overflow: hidden; }
497
+ .mind-topbar { display: flex; min-height: 3.5rem; align-items: center; justify-content: space-between; gap: .75rem; border-bottom: 1px solid var(--color-base-300, #d1d5db); padding: .5rem .75rem; }
498
+ .mind-heading { min-width: 0; flex: 1; }
499
+ .mind-heading h2 { overflow: hidden; margin: 0; color: var(--color-base-content, #111827); font-size: .95rem; font-weight: 600; text-overflow: ellipsis; white-space: nowrap; }
500
+ .mind-canvas { width: 100%; min-height: 0; flex: 1; }
501
+ .mind-actions { display: flex; min-width: 0; flex-wrap: wrap; align-items: center; justify-content: flex-end; gap: .25rem; }
502
+ .mind-actions :global(.mind-toolbar-button), .mind-actions button, .mind-actions select { border: 1px solid var(--color-base-300, #d1d5db); border-radius: 4px; padding: .25rem .5rem; background: var(--color-base-100, #fff); color: var(--color-base-content, #111827); font-size: .75rem; }
503
+ .mind-actions button, .mind-actions select { cursor: pointer; }
504
+ .mind-actions button:disabled, .mind-actions select:disabled { cursor: not-allowed; opacity: .45; }
505
+ .mind-actions :global(.mind-toolbar-button) { display: grid; width: 2rem; height: 2rem; place-items: center; padding: .35rem; cursor: pointer; }
506
+ .mind-actions :global(.mind-download-trigger) { width: 2.5rem; height: 2.5rem; min-height: 2.5rem; border-radius: 1rem; padding: 0; }
507
+ .mind-actions :global(.mind-toolbar-button svg) { width: 1.1rem; height: 1.1rem; fill: currentColor; }
508
+ .mind-actions :global(.mind-download-menu) { top: calc(100% + .8rem); right: 0; }
509
+ .mind-close-button { color: var(--color-base-content, #111827); }
510
+ .mind-save-state { align-self: center; padding-inline: .25rem; color: var(--color-base-content, #111827); font-size: .75rem; }
511
+ .mind-icon-button svg { width: 1.25rem; height: 1.25rem; fill: currentColor; }
512
+ .mind-import-input { display: none; }
513
+ .mind-error { padding: 1rem; color: var(--color-error, #b42318); }
514
+ .dark { color-scheme: dark; }
515
+ @media (max-width: 48rem) {
516
+ .mind-topbar { align-items: flex-start; flex-direction: column; }
517
+ .mind-actions { width: 100%; justify-content: flex-start; }
518
+ }
519
+ </style>
@@ -0,0 +1,8 @@
1
+ import type { AiMindMapEditorProps } from './mind-types.js';
2
+ declare const AiMindMapEditor: import("svelte").Component<AiMindMapEditorProps, {
3
+ flushPendingChange: () => Promise<boolean>;
4
+ undo: () => void;
5
+ redo: () => void;
6
+ }, "">;
7
+ type AiMindMapEditor = ReturnType<typeof AiMindMapEditor>;
8
+ export default AiMindMapEditor;
@@ -0,0 +1,38 @@
1
+ import type { AiMindMapData } from './mind-types.js';
2
+ /**
3
+ * 画布引擎接受的最小节点形状,只保留 id、主题和子树。
4
+ *
5
+ * @example 模块内部上下文
6
+ * ```ts
7
+ * const example: EngineNode = { id: 'root', topic: '中心主题', children: [] }
8
+ * ```
9
+ */
10
+ interface EngineNode {
11
+ id: string;
12
+ topic: string;
13
+ children?: EngineNode[];
14
+ }
15
+ /**
16
+ * 把项目协议转换为引擎最小输入,避免把协议外字段送入画布。
17
+ *
18
+ * @example
19
+ * ```ts
20
+ * import { toMindElixirData } from '@h-ai/ui'
21
+ * const map = toMindElixirData({ kind: 'mind/v1', layout: 'right', root: { id: 'root', text: '中心主题', children: [] } })
22
+ * ```
23
+ */
24
+ export declare function toMindElixirData(data: AiMindMapData): {
25
+ nodeData: EngineNode;
26
+ direction: 0 | 1 | 2;
27
+ };
28
+ /**
29
+ * 从引擎快照提取项目支持的节点字段,折叠等视图状态不会进入持久化数据。
30
+ *
31
+ * @example
32
+ * ```ts
33
+ * import { fromMindElixirData } from '@h-ai/ui'
34
+ * const data = fromMindElixirData({ nodeData: { id: 'root', topic: '中心主题' } }, 'right')
35
+ * ```
36
+ */
37
+ export declare function fromMindElixirData(value: unknown, layout: AiMindMapData['layout']): AiMindMapData;
38
+ export {};
@@ -0,0 +1,59 @@
1
+ /**
2
+ * 把项目协议转换为引擎最小输入,避免把协议外字段送入画布。
3
+ *
4
+ * @example
5
+ * ```ts
6
+ * import { toMindElixirData } from '@h-ai/ui'
7
+ * const map = toMindElixirData({ kind: 'mind/v1', layout: 'right', root: { id: 'root', text: '中心主题', children: [] } })
8
+ * ```
9
+ */
10
+ export function toMindElixirData(data) {
11
+ return {
12
+ nodeData: toEngineNode(data.root),
13
+ direction: data.layout === 'left'
14
+ ? 0
15
+ : data.layout === 'both'
16
+ ? 2
17
+ : 1,
18
+ };
19
+ }
20
+ /**
21
+ * 从引擎快照提取项目支持的节点字段,折叠等视图状态不会进入持久化数据。
22
+ *
23
+ * @example
24
+ * ```ts
25
+ * import { fromMindElixirData } from '@h-ai/ui'
26
+ * const data = fromMindElixirData({ nodeData: { id: 'root', topic: '中心主题' } }, 'right')
27
+ * ```
28
+ */
29
+ export function fromMindElixirData(value, layout) {
30
+ if (!isRecord(value) || !isRecord(value.nodeData))
31
+ throw new TypeError('Mind Elixir returned an invalid map');
32
+ return {
33
+ kind: 'mind/v1',
34
+ layout,
35
+ root: fromEngineNode(value.nodeData),
36
+ };
37
+ }
38
+ function toEngineNode(node) {
39
+ return {
40
+ id: node.id,
41
+ topic: node.text,
42
+ children: node.children.map(toEngineNode),
43
+ };
44
+ }
45
+ function fromEngineNode(value) {
46
+ if (typeof value.id !== 'string' || typeof value.topic !== 'string')
47
+ throw new TypeError('Mind Elixir returned a node without an id or topic');
48
+ const children = value.children ?? [];
49
+ if (!Array.isArray(children) || children.some(child => !isRecord(child)))
50
+ throw new TypeError('Mind Elixir returned invalid child nodes');
51
+ return {
52
+ id: value.id,
53
+ text: value.topic,
54
+ children: children.map(child => fromEngineNode(child)),
55
+ };
56
+ }
57
+ function isRecord(value) {
58
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
59
+ }