byte-codec 0.0.0 → 1.0.1

package/dist/image/png-filter.js

@@ -0,0 +1,93 @@
+//#region src/image/png-filter.ts
+function paethPredictor(a, b, c) {
+	const p = a + b - c;
+	const pa = Math.abs(p - a);
+	const pb = Math.abs(p - b);
+	const pc = Math.abs(p - c);
+	if (pa <= pb && pa <= pc) return a;
+	if (pb <= pc) return b;
+	return c;
+}
+function isPngFilterType(value) {
+	return value === 0 || value === 1 || value === 2 || value === 3 || value === 4;
+}
+function predictorValue(filterType, a, b, c) {
+	if (filterType === 1) return a;
+	if (filterType === 2) return b;
+	if (filterType === 3) return Math.floor((a + b) / 2);
+	if (filterType === 4) return paethPredictor(a, b, c);
+	return 0;
+}
+function unfilterScanlines(data, height, bytesPerRow, bpp) {
+	const stride = bytesPerRow + 1;
+	if (data.length < height * stride) throw new Error(`PNG scanline data too short: expected at least ${height * stride} bytes, got ${data.length}`);
+	const out = new Uint8Array(height * bytesPerRow);
+	for (let y = 0; y < height; y++) {
+		const filterByte = data[y * stride];
+		if (filterByte === void 0 || !isPngFilterType(filterByte)) throw new Error(`unknown PNG filter type: ${String(filterByte)}`);
+		const rowStart = y * stride + 1;
+		const outRowStart = y * bytesPerRow;
+		const prevOutRowStart = y > 0 ? outRowStart - bytesPerRow : void 0;
+		for (let x = 0; x < bytesPerRow; x++) {
+			const raw = data[rowStart + x];
+			const a = x >= bpp ? out[outRowStart + x - bpp] : 0;
+			const b = prevOutRowStart === void 0 ? 0 : out[prevOutRowStart + x];
+			const c = x >= bpp && prevOutRowStart !== void 0 ? out[prevOutRowStart + x - bpp] : 0;
+			out[outRowStart + x] = raw + predictorValue(filterByte, a, b, c) & 255;
+		}
+	}
+	return out;
+}
+function sumOfAbsSigned(bytes) {
+	let sum = 0;
+	for (const byte of bytes) sum += byte < 128 ? byte : 256 - byte;
+	return sum;
+}
+function filterRowInto(raw, rowStart, prevRowStart, bytesPerRow, bpp, filterType, out, outOffset) {
+	for (let x = 0; x < bytesPerRow; x++) {
+		const rawByte = raw[rowStart + x];
+		const a = x >= bpp ? raw[rowStart + x - bpp] : 0;
+		const b = prevRowStart === void 0 ? 0 : raw[prevRowStart + x];
+		const c = x >= bpp && prevRowStart !== void 0 ? raw[prevRowStart + x - bpp] : 0;
+		out[outOffset + x] = rawByte - predictorValue(filterType, a, b, c) & 255;
+	}
+}
+const ALL_FILTER_TYPES = [
+	0,
+	1,
+	2,
+	3,
+	4
+];
+function filterScanlines(raw, height, bytesPerRow, bpp, strategy = "adaptive") {
+	const stride = bytesPerRow + 1;
+	const out = new Uint8Array(height * stride);
+	const candidate = new Uint8Array(bytesPerRow);
+	for (let y = 0; y < height; y++) {
+		const rowStart = y * bytesPerRow;
+		const prevRowStart = y > 0 ? rowStart - bytesPerRow : void 0;
+		const outRowStart = y * stride;
+		if (strategy === "none") {
+			out[outRowStart] = 0;
+			filterRowInto(raw, rowStart, prevRowStart, bytesPerRow, bpp, 0, out, outRowStart + 1);
+			continue;
+		}
+		let bestType = 0;
+		let bestSum = Number.POSITIVE_INFINITY;
+		let best;
+		for (const filterType of ALL_FILTER_TYPES) {
+			filterRowInto(raw, rowStart, prevRowStart, bytesPerRow, bpp, filterType, candidate, 0);
+			const sum = sumOfAbsSigned(candidate);
+			if (sum < bestSum) {
+				bestSum = sum;
+				bestType = filterType;
+				best = candidate.slice();
+			}
+		}
+		out[outRowStart] = bestType;
+		if (best !== void 0) out.set(best, outRowStart + 1);
+	}
+	return out;
+}
+//#endregion
+export { filterScanlines, unfilterScanlines };

