@sw7d/paper-renderer 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/README.MD +10 -0
  2. package/dist/paper-renderer.js +6862 -0
  3. package/dist/src/components/PaperEditor.vue.d.ts +172 -0
  4. package/dist/src/components/PaperPreview.vue.d.ts +26 -0
  5. package/dist/src/composables/paperHelpers.d.ts +35 -0
  6. package/dist/src/composables/usePageSvgRenderer.d.ts +26 -0
  7. package/dist/src/composables/usePaperBlockOps.d.ts +74 -0
  8. package/dist/src/composables/usePaperCore.d.ts +181 -0
  9. package/dist/src/composables/usePaperCursor.d.ts +45 -0
  10. package/dist/src/composables/usePaperSelection.d.ts +45 -0
  11. package/dist/src/composables/useTableRenderer.d.ts +33 -0
  12. package/dist/src/engine/PaperLayout.d.ts +59 -0
  13. package/dist/src/engine/SvgRenderer.d.ts +75 -0
  14. package/dist/src/engine/svg/headerRenderer.d.ts +36 -0
  15. package/dist/src/engine/svg/optionsRenderer.d.ts +23 -0
  16. package/dist/src/engine/svg/questionRenderer.d.ts +35 -0
  17. package/dist/src/index.d.ts +35 -0
  18. package/dist/src/types/document.d.ts +498 -0
  19. package/dist/src/types/paper.d.ts +278 -0
  20. package/dist/src/utils/charWidth.d.ts +46 -0
  21. package/dist/src/utils/chineseNumber.d.ts +50 -0
  22. package/dist/src/utils/deserialization/parseDocument.d.ts +19 -0
  23. package/dist/src/utils/deserialization/parseInlines.d.ts +13 -0
  24. package/dist/src/utils/deserialization/parseQuestions.d.ts +21 -0
  25. package/dist/src/utils/documentSerializer.d.ts +33 -0
  26. package/dist/src/utils/mathjax.d.ts +57 -0
  27. package/dist/src/utils/paperHtmlBuilder.d.ts +21 -0
  28. package/dist/src/utils/qrcode.d.ts +7 -0
  29. package/dist/src/utils/questionHtmlParser.d.ts +40 -0
  30. package/dist/src/utils/questionJsonParser.d.ts +61 -0
  31. package/dist/src/utils/serialization/buildBody.d.ts +11 -0
  32. package/dist/src/utils/serialization/buildPagesExport.d.ts +45 -0
  33. package/dist/src/utils/serialization/buildQuestions.d.ts +23 -0
  34. package/dist/src/utils/serialization/shared.d.ts +61 -0
  35. package/dist/src/utils/textWrap.d.ts +36 -0
  36. package/dist/style.css +2 -0
  37. package/dist/vite.config.d.ts +2 -0
  38. package/package.json +53 -0
