@u1f992/pdfdiff 0.0.1 → 0.1.0

package/src/jimp.ts

@@ -0,0 +1,14 @@
+import * as jimp from "jimp";
+
+export type JimpInstance = Pick<
+  jimp.JimpInstance,
+  | "width"
+  | "height"
+  | "getPixelColor"
+  | "setPixelColor"
+  | "resize"
+  | "composite"
+> & {
+  getBuffer: (mime: "image/png") => ReturnType<jimp.JimpInstance["getBuffer"]>;
+  getBase64: (mime: "image/png") => ReturnType<jimp.JimpInstance["getBase64"]>;
+};

package/src/pdf.ts

@@ -0,0 +1,42 @@
+/*
+ * Copyright (C) 2025  Koutaro Mukai
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import * as jimp from "jimp";
+import * as mupdf from "mupdf";
+
+export function* loadPages(pdf: mupdf.Document) {
+  for (let i = 0; i < pdf.countPages(); i++) {
+    yield pdf.loadPage(i);
+  }
+}
+
+export async function pageToImage(
+  page: mupdf.Page,
+  dpi: number,
+  alpha: boolean,
+) {
+  const zoom = dpi / 72;
+  const pixmap = page.toPixmap(
+    [zoom, 0, 0, zoom, 0, 0],
+    mupdf.ColorSpace.DeviceRGB,
+    alpha,
+  );
+  const ret = await jimp.Jimp.fromBuffer(new Uint8Array(pixmap.asPNG()).buffer);
+  pixmap.destroy();
+  page.destroy();
+  return ret;
+}

package/src/rgba-color.test.ts

@@ -0,0 +1,43 @@
+/*
+ * Copyright (C) 2025  Koutaro Mukai
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import assert from "assert";
+import test from "node:test";
+
+import { parseHex, formatHex } from "./rgba-color.ts";
+
+test("parseHex", async (ctx) => {
+  await ctx.test("#rgb", () => {
+    assert.deepStrictEqual(parseHex("#fed"), [0xff, 0xee, 0xdd, 0xff]);
+  });
+  await ctx.test("#rrggbb", () => {
+    assert.deepStrictEqual(parseHex("#fffefd"), [0xff, 0xfe, 0xfd, 0xff]);
+  });
+  await ctx.test("#rgba", () => {
+    assert.deepStrictEqual(parseHex("#fedc"), [0xff, 0xee, 0xdd, 0xcc]);
+  });
+  await ctx.test("#rrggbbaa", () => {
+    assert.deepStrictEqual(parseHex("#fffefdfc"), [0xff, 0xfe, 0xfd, 0xfc]);
+  });
+  await ctx.test("invalid", () => {
+    assert.deepStrictEqual(parseHex("foobar"), null);
+  });
+});
+
+test("formatHex", () => {
+  assert.deepStrictEqual(formatHex([0xff, 0xfe, 0xfd, 0xfc]), "#fffefdfc");
+});

package/src/rgba-color.ts

@@ -0,0 +1,63 @@
+/*
+ * Copyright (C) 2025  Koutaro Mukai
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+export type RGBAColor = [number, number, number, number];
+
+export const parseHex = (hex: string) => {
+  if (/^#([0-9a-fA-F]{3})$/.test(hex)) {
+    return [
+      parseInt(hex[1]! + hex[1]!, 16),
+      parseInt(hex[2]! + hex[2]!, 16),
+      parseInt(hex[3]! + hex[3]!, 16),
+      255,
+    ] as RGBAColor;
+  }
+  if (/^#([0-9a-fA-F]{4})$/.test(hex)) {
+    return [
+      parseInt(hex[1]! + hex[1]!, 16),
+      parseInt(hex[2]! + hex[2]!, 16),
+      parseInt(hex[3]! + hex[3]!, 16),
+      parseInt(hex[4]! + hex[4]!, 16),
+    ] as RGBAColor;
+  }
+  if (/^#([0-9a-fA-F]{6})$/.test(hex)) {
+    return [
+      parseInt(hex.slice(1, 3), 16),
+      parseInt(hex.slice(3, 5), 16),
+      parseInt(hex.slice(5, 7), 16),
+      255,
+    ] as RGBAColor;
+  }
+  if (/^#([0-9a-fA-F]{8})$/.test(hex)) {
+    return [
+      parseInt(hex.slice(1, 3), 16),
+      parseInt(hex.slice(3, 5), 16),
+      parseInt(hex.slice(5, 7), 16),
+      parseInt(hex.slice(7, 9), 16),
+    ] as RGBAColor;
+  }
+  return null;
+};
+
+export const formatHex = ([r, g, b, a]: RGBAColor) =>
+  "#" +
+  [r, g, b, a]
+    .map((v) => {
+      const hex = v.toString(16);
+      return hex.length === 1 ? "0" + hex : hex;
+    })
+    .join("");

package/src/style.css

@@ -0,0 +1,19 @@
+.summary-content {
+  display: inline-flex;
+  align-items: baseline;
+  gap: 20px;
+}
+
+.checkerboard-bg {
+  background-image: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAAAAABWESUoAAAAHUlEQVQ4y2P4gQYeoAGGUQUjSgG6ALqGUQUjSgEAdjWwLh+tpFgAAAAASUVORK5CYII=");
+}
+
+.diff-table {
+  border: 1px solid black;
+  border-collapse: collapse;
+}
+
+.diff-table th,
+.diff-table td {
+  border: 1px solid black;
+}

package/src/worker.ts

@@ -0,0 +1,62 @@
+/*
+ * Copyright (C) 2025  Koutaro Mukai
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import * as jimp from "jimp";
+
+import { drawDifference, type Pallet } from "./diff.js";
+import { composeLayers, type AlignStrategy } from "./image.js";
+import type { JimpInstance } from "./jimp.js";
+
+self.addEventListener(
+  "message",
+  async (
+    e: MessageEvent<{
+      bufA: ArrayBuffer;
+      bufB: ArrayBuffer;
+      bufMask: ArrayBuffer;
+      pallet: Pallet;
+      align: AlignStrategy;
+    }>,
+  ) => {
+    const { bufA, bufB, bufMask, pallet, align } = e.data;
+    const a = (await jimp.Jimp.fromBuffer(bufA)) as JimpInstance;
+    const b = (await jimp.Jimp.fromBuffer(bufB)) as JimpInstance;
+    const mask = (await jimp.Jimp.fromBuffer(bufMask)) as JimpInstance;
+    const {
+      diff: diffLayer,
+      addition,
+      deletion,
+      modification,
+    } = drawDifference(a, b, mask, pallet, align);
+    const diff = composeLayers(a.width, a.height, [
+      [a, 0.2],
+      [b, 0.2],
+      [diffLayer, 1],
+    ]);
+    const bufDiff = new Uint8Array(await diff.getBuffer(jimp.JimpMime.png))
+      .buffer;
+    self.postMessage(
+      {
+        bufDiff,
+        addition,
+        deletion,
+        modification,
+      },
+      [bufDiff],
+    );
+  },
+);

package/tsconfig.json

@@ -0,0 +1,50 @@
+{
+  // Visit https://aka.ms/tsconfig to read more about this file
+  "compilerOptions": {
+    // File Layout
+    "rootDir": "./src",
+    "outDir": "./dist",
+
+    // Environment Settings
+    // See also https://aka.ms/tsconfig/module
+    "module": "esnext",
+    "target": "esnext",
+    // "types": [],
+    // For nodejs:
+    "lib": ["esnext", "WebWorker", "DOM"],
+    "types": ["node"],
+    // and npm install -D @types/node
+
+    // Other Outputs
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+
+    // Stricter Typechecking Options
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+
+    // Style Options
+    // "noImplicitReturns": true,
+    // "noImplicitOverride": true,
+    // "noUnusedLocals": true,
+    // "noUnusedParameters": true,
+    // "noFallthroughCasesInSwitch": true,
+    // "noPropertyAccessFromIndexSignature": true,
+
+    // Recommended Options
+    "strict": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true,
+
+    // With Rollup
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "rewriteRelativeImportExtensions": true,
+    "noEmit": true
+  }
+}