package/dist/index-VKR9nd94.d.ts

@@ -0,0 +1,9 @@
+import { crc32 } from "./bytes/crc32-BVCBBYa3.js";
+import { DeflateLevel, InflateResult, MAX_INFLATE_OUTPUT_BYTES, deflate, inflate, inflateTolerant } from "./bytes/flate-CbSD2OU9.js";
+import { ByteReader, isAsciiWhitespace } from "./bytes/reader-CDx_NmAQ.js";
+import { ByteWriter, concatBytes } from "./bytes/writer-B9uaqo-B.js";
+import { JpegInfo, readJpegInfo } from "./image/jpeg-info-Dh6D8PRh.js";
+import { PngDecodeOptions, RawImage, decodePng } from "./image/png-decode-Dvizumot.js";
+import { PngEncodeOptions, encodePng } from "./image/png-encode-C5Jj9gBX.js";
+import { PngFilterType, filterScanlines, unfilterScanlines } from "./image/png-filter-5L1Q0PDF.js";
+export { ByteReader, ByteWriter, DeflateLevel, InflateResult, JpegInfo, MAX_INFLATE_OUTPUT_BYTES, PngDecodeOptions, PngEncodeOptions, PngFilterType, RawImage, concatBytes, crc32, decodePng, deflate, encodePng, filterScanlines, inflate, inflateTolerant, isAsciiWhitespace, readJpegInfo, unfilterScanlines };

package/dist/index-v-4chATX.d.cts

@@ -0,0 +1,9 @@
+import { crc32 } from "./bytes/crc32-BVCBBYa3.cjs";
+import { DeflateLevel, InflateResult, MAX_INFLATE_OUTPUT_BYTES, deflate, inflate, inflateTolerant } from "./bytes/flate-CbSD2OU9.cjs";
+import { ByteReader, isAsciiWhitespace } from "./bytes/reader-CDx_NmAQ.cjs";
+import { ByteWriter, concatBytes } from "./bytes/writer-B9uaqo-B.cjs";
+import { JpegInfo, readJpegInfo } from "./image/jpeg-info-Dh6D8PRh.cjs";
+import { PngDecodeOptions, RawImage, decodePng } from "./image/png-decode-Dvizumot.cjs";
+import { PngEncodeOptions, encodePng } from "./image/png-encode-CpwBOmkg.cjs";
+import { PngFilterType, filterScanlines, unfilterScanlines } from "./image/png-filter-5L1Q0PDF.cjs";
+export { ByteReader, ByteWriter, DeflateLevel, InflateResult, JpegInfo, MAX_INFLATE_OUTPUT_BYTES, PngDecodeOptions, PngEncodeOptions, PngFilterType, RawImage, concatBytes, crc32, decodePng, deflate, encodePng, filterScanlines, inflate, inflateTolerant, isAsciiWhitespace, readJpegInfo, unfilterScanlines };

package/dist/index.cjs