@@ -0,0 +1,59 @@
1
+ /**
2
+ * PaperLayout - 试卷版面布局引擎
3
+ *
4
+ * 核心职责:
5
+ * 1. 将内容块流式布局到各页面
6
+ * 2. 自动跨页截断(一个题块可在多页间拆分)
7
+ * 3. 精确计算每个元素在 SVG 中的坐标
8
+ * 4. 支持 A4/A3 切换、单栏/双栏
9
+ * 5. 生成四角定位标记
10
+ */
11
+ import type { ContentBlock, Page, CornerMark, PageSettings } from '../types/paper';
12
+ export declare class PaperLayout {
13
+ settings: PageSettings;
14
+ pageWidth: number;
15
+ pageHeight: number;
16
+ contentWidth: number;
17
+ contentHeight: number;
18
+ columnWidth: number;
19
+ columnGap: number;
20
+ private readonly FOOTER_EXTRA_GAP;
21
+ /** FOOTER_TOP 根据页面高度和底部边距动态计算 */
22
+ private get footerTop();
23
+ constructor(settings?: Partial<PageSettings>);
24
+ private getDefaultSettings;
25
+ private updateDimensions;
26
+ updateSettings(settings: Partial<PageSettings>): void;
27
+ getColumnX(col: number): number;
28
+ /**
29
+ * 将内容块排版到页面中
30
+ * 支持跨栏/跨页按段落折断
31
+ * bodyTop 从 settings.bodyTopEven / bodyTopOdd 读取,不再靠参数传递
32
+ */
33
+ layout(blocks: ContentBlock[]): Page[];
34
+ /**
35
+ * 统一块折断:将一个 ContentBlock 按段落分发到各栏/各页
36
+ * 每个 PageBlock 只包含该片段能容纳的段落(paragraphStart / paragraphCount)
37
+ */
38
+ private placeBlockFragments;
39
+ private finalizePage;
40
+ /**
41
+ * 测量块高度(包含选项区域)
42
+ */
43
+ measureBlock(block: ContentBlock): number;
44
+ /**
45
+ * 测量选项区域总高度(autoLayout 自动换行)
46
+ * 与 SvgRenderer.calcOptionsHeight 使用相同的动态间距算法,确保布局预留高度 = 实际渲染高度
47
+ */
48
+ private measureOptionsHeight;
49
+ measureParagraph(p: {
50
+ lines: Array<{
51
+ lineHeight: number;
52
+ }>;
53
+ }): number;
54
+ /**
55
+ * 创建四角定位标记 — 根据当前页面尺寸动态计算
56
+ * offset 为角标离页面边缘的距离,与参考保持一致(26.46px ≈ 7mm)
57
+ */
58
+ createCornerMarks(): CornerMark[];
59
+ }
@@ -0,0 +1,75 @@
1
+ /**
2
+ * SvgRenderer - 将布局数据渲染为 SVG DOM 字符串
3
+ *
4
+ * 每页 SVG 结构:
5
+ * background → header → footer → layout(角标) → body → selection
6
+ *
7
+ * 编排器模式:核心类仅负责页面结构编排和状态管理,
8
+ * 具体渲染逻辑委托给 svg/ 子模块纯函数。
9
+ */
10
+ import type { Page, ContentBlock, PageSettings, OptionItem, RenderedRegion, RenderMode, HeaderLayoutConfig } from '../types/paper';
11
+ export declare class SvgRenderer {
12
+ private readonly FOOTER_EXTRA_GAP;
13
+ private renderMode;
14
+ constructor(options?: {
15
+ renderMode?: RenderMode;
16
+ });
17
+ /** 设置渲染模式 */
18
+ setRenderMode(mode: RenderMode): void;
19
+ /** 获取当前渲染模式 */
20
+ getRenderMode(): RenderMode;
21
+ /**
22
+ * 根据纸张方向和栏数动态计算 Header 布局配置
23
+ */
24
+ computeHeaderLayout(settings: PageSettings, page: Page): HeaderLayoutConfig;
25
+ /**
26
+ * 以指定模式执行回调,完成后恢复原模式
27
+ */
28
+ withRenderMode<T>(mode: RenderMode, fn: () => T): T;
29
+ /**
30
+ * 将所有页面渲染为单个 SVG 字符串(用于导出预览)
31
+ */
32
+ renderAllPages(pages: Page[], blocks: ContentBlock[], settings: PageSettings, options?: {
33
+ showBBoxes?: boolean;
34
+ selectedBlockId?: string | null;
35
+ totalScore?: number;
36
+ paperName?: string;
37
+ schoolName?: string;
38
+ qrCodeImage?: string;
39
+ }): string;
40
+ /**
41
+ * 渲染单个页面内容(无包装器,可直接放入 <svg>)
42
+ */
43
+ renderPage(page: Page, blocks: ContentBlock[], bodyTop: number, settings: PageSettings, options?: {
44
+ showBBoxes: boolean;
45
+ selectedBlockId: string | null;
46
+ totalScore?: number;
47
+ paperName?: string;
48
+ schoolName?: string;
49
+ qrCodeImage?: string;
50
+ }, totalPages?: number, includeDefs?: boolean): string;
51
+ /**
52
+ * 计算一页中所有有意义区域的绝对像素坐标
53
+ */
54
+ computePageRegions(page: Page, blocks: ContentBlock[], bodyTop: number, settings: PageSettings, _totalPages?: number): RenderedRegion[];
55
+ /**
56
+ * 从已渲染的 DOM 实测 header 区域坐标
57
+ */
58
+ measureRegionsFromDOM(pageIdx: number, page: Page, regions: RenderedRegion[]): void;
59
+ /**
60
+ * 计算选项区域总高度(公开方法,供 overlay / 布局使用)
61
+ */
62
+ getOptionsHeight(options: OptionItem[], stemWidth: number): number;
63
+ /**
64
+ * 核心:渲染一页的完整内容
65
+ */
66
+ private renderPageContent;
67
+ /**
68
+ * 按栏分组块
69
+ */
70
+ private groupBlocksByColumn;
71
+ /**
72
+ * 渲染角标
73
+ */
74
+ private renderCornerMark;
75
+ }
@@ -0,0 +1,36 @@
1
+ /**
2
+ * svg/headerRenderer.ts
3
+ *
4
+ * Header/Footer SVG 渲染(纯函数模块)
5
+ */
6
+ import type { HeaderLayoutConfig, RenderMode } from '../../types/paper';
7
+ export declare function escapeXml(str: string): string;
8
+ /**
9
+ * Header 编排器 — 根据 layout config 垂直堆叠 3 个独立 block
10
+ * 第1页完整头部:SchoolInfo + PaperName + StudentInfoGroup
11
+ */
12
+ export declare function renderHeaderEmbedsOrchestrated(config: HeaderLayoutConfig, fullPageConfig: HeaderLayoutConfig, totalScore: number, paperName: string, schoolName: string, qrCodeImage: string, showScore: boolean, renderMode: RenderMode): string;
13
+ /**
14
+ * Header Block 1: 学校信息行 — 始终居中
15
+ */
16
+ export declare function renderHeaderBlockSchoolInfo(config: HeaderLayoutConfig, schoolName: string, totalScore: number, offsetY: number, showScore: boolean, renderMode: RenderMode): string;
17
+ /**
18
+ * Header Block 2: 试卷名称 — 居中
19
+ */
20
+ export declare function renderHeaderBlockPaperName(config: HeaderLayoutConfig, paperName: string, offsetY: number, renderMode: RenderMode): string;
21
+ /**
22
+ * Header Block 3: 学生信息组 — 居左
23
+ */
24
+ export declare function renderHeaderBlockStudentInfo(config: HeaderLayoutConfig, offsetY: number, qrCodeImage?: string): string;
25
+ /**
26
+ * 后续页简化 header-embeds — 仅学校名+分数
27
+ */
28
+ export declare function renderSimpleHeaderEmbeds(config: HeaderLayoutConfig, totalScore: number, schoolName: string, showScore: boolean, renderMode: RenderMode): string;
29
+ /**
30
+ * footer-embeds — 作答时长选择 + 订正情况
31
+ */
32
+ export declare function renderFooterEmbeds(): string;
33
+ /**
34
+ * 渲染全局 SVG Defs(enter/break 符号定义)
35
+ */
36
+ export declare function renderGlobalDefs(): string;
@@ -0,0 +1,23 @@
1
+ /**
2
+ * svg/optionsRenderer.ts
3
+ *
4
+ * 选择题选项区域 SVG 渲染(纯函数模块)
5
+ */
6
+ import type { OptionItem, RenderMode } from '../../types/paper';
7
+ /**
8
+ * 渲染选择题选项区域 (g.option)
9
+ *
10
+ * 布局策略(autoLayout):
11
+ * - 计算每个选项内容宽度
12
+ * - 能同行放下 → 水平排列(translate X 偏移)
13
+ * - 放不下 → 换行(translate Y 偏移)
14
+ */
15
+ export declare function renderOptions(options: OptionItem[], stemWidth: number, startY: number, fontSize: number, renderMode: RenderMode): string;
16
+ /**
17
+ * 计算单个选项的总宽度(标签 + 内容)
18
+ */
19
+ export declare function calcOptionItemWidth(opt: OptionItem, labelWidth: number, maxContentWidth: number): number;
20
+ /**
21
+ * 计算选项区域总高度
22
+ */
23
+ export declare function calcOptionsHeight(options: OptionItem[], stemWidth: number): number;
@@ -0,0 +1,35 @@
1
+ /**
2
+ * svg/questionRenderer.ts
3
+ *
4
+ * 题块/段落/行内元素 SVG 渲染(纯函数模块)
5
+ */
6
+ import type { ContentBlock, Paragraph, Line, InlineElement, RenderMode } from '../../types/paper';
7
+ /**
8
+ * 计算行的动态基线
9
+ */
10
+ export declare function computeLineBaseline(line: Line, fontSize: number): number;
11
+ /**
12
+ * 渲染一道题 (g.question)
13
+ */
14
+ export declare function renderQuestion(pb: {
15
+ blockId: string;
16
+ paragraphStart: number;
17
+ paragraphCount: number;
18
+ width: number;
19
+ height: number;
20
+ x: number;
21
+ y: number;
22
+ blockType?: string;
23
+ }, block: ContentBlock, yOffset: number, showBBox: boolean, isSelected: boolean, isFirstFragment: boolean, isLastFragment: boolean, fontSize: number, showScore: boolean, renderMode: RenderMode): string;
24
+ /**
25
+ * 渲染题组标题(如"填空题")
26
+ */
27
+ export declare function renderTitleEmbed(block: ContentBlock, yOffset: number, width: number, xOffset?: number, showScore?: boolean, isSelected?: boolean, renderMode?: RenderMode): string;
28
+ /**
29
+ * 渲染段落 (g.paragraph)
30
+ */
31
+ export declare function renderParagraph(para: Paragraph, maxWidth: number, yOffset: number, isFirstPara: boolean, score: string | undefined, fontSize: number, renderMode: RenderMode, xOffset?: number): string;
32
+ /**
33
+ * 渲染行内元素
34
+ */
35
+ export declare function renderInlineElement(elem: InlineElement, x: number, baseline: number, _lineHeight: number, _isEmptyLine: boolean, renderMode: RenderMode, inlineImageId?: string, isImageOnlyLine?: boolean): string;
@@ -0,0 +1,35 @@
1
+ /**
2
+ * paper-renderer - 题卡设计器核心组件
3
+ *
4
+ * 纯编辑表面 + HTML 覆盖层交互。无 element-plus 依赖。
5
+ * 工具栏和对话框由宿主应用实现,通过 ref 调用结构化 API。
6
+ *
7
+ * 用法:
8
+ * import { PaperEditor } from 'paper-renderer'
9
+ * // 或导入底层模块
10
+ * import { usePaperCore, SvgRenderer, PaperLayout } from 'paper-renderer'
11
+ */
12
+ export type { PaperSize, ColumnMode, PaperDimensions, PageSettings, PaperPreset, InlineType, BaseInline, TextInline, FormulaInline, UnderlineInline, ImageInline, EnterInline, ObjectFillInline, InlineElement, Line, Paragraph, OptionItem, QuestionType, BlockType, ContentBlock, PageBlock, CornerMark, BBox, RenderedRegion, Page, PaperDocument, SelectionState, EditorState, RenderMode } from './types/paper';
13
+ export { PAPER_DIMENSIONS, PAPER_MM, getPaperPreset, toBBox } from './types/paper';
14
+ export type { SwDocument, DocInfo, HeaderSection, BodySection, ColumnNode, VuePlugNode, QuestionNode, QuestionProps, QuestionStemNode, CorrectionBoxNode, OptionNode, ParagraphNode, InlineNode, TextNode, LatexNode, UnderlineNode, ImageNode, AnchorNode, Theme, Styles } from './types/document';
15
+ export { PaperLayout } from './engine/PaperLayout';
16
+ export { SvgRenderer } from './engine/SvgRenderer';
17
+ export { getCharWidth, calcTextWidth, calcCharPositions, clearWidthCache } from './utils/charWidth';
18
+ export { latexToSvg, latexToSvgBatch, clearFormulaCache } from './utils/mathjax';
19
+ export type { LatexResult } from './utils/mathjax';
20
+ export { serializeDocument, deserializeDocument } from './utils/documentSerializer';
21
+ export type { SerializeOptions, DeserializeResult } from './utils/documentSerializer';
22
+ export { parseQuestionHtml } from './utils/questionHtmlParser';
23
+ export type { ParseQuestionHtmlOptions } from './utils/questionHtmlParser';
24
+ export { parseQuestionJson } from './utils/questionJsonParser';
25
+ export type { QuestionJsonData, ParseQuestionJsonOptions } from './utils/questionJsonParser';
26
+ export { toChineseOrdinal, formatSectionTitle, extractBaseTitle } from './utils/chineseNumber';
27
+ export { buildPaperHtml } from './utils/paperHtmlBuilder';
28
+ export type { PaperHtmlOptions } from './utils/paperHtmlBuilder';
29
+ export { usePaperCore, fontSizeLabelToPx, fontSizePxToLabel, FONT_SIZE_MAP } from './composables/usePaperCore';
30
+ export type { UsePaperCoreOptions } from './composables/usePaperCore';
31
+ export { usePageSvgRenderer } from './composables/usePageSvgRenderer';
32
+ export type { PageSvgOptions } from './composables/usePageSvgRenderer';
33
+ export { renderTablePlaceholders, hasTablePlaceholder } from './composables/useTableRenderer';
34
+ export { default as PaperEditor } from './components/PaperEditor.vue';
35
+ export { default as PaperPreview } from './components/PaperPreview.vue';