Beautiful pdf components, built on Takumi and Forme. 100% Free, Zero config, one command setup.
export interface PdfInspection {
pages: number;
standards: string[];
tagged: boolean;
title?: string;
authors?: string[];
created?: string;
bookmarks: Bookmark[];
attachments: { name: string; description?: string }[];
}
interface Bookmark {
title: string;
depth: number;
}
const bytesToChars = (bytes: Uint8Array): string => {
let text = "";
for (let offset = 0; offset < bytes.length; offset += 0x80_00) {
text += String.fromCodePoint(...bytes.subarray(offset, offset + 0x80_00));
}
return text;
};
const utf8 = (value: string | undefined): string | undefined =>
value &&
new TextDecoder().decode(
Uint8Array.from(value, (char) => char.codePointAt(0) ?? 0)
);
const pdfString = (raw: string): string => {
if (raw.startsWith("<")) {
const hex = raw.slice(1, -1).replaceAll(/\s/g, "");
const text = (hex.match(/.{4}/g) ?? [])
.map((unit) => String.fromCodePoint(Number.parseInt(unit, 16)))
.join("");
return text.replace(/^/, "");
}
return raw.slice(1, -1).replaceAll(/\\([()\\])/g, "$1");
};
const entry = (object: string, key: string): string | undefined => {
const match = object.match(
new RegExp(`/${key}\\s*(\\([^)]*\\)|<[0-9A-Fa-f\\s]*>)`)
);
return match?.[1] && pdfString(match[1]);
};
const readBookmarks = (objects: string[]): Bookmark[] => {
const byNumber = new Map<string, string>();
for (const object of objects) {
const number = object.match(/(\d+)\s+0\s+obj/)?.[1];
if (number) {
byNumber.set(number, object);
}
}
const followRef = (object: string | undefined, key: string) => {
const number = object?.match(
new RegExp(`/${key}\\s+(\\d+)\\s+0\\s+R`)
)?.[1];
return number === undefined ? undefined : byNumber.get(number);
};
const bookmarks: Bookmark[] = [];
const walk = (first: string | undefined, depth: number) => {
let node = first;
while (node && bookmarks.length < 500) {
bookmarks.push({ depth, title: entry(node, "Title") ?? "" });
walk(followRef(node, "First"), depth + 1);
node = followRef(node, "Next");
}
};
walk(
followRef(
objects.find((object) => /\/Type\s*\/Outlines/.test(object)),
"First"
),
0
);
return bookmarks.filter((bookmark) => bookmark.title);
};
export const inspectPdf = (bytes: Uint8Array): PdfInspection => {
const text = bytesToChars(bytes);
const objects = text.split("endobj");
const xmp = text.match(/<x:xmpmeta[\s\S]*?<\/x:xmpmeta>/)?.[0] ?? "";
const xmpValue = (tag: string) =>
xmp.match(new RegExp(`<${tag}>([^<]*)<`))?.[1];
const archival = xmpValue("pdfaid:part");
const accessible = xmpValue("pdfuaid:part");
const standards: string[] = [
archival &&
`PDF/A-${archival}${(xmpValue("pdfaid:conformance") ?? "").toLowerCase()}`,
accessible && `PDF/UA-${accessible}`,
].filter(Boolean) as string[];
const authors = [...xmp.matchAll(/<dc:creator>[\s\S]*?<\/dc:creator>/g)]
.flatMap((match) => [...match[0].matchAll(/<rdf:li>([^<]*)</g)])
.map((match) => utf8(match[1]));
return {
attachments: objects
.filter((object) => object.includes("/Filespec"))
.map((object) => ({
description: entry(object, "Desc"),
name: entry(object, "F") ?? "",
}))
.filter((attachment) => attachment.name),
authors: authors.length > 0 ? (authors as string[]) : undefined,
bookmarks: readBookmarks(objects),
created: xmpValue("xmp:CreateDate")?.slice(0, 10),
pages: text.match(/\/Type\s*\/Page[^s]/g)?.length ?? 0,
standards,
tagged: text.includes("/StructTreeRoot"),
title: utf8(xmp.match(/<dc:title>[\s\S]*?<rdf:li[^>]*>([^<]*)</)?.[1]),
};
};