feat: 建立可复现字体包构建链

2026-07-31 21:52:36 +08:00
parent 9f96d51922
commit ae9fde3ac6
14 changed files with 1225 additions and 5 deletions
@@ -0,0 +1,157 @@
+import { createHash } from "node:crypto";
+import {
+  copyFile,
+  mkdir,
+  mkdtemp,
+  readFile,
+  rm,
+  writeFile
+} from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { afterEach, describe, expect, it } from "vitest";
+import { buildFontPack, verifyFontPack } from "../src/index.js";
+
+const repositoryRoot = fileURLToPath(new URL("../../../", import.meta.url));
+const katexFontRoot = join(repositoryRoot, "node_modules", "katex", "dist", "fonts");
+const temporaryDirectories: string[] = [];
+
+function hash(content: Uint8Array | string) {
+  return createHash("sha256").update(content).digest("hex");
+}
+
+async function temporaryDirectory() {
+  const directory = await mkdtemp(join(tmpdir(), "mdtp-font-pack-builder-"));
+  temporaryDirectories.push(directory);
+  return directory;
+}
+
+async function createFixture(root: string) {
+  const sourceRoot = join(root, "source");
+  const recipeRoot = join(root, "recipe");
+  const outputRoot = join(root, "output", "root");
+  const reportPath = join(root, "output", "report.json");
+  await Promise.all([mkdir(sourceRoot, { recursive: true }), mkdir(recipeRoot, { recursive: true })]);
+  const webName = "KaTeX_Main-Regular.woff2";
+  const docxName = "KaTeX_Main-Regular.ttf";
+  await Promise.all([
+    copyFile(join(katexFontRoot, webName), join(sourceRoot, webName)),
+    copyFile(join(katexFontRoot, docxName), join(sourceRoot, docxName))
+  ]);
+  const [web, docx] = await Promise.all([
+    readFile(join(sourceRoot, webName)),
+    readFile(join(sourceRoot, docxName))
+  ]);
+  const license = "Test Font License\n";
+  const notice = "# Test font\n";
+  await Promise.all([
+    writeFile(join(recipeRoot, "LICENSE.txt"), license, "utf8"),
+    writeFile(join(recipeRoot, "SOURCE.md"), notice, "utf8")
+  ]);
+  const recipe = {
+    recipeVersion: 1,
+    manifestVersion: 1,
+    id: "test-serif",
+    version: "1.0.0",
+    name: "测试字体包",
+    description: "构建器测试",
+    internalFamily: "KaTeX_Main",
+    license: "Test",
+    licenseSource: "LICENSE.txt",
+    licensePath: "LICENSE.txt",
+    licenseBytes: Buffer.byteLength(license),
+    licenseSha256: hash(license),
+    noticeSource: "SOURCE.md",
+    noticePath: "SOURCE.md",
+    compatibility: {
+      minimumAppVersion: "0.6.0",
+      maximumAppVersionExclusive: "0.7.0"
+    },
+    faces: [
+      {
+        id: "main-regular",
+        targets: ["KaTeX_Main"],
+        weight: 400,
+        style: "normal",
+        web: {
+          source: webName,
+          path: `fonts/${webName}`,
+          bytes: web.byteLength,
+          sha256: hash(web)
+        },
+        docx: {
+          source: docxName,
+          path: `fonts/${docxName}`,
+          bytes: docx.byteLength,
+          sha256: hash(docx)
+        }
+      }
+    ]
+  };
+  const recipePath = join(recipeRoot, "recipe.json");
+  await writeFile(recipePath, `${JSON.stringify(recipe, null, 2)}\n`, "utf8");
+  return { sourceRoot, recipeRoot, outputRoot, reportPath, recipePath, recipe };
+}
+
+afterEach(async () => {
+  await Promise.all(
+    temporaryDirectories.splice(0).map((directory) =>
+      rm(directory, { recursive: true, force: true })
+    )
+  );
+});
+
+describe("字体包构建器", () => {
+  it("从冻结资源构建可注册、可重复验证的字体包", async () => {
+    const fixture = await createFixture(await temporaryDirectory());
+    const first = await buildFontPack(fixture);
+    expect(first.unchanged).toBe(false);
+    expect(first.packId).toBe("test-serif");
+    expect(first.faces[0]).toMatchObject({
+      family: "KaTeX_Main",
+      weight: 400,
+      permission: "installable"
+    });
+    expect(JSON.parse(await readFile(fixture.reportPath, "utf8"))).toMatchObject({
+      packId: "test-serif",
+      packVersion: "1.0.0"
+    });
+
+    const second = await buildFontPack(fixture);
+    expect(second.unchanged).toBe(true);
+    expect(second.packFingerprint).toBe(first.packFingerprint);
+
+    const verified = await verifyFontPack({
+      root: fixture.outputRoot,
+      appVersion: "0.6.0",
+      packId: "test-serif",
+      packVersion: "1.0.0"
+    });
+    expect(verified.faces).toHaveLength(1);
+  });
+
+  it("拒绝哈希不匹配的冻结字体源", async () => {
+    const fixture = await createFixture(await temporaryDirectory());
+    const webPath = join(fixture.sourceRoot, "KaTeX_Main-Regular.woff2");
+    const content = await readFile(webPath);
+    content[content.byteLength - 1] = (content[content.byteLength - 1] ?? 0) ^ 1;
+    await writeFile(webPath, content);
+    await expect(buildFontPack(fixture)).rejects.toThrow("SHA-256");
+  });
+
+  it("拒绝覆盖内容不同的同版本发行包", async () => {
+    const fixture = await createFixture(await temporaryDirectory());
+    await buildFontPack(fixture);
+    const changedRecipe = {
+      ...fixture.recipe,
+      description: "同版本内容发生变化"
+    };
+    await writeFile(
+      fixture.recipePath,
+      `${JSON.stringify(changedRecipe, null, 2)}\n`,
+      "utf8"
+    );
+    await expect(buildFontPack(fixture)).rejects.toThrow("拒绝覆盖");
+  });
+});