@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,45 @@
1
+ /**
2
+ * serialization/BuildPagesExport.ts
3
+ *
4
+ * _pages 导出:以页面为维度、题目为主体的结构化坐标数据
5
+ * 批改系统可直接读取,无需查表或重新渲染
6
+ */
7
+ import type { ContentBlock, Page, BBox } from '../../types/paper';
8
+ export interface QuestionExport {
9
+ topicId: string;
10
+ qid?: string;
11
+ questionNo: string;
12
+ questionType: string;
13
+ sortIndex: number;
14
+ bbox: BBox;
15
+ bboxes?: BBox[];
16
+ score?: number;
17
+ parentTopicId?: string;
18
+ hasSubQuestions?: boolean;
19
+ underlines?: BBox[];
20
+ isCrossPage?: boolean;
21
+ }
22
+ export interface PageExport {
23
+ pageIndex: number;
24
+ pageWidth: number;
25
+ pageHeight: number;
26
+ cornerMarks: {
27
+ position: string;
28
+ bbox: BBox;
29
+ }[];
30
+ header?: Record<string, BBox>;
31
+ sectionTitles?: {
32
+ label: string;
33
+ bbox: BBox;
34
+ }[];
35
+ questions: QuestionExport[];
36
+ footer?: {
37
+ pageNumber?: BBox;
38
+ };
39
+ }
40
+ /**
41
+ * 将 pages[].renderedRegions 转换为结构化导出格式
42
+ * 每页输出:cornerMarks + header? + sectionTitles? + questions + footer?
43
+ * 所有坐标均为 [x, y, w, h] 数组,保留 2 位小数
44
+ */
45
+ export declare function buildExportPages(pages: Page[], blocks: ContentBlock[], showScore?: boolean): PageExport[];
@@ -0,0 +1,23 @@
1
+ /**
2
+ * serialization/buildQuestions.ts
3
+ *
4
+ * 题目序列化:ContentBlock → SwDocument 节点
5
+ */
6
+ import type { ContentBlock, PageSettings, Paragraph, Line, InlineElement, OptionItem } from '../../types/paper';
7
+ import type { QuestionNode, ParagraphNode, InlineNode, OptionNode } from '../../types/document';
8
+ /**
9
+ * ContentBlock → QuestionNode
10
+ */
11
+ export declare function blockToQuestionNode(block: ContentBlock, settings: PageSettings): QuestionNode | null;
12
+ /**
13
+ * 构建选项节点 (OptionNode)
14
+ */
15
+ export declare function buildOptionNode(options: OptionItem[], topicId: string): OptionNode;
16
+ /**
17
+ * 内部 Paragraph → 文档 ParagraphNode
18
+ */
19
+ export declare function paragraphToNode(para: Paragraph): ParagraphNode;
20
+ /**
21
+ * 内部 InlineElement → 文档 InlineNode
22
+ */
23
+ export declare function inlineToNode(elem: InlineElement, _line: Line): InlineNode | null;
@@ -0,0 +1,61 @@
1
+ /**
2
+ * serialization/shared.ts
3
+ *
4
+ * 序列化/反序列化共享的常量、类型和工具函数
5
+ */
6
+ import type { ContentBlock } from '../../types/paper';
7
+ import type { Theme, Styles } from '../../types/document';
8
+ export declare const DEFAULT_THEME: Theme;
9
+ export declare const DEFAULT_STYLES: Styles;
10
+ export declare const DEFAULT_CORNER_OFFSET = 26.46;
11
+ export declare const QUESTION_STEM_INDENT = 17.5;
12
+ export declare const SUB_QUESTION_STEM_INDENT = 26.25;
13
+ /** 根据纸张尺寸动态计算角标坐标 */
14
+ export declare function computeCornerPoints(dim: {
15
+ width: number;
16
+ height: number;
17
+ }): {
18
+ tl: {
19
+ top: number;
20
+ left: number;
21
+ width: number;
22
+ height: number;
23
+ };
24
+ tr: {
25
+ top: number;
26
+ left: number;
27
+ width: number;
28
+ height: number;
29
+ };
30
+ bl: {
31
+ top: number;
32
+ left: number;
33
+ width: number;
34
+ height: number;
35
+ };
36
+ br: {
37
+ top: number;
38
+ left: number;
39
+ width: number;
40
+ height: number;
41
+ };
42
+ };
43
+ /** 从 blockId 提取 topicId(去掉 sw- 前缀和末尾 -序号 后缀) */
44
+ export declare function extractTopicId(blockId: string): string;
45
+ /** 构建 blockId/topicId → ContentBlock 查找表 */
46
+ export declare function buildBlockLookup(blocks: ContentBlock[]): Map<string, ContentBlock>;
47
+ /** 推断题型字符串 */
48
+ export declare function resolveQuestionType(block: ContentBlock | undefined): string;
49
+ /** 'student-name' → 'studentName' */
50
+ export declare function camelKey(s: string): string;
51
+ /** 检测 topicId 是否为子题(含 _Block_ 后缀) */
52
+ export declare function isSubQuestion(topicId: string): boolean;
53
+ /** 从子题 topicId 提取父题 topicId */
54
+ export declare function extractParentTopicId(topicId: string): string;
55
+ export declare function extractPlainText(block: ContentBlock): string;
56
+ export interface BlockSection {
57
+ type: 'title-section' | 'question-section';
58
+ name: string;
59
+ blocks: ContentBlock[];
60
+ }
61
+ export declare function groupBlocksBySection(blocks: ContentBlock[]): BlockSection[];
@@ -0,0 +1,36 @@
1
+ /**
2
+ * textWrap.ts — 换行算法共享模块
3
+ *
4
+ * 唯一来源。所有排版引擎和序列化器共用此算法,
5
+ * 确保「编辑时看到」「保存后恢复」「HTML导入」的换行结果完全一致。
6
+ *
7
+ * 使用方:
8
+ * - usePaperCore.ts (createParagraph → wrapElements)
9
+ * - documentSerializer.ts (createParagraph → wrapElementsSimple)
10
+ * - questionHtmlParser.ts (parseQuestionHtml → wrapElements)
11
+ */
12
+ import type { InlineElement, Line } from '../types/paper';
13
+ /**
14
+ * 从内联元素列表创建单行,计算 baseline 并处理公式/图片撑高行高
15
+ * 图片和公式都处理上下双向溢出,确保行高能完整容纳所有元素
16
+ */
17
+ export declare function createLineFromElements(elements: InlineElement[], lineHeight: number): Line;
18
+ /**
19
+ * 将内联元素按可用宽度换行分割为多行
20
+ *
21
+ * - 包含中文避头避尾规则
22
+ * - 支持公式/图片行高撑大
23
+ * - 支持首行缩减(如分数文本占位)
24
+ * - 超出列宽的空白自动拆分为多段跨行(填空题折行)
25
+ *
26
+ * @param elements 内联元素列表
27
+ * @param maxWidth 可用宽度(px)
28
+ * @param lineHeight 行高(px)
29
+ * @param firstLineExtraReduction 首行缩减宽度(可选)
30
+ */
31
+ export declare function wrapElements(elements: InlineElement[], maxWidth: number, lineHeight: number, firstLineExtraReduction?: number): Line[];
32
+ /**
33
+ * 仅做宽度换行(无首行缩减)
34
+ * 供序列化等不需要首行缩减的场景使用。
35
+ */
36
+ export declare function wrapElementsSimple(elements: InlineElement[], maxWidth: number, lineHeight: number): Line[];
package/dist/style.css ADDED
@@ -0,0 +1,2 @@
1
+ .paper-page text.text{dominant-baseline:hanging;white-space:pre}.paper-page .block:hover{cursor:default}.paper-page .formula svg{vertical-align:middle;overflow:visible}.paper-page text[fill=\#aaa]{-webkit-user-select:none;user-select:none;font-size:13px}.paper-page [data-block-id]{cursor:pointer}.paper-page rect[stroke-dasharray="4,4"]{pointer-events:none}svg.paper-page{display:block}text.topic-no,text.question-score{dominant-baseline:hanging}.title_wrapper{box-sizing:border-box;color:#231f20;text-align:left;background:#fff;border:none;align-items:center;max-width:100%;height:38px;padding:5px 0;font-family:Times New Roman,黑体;font-size:14pt;display:flex;position:relative}.title_wrapper .title-content{align-items:center;width:100%;display:inline-flex;overflow:hidden}.title_wrapper .title-content .title-text{color:#231f20;white-space:nowrap;font-size:15px;font-weight:600;line-height:32px}.title_wrapper .title-content .title-score{color:#231f20;border:none;padding:0 2px 0 8px;font-size:10pt;font-weight:400;line-height:1.2}.header-block{font-family:Microsoft YaHei,PingFang SC,sans-serif}.header-school-info{color:#595959;justify-content:center;align-items:center;gap:12px;width:100%;padding:6px 0 0;display:flex}.header-school-info--simple{padding-top:3px}.headerDesc{font-size:14px;line-height:1.5}.headerDesc strong{color:#000;font-size:16px}.header-school-info .score{white-space:nowrap;font-size:12px;line-height:1.5;display:inline-block}.header-paper-name{text-align:center;width:100%;padding:2px 0}.header-paper-name .input-box{flex-direction:column;justify-content:center;align-items:center;display:flex}.header-paper-name .input-box__label{display:none}.header-paper-name .input-box__input{color:#000;text-align:center;background:0 0;border:none;outline:none;padding:2px 8px;font-size:22px;font-weight:700;line-height:1.5;display:block}.header-student-info{align-items:flex-start;gap:16px;width:100%;padding:4px 0 0;display:flex}.header-student-info .qr-code-img{flex-shrink:0;width:65px;height:65px}.header-student-info .qr-code-img img{width:100%;height:auto;display:block}.student-fields{flex-direction:column;flex:1;gap:10px;min-width:0;display:flex}.student-fields-row{flex-wrap:wrap;gap:16px;display:flex}.student-field{flex:1;align-items:center;min-width:120px;display:flex}.student-field .label{color:#000;white-space:nowrap;margin-right:4px;font-size:14px}.student-field .underline{border-bottom:1px solid #000;flex:1;min-width:60px;height:22px}.student-code{color:#000;align-items:center;font-size:13px;display:flex}.student-code-table{border-collapse:collapse;vertical-align:middle;margin-left:4px;display:inline-table}.student-code-cell{text-align:center;border:1px solid #000;width:25px;height:30px;font-size:14px}.tail-time-wrapper{color:#595959;width:100%;font-family:Microsoft YaHei,PingFang SC,sans-serif;font-size:12px}.answer-wrapper,.revise-wrapper{align-items:center;gap:6px;display:flex}.tail-col{align-items:center;gap:3px;display:flex}.center-col{flex-direction:column;align-items:center;gap:2px;display:flex}.tail-col-item{gap:1px}.tail-label.text{color:#8c8c8c;white-space:nowrap;font-size:11px}.tail-col .text{color:#595959;white-space:nowrap;font-size:12px}.tail-col .text-second{color:#bfbfbf;font-size:10px}.rect{box-sizing:border-box;border:1px solid #d9d9d9;border-radius:2px;width:18px;height:18px}.rect-fill{background:#f0f0f0}.rect-stroke{background:0 0}.revise-area{align-items:center;gap:4px;display:flex}.revise-area-label{color:#8c8c8c;white-space:nowrap;font-size:11px}.revise-area-rect{box-sizing:border-box;border:1px solid #d9d9d9;border-radius:2px;width:18px;height:18px}.el-icon.triangle{color:#8c8c8c;justify-content:center;align-items:center;font-size:14px;display:inline-flex}.pe-editor-surface::-webkit-scrollbar{width:6px;height:6px}.pe-editor-surface::-webkit-scrollbar-thumb{background:#d9d9d9;border-radius:3px}.pe-editor-surface::-webkit-scrollbar-thumb:hover{background:#bfbfbf}.paper-page g.question:hover>rect.question-hitarea{fill:#409eff0a}.paper-page g.question:hover>path.question-border{stroke:#409eff}.paper-page g.underline:hover>rect.underline-hitarea{fill:#409eff0f}.paper-page g.underline:hover>rect[fill="rgb(245,245,245)"]{fill:#f0f8f7}.editable-dashed{cursor:pointer;outline-offset:1px;border-radius:2px;outline:1px dashed #bfbfbf;padding:0 2px}.editable-dashed:hover,.editable-dashed:focus{outline-offset:1px;border-radius:2px;outline:1px dashed #409eff}.pe-root[data-v-3e2dc264]{background:#f0f2f5;flex-direction:column;width:100%;height:100%;font-family:Microsoft YaHei,PingFang SC,sans-serif;display:flex;overflow:hidden}.pe-main[data-v-3e2dc264]{background:#e8ebf0;flex:1;justify-content:center;display:flex;position:relative;overflow:hidden}.pe-editor[data-v-3e2dc264]{justify-content:center;width:100%;height:100%;display:flex;overflow:hidden}.pe-editor-surface[data-v-3e2dc264]{box-sizing:border-box;-webkit-user-select:none;user-select:none;scrollbar-width:none;-ms-overflow-style:none;font-synthesis:unset;text-rendering:auto;-webkit-font-smoothing:auto;background-color:#eee;width:100%;height:100%;padding:10px 0;position:relative;overflow:auto;transform:scaleY(.99999)}.pe-editor-defs[data-v-3e2dc264]{width:1px;height:1px;position:absolute;overflow:hidden}.pe-editor-pages[data-v-3e2dc264]{flex-direction:column;align-items:center;gap:24px;min-height:100%;padding:24px 0;display:flex}.pe-editor-page[data-v-3e2dc264]{background:#fff;border:2px solid #0000;flex-shrink:0;line-height:0;transition:border-color .2s,box-shadow .2s;box-shadow:0 1px 6px #00000014}.pe-editor-page.active[data-v-3e2dc264]{border-color:#409eff;box-shadow:0 2px 12px #409eff33}.pe-editor-viewport[data-v-3e2dc264]{transform-origin:0 0;-webkit-user-select:text;user-select:text}.pe-editor-viewport[data-v-3e2dc264] svg.paper-page{display:block}.pe-editor-controllers[data-v-3e2dc264]{pointer-events:none;z-index:102;width:100%;height:100%;position:absolute;top:0;left:0;overflow:visible}.pe-ctrl-block[data-v-3e2dc264]{pointer-events:auto}.pe-ctrl-height[data-v-3e2dc264]{cursor:ns-resize;color:#fff;opacity:.85;z-index:103;pointer-events:auto;background:#409eff;border-radius:4px;justify-content:center;align-items:center;width:44px;height:20px;transition:opacity .15s;display:flex;position:absolute;bottom:-11px;left:50%;transform:translate(-50%)}.pe-ctrl-height[data-v-3e2dc264]:hover{opacity:1;background:#048f80}.pe-ctrl-height[data-v-3e2dc264]:active{background:#037066}.pe-ctrlUnderline[data-v-3e2dc264]{pointer-events:auto;box-sizing:border-box;border:1.5px solid #409eff;border-radius:2px}.pe-ctrl-ul-left[data-v-3e2dc264],.pe-ctrl-ul-right[data-v-3e2dc264]{cursor:ew-resize;color:#fff;opacity:.85;z-index:103;background:#409eff;border-radius:4px;justify-content:center;align-items:center;width:20px;height:28px;transition:opacity .15s;display:flex;position:absolute;top:50%;transform:translateY(-50%)}.pe-ctrl-ul-left[data-v-3e2dc264]{left:-12px}.pe-ctrl-ul-right[data-v-3e2dc264]{right:-12px}.pe-ctrl-ul-left[data-v-3e2dc264]:hover,.pe-ctrl-ul-right[data-v-3e2dc264]:hover{opacity:1;background:#048f80}.pe-ctrl-ul-left[data-v-3e2dc264]:active,.pe-ctrl-ul-right[data-v-3e2dc264]:active{background:#037066}.pe-ctrlAnchor[data-v-3e2dc264]{pointer-events:auto;box-sizing:border-box;cursor:move;border:1.5px solid #409eff;border-radius:1px}.pe-resize-se[data-v-3e2dc264],.pe-resize-sw[data-v-3e2dc264],.pe-resize-ne[data-v-3e2dc264],.pe-resize-nw[data-v-3e2dc264]{box-sizing:border-box;z-index:104;background:#409eff;border:1px solid #fff;border-radius:2px;width:10px;height:10px;position:absolute}.pe-resize-se[data-v-3e2dc264]{cursor:nwse-resize;bottom:-5px;right:-5px}.pe-resize-sw[data-v-3e2dc264]{cursor:nesw-resize;bottom:-5px;left:-5px}.pe-resize-ne[data-v-3e2dc264]{cursor:nesw-resize;top:-5px;right:-5px}.pe-resize-nw[data-v-3e2dc264]{cursor:nwse-resize;top:-5px;left:-5px}.pe-resize-se[data-v-3e2dc264]:hover,.pe-resize-sw[data-v-3e2dc264]:hover,.pe-resize-ne[data-v-3e2dc264]:hover,.pe-resize-nw[data-v-3e2dc264]:hover{background:#048f80}.pe-img-align-bar[data-v-3e2dc264]{z-index:105;background:#409eff;border-radius:4px;gap:0;display:flex;position:absolute;overflow:hidden}.pe-align-btn[data-v-3e2dc264]{color:#fff;cursor:pointer;background:0 0;border:none;justify-content:center;align-items:center;width:28px;height:24px;font-size:12px;transition:background .15s;display:flex}.pe-align-btn[data-v-3e2dc264]:hover{background:#fff3}.pe-align-btn.active[data-v-3e2dc264]{background:#00000040}.pe-editor-input-wrapper[data-v-3e2dc264]{z-index:-1;opacity:0;width:0;position:absolute}.pe-editor-virtual-input[data-v-3e2dc264]{width:5px;height:30px}.pe-editor-cursor[data-v-3e2dc264]{z-index:99999999;background:#000;width:1px;height:0;animation:1s ease-in-out infinite pe-blink-3e2dc264;position:absolute;top:0;left:0}@keyframes pe-blink-3e2dc264{0%{opacity:.8}50%{opacity:0}}.pe-preview[data-v-c429b5aa]{width:100%;font-family:Times New Roman,宋体,Cambria Math,serif;overflow:hidden}.pe-preview__pages[data-v-c429b5aa]{flex-direction:column;align-items:center;gap:16px;padding:16px 0;display:flex}.pe-preview__page[data-v-c429b5aa]{background:#fff;position:relative;overflow:hidden;box-shadow:0 2px 12px #00000026}.pe-preview__page-col[data-v-c429b5aa]{position:absolute;top:0;left:0}.pe-preview__page-col[data-v-c429b5aa] svg{width:100%;height:100%;display:block}.pe-preview__helpers[data-v-c429b5aa]{pointer-events:none;width:100%;height:100%;position:absolute;top:0;left:0}.pe-preview__helper-box[data-v-c429b5aa]{box-sizing:border-box}.pe-preview__page-num[data-v-c429b5aa]{color:#bfbfbf;pointer-events:none;font-size:11px;position:absolute;bottom:4px;right:8px}.pe-preview--print .pe-preview__page[data-v-c429b5aa]{box-shadow:none;page-break-before:always;page-break-after:always;page-break-inside:avoid;-webkit-print-color-adjust:exact;print-color-adjust:exact;margin:0}.pe-preview--print .pe-preview__pages[data-v-c429b5aa]{gap:0;padding:0}.pe-preview--print .pe-preview__helpers[data-v-c429b5aa],.pe-preview--print .pe-preview__page-num[data-v-c429b5aa]{display:none!important}@media print{@page{margin:0}body[data-v-c429b5aa]{margin:0;padding:0}}
2
+ /*$vite$:1*/
@@ -0,0 +1,2 @@
1
+ declare const _default: import("vite").UserConfig;
2
+ export default _default;
package/package.json ADDED
@@ -0,0 +1,53 @@
1
+ {
2
+ "name": "@sw7d/paper-renderer",
3
+ "version": "0.1.0",
4
+ "description": "题卡设计器核心组件 - 纯编辑表面",
5
+ "type": "module",
6
+ "main": "./dist/paper-renderer.js",
7
+ "types": "./dist/src/index.d.ts",
8
+ "exports": {
9
+ ".": {
10
+ "import": "./dist/paper-renderer.js",
11
+ "types": "./dist/src/index.d.ts"
12
+ },
13
+ "./styles": "./dist/style.css"
14
+ },
15
+ "files": [
16
+ "dist",
17
+ "README.md"
18
+ ],
19
+ "scripts": {
20
+ "dev": "vite",
21
+ "build": "vite build && vue-tsc --declaration --emitDeclarationOnly --outDir dist --noEmit false",
22
+ "typecheck": "vue-tsc --noEmit",
23
+ "prepublishOnly": "npm run build"
24
+ },
25
+ "keywords": [
26
+ "paper",
27
+ "renderer",
28
+ "svg",
29
+ "exam",
30
+ "editor",
31
+ "vue"
32
+ ],
33
+ "license": "MIT",
34
+ "author": "",
35
+ "publishConfig": {
36
+ "access": "public"
37
+ },
38
+ "peerDependencies": {
39
+ "vue": "^3.4.0"
40
+ },
41
+ "devDependencies": {
42
+ "@types/node": "^25.9.2",
43
+ "@types/qrcode": "^1.5.6",
44
+ "@vitejs/plugin-vue": "^6.0.7",
45
+ "typescript": "~6.0.2",
46
+ "vite": "^8.0.12",
47
+ "vue": "^3.5.35",
48
+ "vue-tsc": "^3.0.0"
49
+ },
50
+ "dependencies": {
51
+ "qrcode": "^1.5.4"
52
+ }
53
+ }