@@ -0,0 +1,23 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_bytes_writer = require("./bytes/writer.cjs");
+const require_bytes_reader = require("./bytes/reader.cjs");
+const require_bytes_crc32 = require("./bytes/crc32.cjs");
+const require_bytes_flate = require("./bytes/flate.cjs");
+const require_image_png_filter = require("./image/png-filter.cjs");
+const require_image_png_encode = require("./image/png-encode.cjs");
+const require_image_png_decode = require("./image/png-decode.cjs");
+const require_image_jpeg_info = require("./image/jpeg-info.cjs");
+exports.ByteReader = require_bytes_reader.ByteReader;
+exports.ByteWriter = require_bytes_writer.ByteWriter;
+exports.MAX_INFLATE_OUTPUT_BYTES = require_bytes_flate.MAX_INFLATE_OUTPUT_BYTES;
+exports.concatBytes = require_bytes_writer.concatBytes;
+exports.crc32 = require_bytes_crc32.crc32;
+exports.decodePng = require_image_png_decode.decodePng;
+exports.deflate = require_bytes_flate.deflate;
+exports.encodePng = require_image_png_encode.encodePng;
+exports.filterScanlines = require_image_png_filter.filterScanlines;
+exports.inflate = require_bytes_flate.inflate;
+exports.inflateTolerant = require_bytes_flate.inflateTolerant;
+exports.isAsciiWhitespace = require_bytes_reader.isAsciiWhitespace;
+exports.readJpegInfo = require_image_jpeg_info.readJpegInfo;
+exports.unfilterScanlines = require_image_png_filter.unfilterScanlines;

package/dist/index.js

@@ -0,0 +1,9 @@
+import { ByteWriter, concatBytes } from "./bytes/writer.js";
+import { ByteReader, isAsciiWhitespace } from "./bytes/reader.js";
+import { crc32 } from "./bytes/crc32.js";
+import { MAX_INFLATE_OUTPUT_BYTES, deflate, inflate, inflateTolerant } from "./bytes/flate.js";
+import { filterScanlines, unfilterScanlines } from "./image/png-filter.js";
+import { encodePng } from "./image/png-encode.js";
+import { decodePng } from "./image/png-decode.js";
+import { readJpegInfo } from "./image/jpeg-info.js";
+export { ByteReader, ByteWriter, MAX_INFLATE_OUTPUT_BYTES, concatBytes, crc32, decodePng, deflate, encodePng, filterScanlines, inflate, inflateTolerant, isAsciiWhitespace, readJpegInfo, unfilterScanlines };

package/package.json

@@ -1,5 +1,70 @@
 {
   "name": "byte-codec",
-  "version": "0.0.0",
-  "private": false
+  "version": "1.0.1",
+  "description": "Generic byte-level primitives (ByteWriter, ByteReader, CRC-32, deflate/inflate) and PNG/JPEG image encoding/decoding with zero PDF knowledge — the shared utility package for the documents.js family.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ExaDev/byte-codec.git"
+  },
+  "homepage": "https://github.com/ExaDev/byte-codec#readme",
+  "bugs": {
+    "url": "https://github.com/ExaDev/byte-codec/issues"
+  },
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/index.d.ts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./*": {
+      "types": {
+        "import": "./dist/*.d.ts",
+        "require": "./dist/*.d.cts"
+      },
+      "import": "./dist/*.js",
+      "require": "./dist/*.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --fix --cache --max-warnings 0",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepare": "husky",
+    "prepublishOnly": "tsdown",
+    "lint:check": "eslint . --max-warnings 0"
+  },
+  "files": [
+    "dist"
+  ],
+  "packageManager": "pnpm@11.6.0",
+  "dependencies": {
+    "fflate": "^0.8.2"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^21.2.1",
+    "@commitlint/config-conventional": "^21.2.0",
+    "@eslint/js": "^10.0.1",
+    "@semantic-release/changelog": "^7.0.0",
+    "@semantic-release/git": "^11.0.1",
+    "@types/node": "^26.1.2",
+    "eslint": "^10.8.0",
+    "globals": "^17.8.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.2.0",
+    "semantic-release": "^25.0.8",
+    "tsdown": "^0.12.5",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.65.0",
+    "vitest": "^4.1.10"
+  },
+  "lint-staged": {
+    "*.ts": "eslint --fix"
+  }
 }