feat: 建立 DOCX 主题映射引擎

2026-07-30 20:28:47 +08:00
parent e7c688df6e
commit 6fed666f44
15 changed files with 851 additions and 25 deletions
@@ -0,0 +1,162 @@
+import { themeManifestSchema } from "@md-to-pdf/core";
+import { describe, expect, it } from "vitest";
+import {
+  DOCX_STYLE_SLOTS,
+  docxThemeStyleSnapshotSchema,
+  docxThemeTokenSetSchema,
+  normalizeDocxThemeMappingConfig
+} from "../src/index.js";
+
+function createManifest(docxStyle?: unknown) {
+  return themeManifestSchema.parse({
+    manifestVersion: 1,
+    id: "external-clean",
+    name: "External Clean",
+    version: "1.0.0",
+    description: "外部主题",
+    author: "Tester",
+    license: "MIT",
+    entry: "theme.css",
+    domPreset: "generic",
+    defaultFontSize: "16px",
+    supportedFeatures: ["table"],
+    category: "general",
+    compatibleProfiles: [],
+    ...(docxStyle ? { docxStyle } : {}),
+    bundled: false
+  });
+}
+
+describe("DOCX 主题映射配置", () => {
+  it("没有 DOCX 声明的外部主题默认使用自动映射", () => {
+    expect(
+      normalizeDocxThemeMappingConfig(createManifest())
+    ).toEqual({
+      mode: "auto",
+      basePreset: "general",
+      overrides: {},
+      legacyPreset: false
+    });
+  });
+
+  it("兼容现有 preset 与扁平覆盖", () => {
+    const result = normalizeDocxThemeMappingConfig(
+      createManifest({
+        preset: "technical",
+        body: { sizePt: 11 }
+      })
+    );
+    expect(result).toMatchObject({
+      mode: "explicit",
+      basePreset: "technical",
+      overrides: { body: { sizePt: 11 } },
+      legacyPreset: true
+    });
+  });
+
+  it("新式 overrides 优先于旧式扁平覆盖", () => {
+    const result = normalizeDocxThemeMappingConfig(
+      createManifest({
+        mode: "auto-with-overrides",
+        basePreset: "formal",
+        body: { sizePt: 11, color: "#111111" },
+        overrides: { body: { sizePt: 12 } }
+      })
+    );
+    expect(result.overrides.body?.sizePt).toBe(12);
+    expect(result.overrides.body?.color).toBe("#111111");
+  });
+});
+
+describe("DOCX 主题引擎契约", () => {
+  it("样式槽位名称与选择器保持唯一", () => {
+    expect(new Set(DOCX_STYLE_SLOTS.map((slot) => slot.name)).size)
+      .toBe(DOCX_STYLE_SLOTS.length);
+    expect(
+      new Set(DOCX_STYLE_SLOTS.map((slot) => slot.selector)).size
+    ).toBe(DOCX_STYLE_SLOTS.length);
+  });
+
+  it("拒绝重复或状态不一致的样式快照", () => {
+    const computed = {
+      fontFamily: "Arial",
+      fontSize: "16px",
+      fontWeight: "400",
+      fontStyle: "normal",
+      color: "rgb(0, 0, 0)",
+      backgroundColor: "rgba(0, 0, 0, 0)",
+      lineHeight: "24px",
+      letterSpacing: "normal",
+      textAlign: "start",
+      textIndent: "0px",
+      textDecorationLine: "none",
+      marginTop: "0px",
+      marginRight: "0px",
+      marginBottom: "0px",
+      marginLeft: "0px",
+      paddingTop: "0px",
+      paddingRight: "0px",
+      paddingBottom: "0px",
+      paddingLeft: "0px",
+      borderTop: "0px none rgb(0, 0, 0)",
+      borderRight: "0px none rgb(0, 0, 0)",
+      borderBottom: "0px none rgb(0, 0, 0)",
+      borderLeft: "0px none rgb(0, 0, 0)",
+      width: "100px",
+      maxWidth: "none",
+      breakBefore: "auto",
+      breakAfter: "auto",
+      breakInside: "auto",
+      display: "block"
+    };
+    const result = docxThemeStyleSnapshotSchema.safeParse({
+      schemaVersion: 1,
+      themeId: "external-clean",
+      themeFingerprint: "a".repeat(64),
+      viewport: {
+        widthPx: 794,
+        heightPx: 1123,
+        deviceScaleFactor: 1
+      },
+      rootFontSizePx: 16,
+      slots: [
+        { slot: "paragraph", matched: true, computed },
+        { slot: "paragraph", matched: false }
+      ]
+    });
+    expect(result.success).toBe(false);
+  });
+
+  it("接受带来源、置信度和诊断的样式令牌", () => {
+    expect(
+      docxThemeTokenSetSchema.parse({
+        schemaVersion: 1,
+        themeId: "external-clean",
+        themeFingerprint: "b".repeat(64),
+        mode: "auto",
+        basePreset: "general",
+        slots: [
+          {
+            slot: "paragraph",
+            source: "computed-css",
+            confidence: "exact",
+            style: {
+              fontCandidates: ["Arial", "sans-serif"],
+              fontSizePt: 12,
+              color: "#111111"
+            }
+          }
+        ],
+        diagnostics: [
+          {
+            severity: "warning",
+            code: "font-fallback-required",
+            message: "首选字体不可用",
+            slot: "paragraph",
+            property: "font-family"
+          }
+        ]
+      }).slots
+    ).toHaveLength(1);
+  });
+});