@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
package/auto-import.d.ts CHANGED
@@ -129,8 +129,12 @@ declare global {
129
129
  // scenes - ai
130
130
  const AiDocumentDownloadMenu: typeof import('@h-ai/ui')['AiDocumentDownloadMenu']
131
131
  const AiDocumentEditor: typeof import('@h-ai/ui')['AiDocumentEditor']
132
+ const AiMindMapEditor: typeof import('@h-ai/ui')['AiMindMapEditor']
132
133
  const AiTableEditor: typeof import('@h-ai/ui')['AiTableEditor']
133
134
  const MarkdownRenderer: typeof import('@h-ai/ui')['MarkdownRenderer']
135
+ // scenes - tools
136
+ const ArtifactWorkspace: typeof import('@h-ai/ui')['ArtifactWorkspace']
137
+ const ToolWorkspace: typeof import('@h-ai/ui')['ToolWorkspace']
134
138
 
135
139
  // scenes - crud
136
140
  const CrudDeleteConfirm: typeof import('@h-ai/ui')['CrudDeleteConfirm']
package/auto-import.js CHANGED
@@ -113,8 +113,12 @@ const UI_COMPONENTS = new Set([
113
113
  // scenes - ai
114
114
  'AiDocumentDownloadMenu',
115
115
  'AiDocumentEditor',
116
+ 'AiMindMapEditor',
116
117
  'AiTableEditor',
117
118
  'MarkdownRenderer',
119
+ // scenes - tools
120
+ 'ArtifactWorkspace',
121
+ 'ToolWorkspace',
118
122
  // scenes - crud
119
123
  'CrudDeleteConfirm',
120
124
  'CrudDetailPanel',
@@ -216,6 +216,7 @@
216
216
  $effect(() => {
217
217
  if (open && portal && triggerElement && popoverElement)
218
218
  return registerDialogPortal(triggerElement, popoverElement)
219
+ return undefined
219
220
  })
220
221
 
221
222
  $effect(() => {
@@ -23,6 +23,8 @@
23
23
  -->
24
24
  <script lang='ts'>
25
25
  import type { DataAttributes } from '../../../types.js'
26
+ import type { MarkdownRenderResult } from './document-parse.js'
27
+ import type { DocumentRenderJob } from './document-render-worker.js'
26
28
  import type {
27
29
  AiDocumentEditorProps,
28
30
  MarkdownBlockStyleKind,
@@ -35,10 +37,10 @@
35
37
  MarkdownSelectionSnapshot,
36
38
  MarkdownTextAlignKind,
37
39
  } from './document-types.js'
38
- import { tick } from 'svelte'
40
+ import { onMount, tick } from 'svelte'
39
41
  import { SvelteMap } from 'svelte/reactivity'
40
42
  import { writeTextToClipboard } from '../../../internal/browser-safety.js'
41
- import { uiM } from '../../../messages.js'
43
+ import { getUILocale, uiM } from '../../../messages.js'
42
44
  import { cn, getDataAttributes } from '../../../utils.js'
43
45
  import AiDocumentDownloadMenu from './AiDocumentDownloadMenu.svelte'
44
46
  import {
@@ -47,6 +49,7 @@
47
49
  } from './code-preview.js'
48
50
  import { resolveDocumentMarkdownContent } from './document-download.js'
49
51
  import { renderMarkdownDocument } from './document-parse.js'
52
+ import { documentRenderPool, useDocumentRenderWorker } from './document-render-pool.js'
50
53
  import { parseMarkdown } from './markdown-parse.js'
51
54
  import {
52
55
  createMermaidSourceSignature,
@@ -506,8 +509,10 @@
506
509
  )
507
510
  // hint 文案统一做 trim,避免只传空格时仍把占位区域撑开。
508
511
  const normalizedCodePreviewHint = $derived(codePreviewHint.trim())
509
- const renderResult = $derived(
510
- renderMarkdownDocument(documentContent, {
512
+ const renderJob = $derived({
513
+ content: documentContent,
514
+ locale: getUILocale(),
515
+ options: {
511
516
  enableHighlight,
512
517
  showCopyButton,
513
518
  showRunButton,
@@ -517,8 +522,64 @@
517
522
  codePreviewHint: normalizedCodePreviewHint,
518
523
  breaks,
519
524
  allowHtmlTags,
520
- }),
521
- )
525
+ },
526
+ } satisfies DocumentRenderJob)
527
+ let useBackgroundRender = $state(false)
528
+ let lastRender = $state.raw<{ job: DocumentRenderJob, result: MarkdownRenderResult }>()
529
+ const renderInWorker = $derived(useBackgroundRender && useDocumentRenderWorker(renderJob.content))
530
+ const renderResult = $derived(renderInWorker
531
+ ? lastRender?.result ?? { outline: [], codeBlocks: [], blocks: [] }
532
+ : renderMarkdownDocument(renderJob.content, renderJob.options))
533
+ const renderPending = $derived(renderInWorker && lastRender?.job !== renderJob)
534
+ let pendingRender: DocumentRenderJob | undefined
535
+ let renderFrame: number | undefined
536
+ let runningRender = false
537
+ let unmounted = false
538
+
539
+ onMount(() => {
540
+ if (useDocumentRenderWorker(renderJob.content))
541
+ lastRender = { job: renderJob, result: renderResult }
542
+ useBackgroundRender = true
543
+ return () => {
544
+ unmounted = true
545
+ if (renderFrame !== undefined)
546
+ cancelAnimationFrame(renderFrame)
547
+ }
548
+ })
549
+
550
+ function scheduleBackgroundRender(): void {
551
+ if (unmounted || runningRender || !pendingRender || renderFrame !== undefined)
552
+ return
553
+ renderFrame = requestAnimationFrame(() => {
554
+ renderFrame = undefined
555
+ const job = pendingRender
556
+ pendingRender = undefined
557
+ if (!job)
558
+ return
559
+ runningRender = true
560
+ void documentRenderPool.run(job).then((result) => {
561
+ if (unmounted || !renderInWorker)
562
+ return
563
+ if (result.success)
564
+ lastRender = { job, result: result.data }
565
+ else
566
+ useBackgroundRender = false
567
+ }).finally(() => {
568
+ runningRender = false
569
+ scheduleBackgroundRender()
570
+ })
571
+ })
572
+ }
573
+
574
+ $effect(() => {
575
+ if (renderInWorker && renderPending) {
576
+ pendingRender = renderJob
577
+ scheduleBackgroundRender()
578
+ }
579
+ else {
580
+ pendingRender = undefined
581
+ }
582
+ })
522
583
  // Mermaid 占位 HTML 在流式阶段可能不变,必须额外订阅源码签名变化。
523
584
  const mermaidRenderSignature = $derived(
524
585
  renderResult.blocks
@@ -2456,6 +2517,9 @@
2456
2517
  await onrewrite({
2457
2518
  actionId,
2458
2519
  selectedText,
2520
+ selectionSnapshot: savedSelectionSnapshot
2521
+ ? { ...savedSelectionSnapshot }
2522
+ : undefined,
2459
2523
  content,
2460
2524
  title: title || undefined,
2461
2525
  })
@@ -3390,7 +3454,9 @@
3390
3454
  bind:this={previewHost}
3391
3455
  class={readerDocumentClass}
3392
3456
  style={documentStyle}
3393
- contenteditable={editable}
3457
+ contenteditable={editable && !renderPending}
3458
+ aria-busy={renderPending}
3459
+ inert={renderPending}
3394
3460
  role='document'
3395
3461
  onmousemove={handlePreviewMouseMove}
3396
3462
  onmouseleave={handlePreviewMouseLeave}
@@ -1,18 +1,10 @@
1
+ import { core } from '@h-ai/core';
1
2
  import { getUILocale, uiM } from '../../../messages.js';
2
3
  import { renderMarkdownDocument } from './document-parse.js';
4
+ import { BROWSER_PDF_CONTENT_WIDTH_MM, BROWSER_PDF_MARGIN_MM, sliceCanvasPages } from './document-pdf-pages.js';
5
+ import { documentRenderPool, useDocumentRenderWorker } from './document-render-pool.js';
3
6
  const DOCUMENT_EXPORT_ROOT_CLASS = 'hai-ai-document-export';
4
- const BROWSER_PDF_PAGE_HEIGHT_MM = 297;
5
7
  const BROWSER_PDF_VIEWPORT_WIDTH_PX = 794;
6
- const BROWSER_PDF_MARGIN_MM = [14, 12, 14, 12];
7
- const BROWSER_PDF_CONTENT_WIDTH_MM = 210 - BROWSER_PDF_MARGIN_MM[1] - BROWSER_PDF_MARGIN_MM[3];
8
- const BROWSER_PDF_CONTENT_HEIGHT_MM = BROWSER_PDF_PAGE_HEIGHT_MM - BROWSER_PDF_MARGIN_MM[0] - BROWSER_PDF_MARGIN_MM[2];
9
- const BROWSER_PDF_PAGE_BREAK_SEARCH_RATIO = 0.12;
10
- const BROWSER_PDF_PAGE_BREAK_SEARCH_MAX_PX = 160;
11
- const BROWSER_PDF_PAGE_BREAK_SEARCH_MIN_PX = 24;
12
- const BROWSER_PDF_PAGE_BREAK_SAMPLE_STEP_PX = 4;
13
- const BROWSER_PDF_PAGE_BREAK_WHITE_THRESHOLD = 246;
14
- const BROWSER_PDF_PAGE_BREAK_ALPHA_THRESHOLD = 12;
15
- const BROWSER_PDF_PAGE_BREAK_EMPTY_ROW_MAX_INK = 1;
16
8
  function escapeExportHtml(value) {
17
9
  return value
18
10
  .replace(/&/g, '&amp;')
@@ -115,12 +107,22 @@ export async function downloadAiDocument(request) {
115
107
  return;
116
108
  }
117
109
  const exportTitle = request.title?.trim() || baseName;
118
- const rendered = renderMarkdownDocument(markdownContent, {
110
+ const options = {
119
111
  enableHighlight: false,
120
112
  showCopyButton: false,
121
113
  showRunButton: false,
122
114
  breaks: true,
123
- });
115
+ };
116
+ const computed = useDocumentRenderWorker(markdownContent)
117
+ ? await documentRenderPool.run({
118
+ content: markdownContent,
119
+ options,
120
+ locale: getUILocale(),
121
+ })
122
+ : undefined;
123
+ const rendered = computed?.success
124
+ ? computed.data
125
+ : renderMarkdownDocument(markdownContent, options);
124
126
  const renderedHtml = renderDocumentBlocksForExport(rendered.blocks);
125
127
  const exportHtml = buildDocumentExportHtml(exportTitle, renderedHtml);
126
128
  if (builtIn.id === 'word') {
@@ -407,88 +409,49 @@ async function waitForBrowserPdfRenderReady(frameElement, frameDocument, frameWi
407
409
  syncBrowserPdfRenderHostSize(frameElement, renderRoot);
408
410
  await waitForNextPaint(frameWindow);
409
411
  }
410
- function createPagedPdfFromCanvas(JsPdfConstructor, canvas) {
412
+ const pdfPool = core.worker.createPool(() => new Worker(new URL('./document-pdf-worker.js', import.meta.url), { type: 'module' }), { maxWorkers: 1, maxQueuedJobs: 2, idleTimeoutMs: 15_000 });
413
+ async function encodePdfPages(canvas) {
414
+ if (typeof Worker === 'undefined' || typeof OffscreenCanvas === 'undefined' || typeof createImageBitmap === 'undefined'
415
+ || canvas.height < canvas.width * 1.5) {
416
+ return undefined;
417
+ }
418
+ let bitmap;
419
+ try {
420
+ bitmap = await createImageBitmap(canvas);
421
+ const result = await pdfPool.run(bitmap, [bitmap]);
422
+ return result.success ? result.data : undefined;
423
+ }
424
+ catch {
425
+ return undefined;
426
+ }
427
+ finally {
428
+ bitmap?.close();
429
+ }
430
+ }
431
+ async function createPagedPdfFromCanvas(JsPdfConstructor, canvas) {
411
432
  const pdfDocument = new JsPdfConstructor({
412
433
  unit: 'mm',
413
434
  format: 'a4',
414
435
  orientation: 'portrait',
415
436
  compress: true,
416
437
  });
417
- const pageCanvas = document.createElement('canvas');
418
- const pageContext = pageCanvas.getContext('2d');
419
- if (!pageContext) {
420
- throw new Error('Failed to prepare PDF page canvas');
421
- }
422
- const pixelsPerMillimeter = canvas.width / BROWSER_PDF_CONTENT_WIDTH_MM;
423
- const pageHeightPx = Math.max(1, Math.floor(BROWSER_PDF_CONTENT_HEIGHT_MM * pixelsPerMillimeter));
424
- const sourceContext = canvas.getContext('2d', { willReadFrequently: true });
425
- for (let pageIndex = 0, sourceY = 0; sourceY < canvas.height; pageIndex += 1) {
426
- const remainingHeightPx = canvas.height - sourceY;
427
- const sliceHeightPx = remainingHeightPx > pageHeightPx && sourceContext
428
- ? resolveCanvasPageSliceHeight(sourceContext, canvas, sourceY, pageHeightPx)
429
- : Math.min(pageHeightPx, remainingHeightPx);
430
- pageCanvas.width = canvas.width;
431
- pageCanvas.height = sliceHeightPx;
432
- pageContext.fillStyle = '#ffffff';
433
- pageContext.fillRect(0, 0, pageCanvas.width, pageCanvas.height);
434
- pageContext.drawImage(canvas, 0, sourceY, canvas.width, sliceHeightPx, 0, 0, canvas.width, sliceHeightPx);
435
- if (pageIndex > 0) {
438
+ let pageIndex = 0;
439
+ function addPage(image, height) {
440
+ if (pageIndex++ > 0)
436
441
  pdfDocument.addPage();
437
- }
438
- pdfDocument.addImage(pageCanvas.toDataURL('image/png'), 'PNG', BROWSER_PDF_MARGIN_MM[3], BROWSER_PDF_MARGIN_MM[0], BROWSER_PDF_CONTENT_WIDTH_MM, sliceHeightPx / pixelsPerMillimeter, undefined, 'FAST');
439
- sourceY += sliceHeightPx;
442
+ pdfDocument.addImage(image, 'PNG', BROWSER_PDF_MARGIN_MM[3], BROWSER_PDF_MARGIN_MM[0], BROWSER_PDF_CONTENT_WIDTH_MM, height, undefined, 'FAST');
440
443
  }
441
- return pdfDocument.output('blob');
442
- }
443
- function resolveCanvasPageSliceHeight(sourceContext, canvas, sourceY, pageHeightPx) {
444
- const searchRadiusPx = Math.max(BROWSER_PDF_PAGE_BREAK_SEARCH_MIN_PX, Math.min(BROWSER_PDF_PAGE_BREAK_SEARCH_MAX_PX, Math.floor(pageHeightPx * BROWSER_PDF_PAGE_BREAK_SEARCH_RATIO)));
445
- const scanStartY = Math.max(sourceY + 1, sourceY + pageHeightPx - searchRadiusPx);
446
- const scanEndY = Math.min(sourceY + pageHeightPx, canvas.height);
447
- const scanHeight = scanEndY - scanStartY;
448
- if (scanHeight <= 0) {
449
- return Math.min(pageHeightPx, canvas.height - sourceY);
450
- }
451
- const imageData = sourceContext.getImageData(0, scanStartY, canvas.width, scanHeight);
452
- const bestBreakY = findCanvasPageBreakY(imageData, scanStartY);
453
- return Math.max(1, Math.min(bestBreakY - sourceY, canvas.height - sourceY));
454
- }
455
- function findCanvasPageBreakY(imageData, scanStartY) {
456
- const rowWidth = imageData.width;
457
- const rowHeight = imageData.height;
458
- const rowStride = rowWidth * 4;
459
- let bestEmptyRowY = 0;
460
- let bestInkRowY = 0;
461
- let lowestInkScore = Number.POSITIVE_INFINITY;
462
- for (let rowIndex = 0; rowIndex < rowHeight; rowIndex += 1) {
463
- const rowInkScore = measureCanvasRowInk(imageData.data, rowIndex * rowStride, rowWidth);
464
- if (rowInkScore <= BROWSER_PDF_PAGE_BREAK_EMPTY_ROW_MAX_INK) {
465
- bestEmptyRowY = scanStartY + rowIndex + 1;
466
- }
467
- if (rowInkScore <= lowestInkScore) {
468
- lowestInkScore = rowInkScore;
469
- bestInkRowY = scanStartY + rowIndex + 1;
470
- }
444
+ const encoded = await encodePdfPages(canvas);
445
+ if (encoded) {
446
+ for (const page of encoded)
447
+ addPage(page.bytes, page.height);
471
448
  }
472
- return bestEmptyRowY || bestInkRowY || (scanStartY + rowHeight);
473
- }
474
- function measureCanvasRowInk(pixels, rowOffset, rowWidth) {
475
- let inkScore = 0;
476
- for (let column = 0; column < rowWidth; column += BROWSER_PDF_PAGE_BREAK_SAMPLE_STEP_PX) {
477
- const pixelOffset = rowOffset + (column * 4);
478
- const alpha = pixels[pixelOffset + 3];
479
- if (alpha < BROWSER_PDF_PAGE_BREAK_ALPHA_THRESHOLD) {
480
- continue;
481
- }
482
- const red = pixels[pixelOffset];
483
- const green = pixels[pixelOffset + 1];
484
- const blue = pixels[pixelOffset + 2];
485
- if (red < BROWSER_PDF_PAGE_BREAK_WHITE_THRESHOLD
486
- || green < BROWSER_PDF_PAGE_BREAK_WHITE_THRESHOLD
487
- || blue < BROWSER_PDF_PAGE_BREAK_WHITE_THRESHOLD) {
488
- inkScore += 1;
489
- }
449
+ else {
450
+ const page = document.createElement('canvas');
451
+ for (const height of sliceCanvasPages(canvas, page))
452
+ addPage(page.toDataURL('image/png'), height);
490
453
  }
491
- return inkScore;
454
+ return pdfDocument.output('blob');
492
455
  }
493
456
  async function renderBrowserPdfCanvas(renderHost) {
494
457
  syncBrowserPdfRenderHostSize(renderHost.frameElement, renderHost.renderRoot);
@@ -517,7 +480,7 @@ async function downloadDocumentAsPdf(filename, bodyHtml) {
517
480
  loadJsPdf(),
518
481
  renderBrowserPdfCanvas(renderHost),
519
482
  ]);
520
- downloadBlob(createPagedPdfFromCanvas(jsPDF, canvas), filename);
483
+ downloadBlob(await createPagedPdfFromCanvas(jsPDF, canvas), filename);
521
484
  }
522
485
  finally {
523
486
  renderHost.cleanup();
@@ -308,16 +308,6 @@ function createHtmlBlock(id, html) {
308
308
  }
309
309
  : null;
310
310
  }
311
- function renderMarkdownDocumentHtmlChunk(content, options, state) {
312
- const marked = createMarkedInstance(options, state);
313
- const result = marked.parse(content);
314
- return {
315
- html: typeof result === 'string'
316
- ? result
317
- : '',
318
- codeBlocks: state.codeBlocks,
319
- };
320
- }
321
311
  function isClosedMermaidToken(token, options) {
322
312
  if (token.type !== 'code'
323
313
  || !('text' in token)
@@ -330,28 +320,18 @@ function isClosedMermaidToken(token, options) {
330
320
  && !options.showCodePreviewToggle
331
321
  && isClosedFencedCodeBlock(codeToken);
332
322
  }
333
- function renderMarkdownDocumentBlocks(content, options) {
334
- const marked = new Marked({
335
- extensions: createEditorMarkdownExtensions(),
336
- gfm: true,
337
- breaks: options.breaks,
338
- });
323
+ function renderMarkdownDocumentBlocks(content, options, state) {
324
+ const marked = createMarkedInstance(options, state);
339
325
  const tokens = marked.lexer(content);
340
326
  const blocks = [];
341
327
  let htmlTokens = [];
342
- const state = {
343
- outline: [],
344
- codeBlocks: [],
345
- headingIds: new Map(),
346
- };
347
328
  let nextBlockIndex = 1;
348
329
  function flushHtmlTokens() {
349
330
  if (htmlTokens.length === 0) {
350
331
  return;
351
332
  }
352
- const chunk = htmlTokens.map(token => token.raw).join('');
353
- const result = renderMarkdownDocumentHtmlChunk(chunk, options, state);
354
- const block = createHtmlBlock(`hai-md-block-${nextBlockIndex}`, result.html);
333
+ const html = marked.parser(htmlTokens);
334
+ const block = createHtmlBlock(`hai-md-block-${nextBlockIndex}`, html);
355
335
  if (block) {
356
336
  blocks.push(block);
357
337
  nextBlockIndex += 1;
@@ -412,12 +392,10 @@ export function renderMarkdownDocument(content, options) {
412
392
  codeBlocks: [],
413
393
  headingIds: new Map(),
414
394
  };
415
- // marked instance is scoped to this render call.
416
- const marked = createMarkedInstance(mergedOptions, state);
417
- marked.parse(content);
395
+ const blocks = renderMarkdownDocumentBlocks(content, mergedOptions, state);
418
396
  return {
419
397
  outline: createNumberedOutline(state.outline),
420
398
  codeBlocks: state.codeBlocks,
421
- blocks: renderMarkdownDocumentBlocks(content, mergedOptions),
399
+ blocks,
422
400
  };
423
401
  }
@@ -0,0 +1,26 @@
1
+ /**
2
+ * PDF 页边距按上、右、下、左排列,单位为毫米。
3
+ * @example 模块内部上下文
4
+ * ```ts
5
+ * const topMargin = BROWSER_PDF_MARGIN_MM[0]
6
+ * ```
7
+ */
8
+ export declare const BROWSER_PDF_MARGIN_MM: readonly [14, 12, 14, 12];
9
+ /**
10
+ * PDF 正文宽度,单位为毫米。
11
+ * @example 模块内部上下文
12
+ * ```ts
13
+ * const pdfWidth = BROWSER_PDF_CONTENT_WIDTH_MM
14
+ * ```
15
+ */
16
+ export declare const BROWSER_PDF_CONTENT_WIDTH_MM: number;
17
+ /**
18
+ * 按每页可用高度及接近页底的空白行选择断点。页面画布由调用者按顺序复用。
19
+ * @example 模块内部上下文
20
+ * ```ts
21
+ * const source = new OffscreenCanvas(794, 1123)
22
+ * const page = new OffscreenCanvas(1, 1)
23
+ * const pages = sliceCanvasPages(source, page)
24
+ * ```
25
+ */
26
+ export declare function sliceCanvasPages(canvas: HTMLCanvasElement | OffscreenCanvas, pageCanvas: HTMLCanvasElement | OffscreenCanvas): Generator<number>;
@@ -0,0 +1,111 @@
1
+ const BROWSER_PDF_PAGE_HEIGHT_MM = 297;
2
+ /**
3
+ * PDF 页边距按上、右、下、左排列,单位为毫米。
4
+ * @example 模块内部上下文
5
+ * ```ts
6
+ * const topMargin = BROWSER_PDF_MARGIN_MM[0]
7
+ * ```
8
+ */
9
+ export const BROWSER_PDF_MARGIN_MM = [14, 12, 14, 12];
10
+ /**
11
+ * PDF 正文宽度,单位为毫米。
12
+ * @example 模块内部上下文
13
+ * ```ts
14
+ * const pdfWidth = BROWSER_PDF_CONTENT_WIDTH_MM
15
+ * ```
16
+ */
17
+ export const BROWSER_PDF_CONTENT_WIDTH_MM = 210 - BROWSER_PDF_MARGIN_MM[1] - BROWSER_PDF_MARGIN_MM[3];
18
+ const BROWSER_PDF_CONTENT_HEIGHT_MM = BROWSER_PDF_PAGE_HEIGHT_MM - BROWSER_PDF_MARGIN_MM[0] - BROWSER_PDF_MARGIN_MM[2];
19
+ const BROWSER_PDF_PAGE_BREAK_SEARCH_RATIO = 0.12;
20
+ const BROWSER_PDF_PAGE_BREAK_SEARCH_MAX_PX = 160;
21
+ const BROWSER_PDF_PAGE_BREAK_SEARCH_MIN_PX = 24;
22
+ const BROWSER_PDF_PAGE_BREAK_SAMPLE_STEP_PX = 4;
23
+ const BROWSER_PDF_PAGE_BREAK_WHITE_THRESHOLD = 246;
24
+ const BROWSER_PDF_PAGE_BREAK_ALPHA_THRESHOLD = 12;
25
+ const BROWSER_PDF_PAGE_BREAK_EMPTY_ROW_MAX_INK = 1;
26
+ function canvas2d(canvas, options) {
27
+ // 两种画布都提供 2D 重载,公共签名避免联合重载回退到其他渲染上下文。
28
+ const surface = canvas;
29
+ return surface.getContext('2d', options);
30
+ }
31
+ /**
32
+ * 按每页可用高度及接近页底的空白行选择断点。页面画布由调用者按顺序复用。
33
+ * @example 模块内部上下文
34
+ * ```ts
35
+ * const source = new OffscreenCanvas(794, 1123)
36
+ * const page = new OffscreenCanvas(1, 1)
37
+ * const pages = sliceCanvasPages(source, page)
38
+ * ```
39
+ */
40
+ export function* sliceCanvasPages(canvas, pageCanvas) {
41
+ const pageContext = canvas2d(pageCanvas);
42
+ if (!pageContext) {
43
+ throw new Error('Failed to prepare PDF page canvas');
44
+ }
45
+ const pixelsPerMillimeter = canvas.width / BROWSER_PDF_CONTENT_WIDTH_MM;
46
+ const pageHeightPx = Math.max(1, Math.floor(BROWSER_PDF_CONTENT_HEIGHT_MM * pixelsPerMillimeter));
47
+ const sourceContext = canvas2d(canvas, { willReadFrequently: true });
48
+ for (let sourceY = 0; sourceY < canvas.height;) {
49
+ const remainingHeightPx = canvas.height - sourceY;
50
+ const sliceHeightPx = remainingHeightPx > pageHeightPx && sourceContext
51
+ ? resolveCanvasPageSliceHeight(sourceContext, canvas, sourceY, pageHeightPx)
52
+ : Math.min(pageHeightPx, remainingHeightPx);
53
+ pageCanvas.width = canvas.width;
54
+ pageCanvas.height = sliceHeightPx;
55
+ pageContext.fillStyle = '#ffffff';
56
+ pageContext.fillRect(0, 0, pageCanvas.width, pageCanvas.height);
57
+ pageContext.drawImage(canvas, 0, sourceY, canvas.width, sliceHeightPx, 0, 0, canvas.width, sliceHeightPx);
58
+ yield sliceHeightPx / pixelsPerMillimeter;
59
+ sourceY += sliceHeightPx;
60
+ }
61
+ }
62
+ function resolveCanvasPageSliceHeight(sourceContext, canvas, sourceY, pageHeightPx) {
63
+ const searchRadiusPx = Math.max(BROWSER_PDF_PAGE_BREAK_SEARCH_MIN_PX, Math.min(BROWSER_PDF_PAGE_BREAK_SEARCH_MAX_PX, Math.floor(pageHeightPx * BROWSER_PDF_PAGE_BREAK_SEARCH_RATIO)));
64
+ const scanStartY = Math.max(sourceY + 1, sourceY + pageHeightPx - searchRadiusPx);
65
+ const scanEndY = Math.min(sourceY + pageHeightPx, canvas.height);
66
+ const scanHeight = scanEndY - scanStartY;
67
+ if (scanHeight <= 0) {
68
+ return Math.min(pageHeightPx, canvas.height - sourceY);
69
+ }
70
+ const imageData = sourceContext.getImageData(0, scanStartY, canvas.width, scanHeight);
71
+ const bestBreakY = findCanvasPageBreakY(imageData, scanStartY);
72
+ return Math.max(1, Math.min(bestBreakY - sourceY, canvas.height - sourceY));
73
+ }
74
+ function findCanvasPageBreakY(imageData, scanStartY) {
75
+ const rowWidth = imageData.width;
76
+ const rowHeight = imageData.height;
77
+ const rowStride = rowWidth * 4;
78
+ let bestEmptyRowY = 0;
79
+ let bestInkRowY = 0;
80
+ let lowestInkScore = Number.POSITIVE_INFINITY;
81
+ for (let rowIndex = 0; rowIndex < rowHeight; rowIndex += 1) {
82
+ const rowInkScore = measureCanvasRowInk(imageData.data, rowIndex * rowStride, rowWidth);
83
+ if (rowInkScore <= BROWSER_PDF_PAGE_BREAK_EMPTY_ROW_MAX_INK) {
84
+ bestEmptyRowY = scanStartY + rowIndex + 1;
85
+ }
86
+ if (rowInkScore <= lowestInkScore) {
87
+ lowestInkScore = rowInkScore;
88
+ bestInkRowY = scanStartY + rowIndex + 1;
89
+ }
90
+ }
91
+ return bestEmptyRowY || bestInkRowY || (scanStartY + rowHeight);
92
+ }
93
+ function measureCanvasRowInk(pixels, rowOffset, rowWidth) {
94
+ let inkScore = 0;
95
+ for (let column = 0; column < rowWidth; column += BROWSER_PDF_PAGE_BREAK_SAMPLE_STEP_PX) {
96
+ const pixelOffset = rowOffset + (column * 4);
97
+ const alpha = pixels[pixelOffset + 3];
98
+ if (alpha < BROWSER_PDF_PAGE_BREAK_ALPHA_THRESHOLD) {
99
+ continue;
100
+ }
101
+ const red = pixels[pixelOffset];
102
+ const green = pixels[pixelOffset + 1];
103
+ const blue = pixels[pixelOffset + 2];
104
+ if (red < BROWSER_PDF_PAGE_BREAK_WHITE_THRESHOLD
105
+ || green < BROWSER_PDF_PAGE_BREAK_WHITE_THRESHOLD
106
+ || blue < BROWSER_PDF_PAGE_BREAK_WHITE_THRESHOLD) {
107
+ inkScore += 1;
108
+ }
109
+ }
110
+ return inkScore;
111
+ }
@@ -0,0 +1,11 @@
1
+ /**
2
+ * 页面 PNG 和其在 PDF 中的正文高度,单位为毫米。
3
+ * @example 模块内部上下文
4
+ * ```ts
5
+ * const page: PdfPage = { bytes: new Uint8Array(1), height: 100 }
6
+ * ```
7
+ */
8
+ export interface PdfPage {
9
+ bytes: Uint8Array<ArrayBuffer>;
10
+ height: number;
11
+ }
@@ -0,0 +1,29 @@
1
+ import { sliceCanvasPages } from './document-pdf-pages.js';
2
+ globalThis.addEventListener('message', async ({ data: bitmap }) => {
3
+ try {
4
+ const source = new OffscreenCanvas(bitmap.width, bitmap.height);
5
+ const context = source.getContext('2d', { willReadFrequently: true });
6
+ if (!context)
7
+ throw new Error('Failed to prepare PDF source canvas');
8
+ context.drawImage(bitmap, 0, 0);
9
+ bitmap.close();
10
+ const page = new OffscreenCanvas(1, 1);
11
+ const pages = [];
12
+ for (const height of sliceCanvasPages(source, page)) {
13
+ const image = await page.convertToBlob({ type: 'image/png' });
14
+ pages.push({
15
+ bytes: new Uint8Array(await image.arrayBuffer()),
16
+ height,
17
+ });
18
+ }
19
+ globalThis.postMessage(pages, {
20
+ transfer: pages.map(item => item.bytes.buffer),
21
+ });
22
+ }
23
+ catch {
24
+ globalThis.postMessage(undefined);
25
+ }
26
+ finally {
27
+ bitmap.close();
28
+ }
29
+ });
@@ -0,0 +1,19 @@
1
+ import type { MarkdownRenderResult } from './document-parse.js';
2
+ import type { DocumentRenderJob } from './document-render-worker.js';
3
+ /**
4
+ * 浏览器长文档共用解析池。SSR 和短文档直接使用已有渲染器。
5
+ * @example 模块内部上下文
6
+ * ```ts
7
+ * const result = await documentRenderPool.run({ content: '# Report', locale: 'en-US' })
8
+ * if (result.success) void result.data.outline
9
+ * ```
10
+ */
11
+ export declare const documentRenderPool: import("@h-ai/core").WorkerPool<DocumentRenderJob, MarkdownRenderResult>;
12
+ /**
13
+ * 小文档同步渲染,以便在一次更新内保留 DOM 和选区行为。
14
+ * @example 模块内部上下文
15
+ * ```ts
16
+ * const eligible = useDocumentRenderWorker('# Article')
17
+ * ```
18
+ */
19
+ export declare function useDocumentRenderWorker(content: string): boolean;
@@ -0,0 +1,20 @@
1
+ import { core } from '@h-ai/core';
2
+ /**
3
+ * 浏览器长文档共用解析池。SSR 和短文档直接使用已有渲染器。
4
+ * @example 模块内部上下文
5
+ * ```ts
6
+ * const result = await documentRenderPool.run({ content: '# Report', locale: 'en-US' })
7
+ * if (result.success) void result.data.outline
8
+ * ```
9
+ */
10
+ export const documentRenderPool = core.worker.createPool(() => new Worker(new URL('./document-render-worker.js', import.meta.url), { type: 'module' }), { maxWorkers: 2, maxQueuedJobs: 4, idleTimeoutMs: 15_000 });
11
+ /**
12
+ * 小文档同步渲染,以便在一次更新内保留 DOM 和选区行为。
13
+ * @example 模块内部上下文
14
+ * ```ts
15
+ * const eligible = useDocumentRenderWorker('# Article')
16
+ * ```
17
+ */
18
+ export function useDocumentRenderWorker(content) {
19
+ return typeof Worker !== 'undefined' && content.length >= 32 * 1024;
20
+ }
@@ -0,0 +1,13 @@
1
+ import type { MarkdownDocumentParseOptions } from './document-parse.js';
2
+ /**
3
+ * 文档 Worker 只接收 Markdown、宿主语言及渲染选项。
4
+ * @example 模块内部上下文
5
+ * ```ts
6
+ * const job: DocumentRenderJob = { content: '# Report', locale: 'en-US', options: { enableHighlight: true } }
7
+ * ```
8
+ */
9
+ export interface DocumentRenderJob {
10
+ content: string;
11
+ locale: string;
12
+ options?: MarkdownDocumentParseOptions;
13
+ }
@@ -0,0 +1,7 @@
1
+ import { core } from '@h-ai/core';
2
+ import { renderMarkdownDocument } from './document-parse.js';
3
+ globalThis.addEventListener('message', ({ data }) => {
4
+ core.i18n.setGlobalLocale(data.locale);
5
+ const result = renderMarkdownDocument(data.content, data.options);
6
+ globalThis.postMessage(result);
7
+ });
@@ -120,6 +120,8 @@ export interface MarkdownRewriteRequest {
120
120
  actionId: string;
121
121
  /** 当前选中的原文。 */
122
122
  selectedText: string;
123
+ /** 可视正文中的精确纯文本偏移;宿主可据此映射原始 Markdown,不以纯文本猜测源码位置。 */
124
+ selectionSnapshot?: MarkdownSelectionSnapshot;
123
125
  /** 触发请求时的完整文档内容。 */
124
126
  content: string;
125
127
  /** 当前文档标题。 */