@f-o-t/pdf 0.1.0

package/README.md

@@ -0,0 +1,39 @@
+# @f-o-t/pdf
+
+Comprehensive PDF 1.7 library with generation, parsing, and digital signatures.
+
+## Features
+
+- **Complete PDF 1.7 Support**: Full spec implementation
+- **Generation**: Create PDFs from scratch with text, graphics, images
+- **Parsing**: Read and extract content from PDFs
+- **Digital Signatures**: Sign PDFs with @f-o-t/digital-certificate
+- **Zod-First**: Complete validation
+- **TypeScript-First**: Full type safety
+- **Stream Support**: Memory-efficient processing
+
+## Installation
+
+```bash
+bun add @f-o-t/pdf
+```
+
+## Quick Start
+
+```typescript
+import { createPDF } from "@f-o-t/pdf";
+
+const pdf = createPDF();
+pdf.addPage()
+   .drawText("Hello, World!", { x: 50, y: 750 });
+
+const bytes = await pdf.save();
+```
+
+## Documentation
+
+Coming soon.
+
+## License
+
+MIT

package/dist/generation/index.d.ts

@@ -0,0 +1,268 @@
+/**
+* PDF reference to indirect object
+*/
+type PDFRef = {
+	readonly objectNumber: number;
+	readonly generation: number;
+};
+/**
+* PDF value types
+*/
+type PDFValue = boolean | number | string | PDFName | PDFArray | PDFDictionary | PDFStream | null | PDFRef;
+/**
+* PDF Name object
+*/
+type PDFName = {
+	readonly type: "name";
+	readonly value: string;
+};
+/**
+* PDF Array
+*/
+type PDFArray = PDFValue[];
+/**
+* PDF Dictionary
+*/
+type PDFDictionary = Record<string, PDFValue>;
+/**
+* PDF Stream
+*/
+type PDFStream = {
+	readonly dictionary: PDFDictionary;
+	readonly data: Uint8Array;
+};
+/**
+* PDF Page size presets
+*/
+type PageSize = "A4" | "Letter" | "Legal" | "A3" | "A5" | "Tabloid" | {
+	width: number;
+	height: number;
+};
+/**
+* PDF Color
+*/
+type PDFColor = {
+	type: "rgb";
+	r: number;
+	g: number;
+	b: number;
+} | {
+	type: "cmyk";
+	c: number;
+	m: number;
+	y: number;
+	k: number;
+} | {
+	type: "gray";
+	gray: number;
+};
+/**
+* Text options
+*/
+type TextOptions = {
+	x: number;
+	y: number;
+	size?: number;
+	font?: string;
+	color?: PDFColor;
+	align?: "left" | "center" | "right";
+};
+/**
+* Rectangle options
+*/
+type RectOptions = {
+	x: number;
+	y: number;
+	width: number;
+	height: number;
+	fill?: PDFColor;
+	stroke?: PDFColor;
+	lineWidth?: number;
+};
+/**
+* Line options
+*/
+type LineOptions = {
+	x1: number;
+	y1: number;
+	x2: number;
+	y2: number;
+	color?: PDFColor;
+	lineWidth?: number;
+};
+/**
+* PDF metadata
+*/
+type PDFMetadata = {
+	title?: string;
+	author?: string;
+	subject?: string;
+	keywords?: string[];
+	creator?: string;
+	producer?: string;
+	creationDate?: Date;
+	modificationDate?: Date;
+};
+/**
+* PDF version
+*/
+type PDFVersion = "1.4" | "1.5" | "1.6" | "1.7";
+type PDFPageOptions = {
+	size?: PageSize;
+	parent?: PDFRef;
+};
+/**
+* PDF Page class
+*/
+declare class PDFPage {
+	ref: PDFRef;
+	size: PageSize;
+	parent?: PDFRef;
+	contentStream: string[];
+	private resources;
+	constructor(ref: PDFRef, options?: PDFPageOptions);
+	/**
+	* Get page dimensions in points
+	*/
+	getDimensions(): {
+		width: number;
+		height: number;
+	};
+	/**
+	* Set fill color
+	*/
+	private setFillColor;
+	/**
+	* Set stroke color
+	*/
+	private setStrokeColor;
+	/**
+	* Draw text on the page
+	*/
+	drawText(text: string, options: TextOptions): void;
+	/**
+	* Draw a rectangle
+	*/
+	drawRectangle(options: RectOptions): void;
+	/**
+	* Draw a line
+	*/
+	drawLine(options: LineOptions): void;
+	/**
+	* Get content stream reference
+	*/
+	getContentStreamRef(): PDFRef;
+	/**
+	* Generate content stream as PDFStream
+	*/
+	toContentStream(): PDFStream;
+	/**
+	* Convert page to PDF dictionary
+	*/
+	toDictionary(): PDFDictionary;
+}
+type PDFDocumentOptions = {
+	version?: PDFVersion;
+	metadata?: PDFMetadata;
+};
+/**
+* Main PDF Document class for generation
+*
+* @property version - PDF version (1.4, 1.5, 1.6, or 1.7)
+* @property metadata - Document metadata (title, author, etc.)
+* @property catalog - Reference to the document catalog
+* @property pages - Reference to the pages tree root
+*/
+declare class PDFDocument {
+	version: PDFVersion;
+	metadata: PDFMetadata;
+	private objects;
+	private nextObjectNumber;
+	catalog: PDFRef;
+	pages: PDFRef;
+	private pagesArray;
+	constructor(options?: PDFDocumentOptions);
+	/**
+	* Allocate a new object reference
+	*/
+	private allocateRef;
+	/**
+	* Add a page to the document
+	*/
+	addPage(options?: PDFPageOptions): PDFPage;
+	/**
+	* Save PDF to bytes
+	*/
+	save(): Uint8Array;
+}
+/**
+* PDF Standard 14 Fonts
+* These fonts are guaranteed to be available in all PDF readers
+*/
+declare const STANDARD_FONTS: {
+	readonly "Times-Roman": "Times-Roman";
+	readonly "Times-Bold": "Times-Bold";
+	readonly "Times-Italic": "Times-Italic";
+	readonly "Times-BoldItalic": "Times-BoldItalic";
+	readonly Helvetica: "Helvetica";
+	readonly "Helvetica-Bold": "Helvetica-Bold";
+	readonly "Helvetica-Oblique": "Helvetica-Oblique";
+	readonly "Helvetica-BoldOblique": "Helvetica-BoldOblique";
+	readonly Courier: "Courier";
+	readonly "Courier-Bold": "Courier-Bold";
+	readonly "Courier-Oblique": "Courier-Oblique";
+	readonly "Courier-BoldOblique": "Courier-BoldOblique";
+	readonly Symbol: "Symbol";
+	readonly ZapfDingbats: "ZapfDingbats";
+};
+type StandardFont = keyof typeof STANDARD_FONTS;
+/**
+* Font families for convenience
+*/
+declare const FONT_FAMILIES: {
+	times: {
+		regular: StandardFont;
+		bold: StandardFont;
+		italic: StandardFont;
+		boldItalic: StandardFont;
+	};
+	helvetica: {
+		regular: StandardFont;
+		bold: StandardFont;
+		oblique: StandardFont;
+		boldOblique: StandardFont;
+	};
+	courier: {
+		regular: StandardFont;
+		bold: StandardFont;
+		oblique: StandardFont;
+		boldOblique: StandardFont;
+	};
+	symbol: {
+		regular: StandardFont;
+	};
+	zapfDingbats: {
+		regular: StandardFont;
+	};
+};
+/**
+* Check if a font is a standard PDF font
+*/
+declare function isStandardFont(font: string): font is StandardFont;
+/**
+* Get font object reference name
+*/
+declare function getFontRefName(font: StandardFont): string;
+/**
+* Serialize a PDF value to string
+*/
+declare function serializeValue(value: PDFValue): string;
+/**
+* Serialize a PDF stream
+*/
+declare function serializeStream(stream: PDFStream): Uint8Array;
+/**
+* Serialize an indirect object
+*/
+declare function serializeObject(objectNumber: number, generation: number, value: any): Uint8Array;
+export { serializeValue, serializeStream, serializeObject, isStandardFont, getFontRefName, StandardFont, STANDARD_FONTS, PDFPageOptions, PDFPage, PDFDocumentOptions, PDFDocument, FONT_FAMILIES };

package/dist/generation/index.js

@@ -0,0 +1,26 @@
+import {
+  FONT_FAMILIES,
+  PDFDocument,
+  PDFPage,
+  STANDARD_FONTS,
+  getFontRefName,
+  isStandardFont,
+  serializeObject,
+  serializeStream,
+  serializeValue
+} from "../shared/chunk-37mjkw9w.js";
+import"../shared/chunk-6dengthp.js";
+export {
+  serializeValue,
+  serializeStream,
+  serializeObject,
+  isStandardFont,
+  getFontRefName,
+  STANDARD_FONTS,
+  PDFPage,
+  PDFDocument,
+  FONT_FAMILIES
+};
+
+//# debugId=3E109D686F511FD064756E2164756E21
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFtdLAogICJzb3VyY2VzQ29udGVudCI6IFsKICBdLAogICJtYXBwaW5ncyI6ICIiLAogICJkZWJ1Z0lkIjogIjNFMTA5RDY4NkY1MTFGRDA2NDc1NkUyMTY0NzU2RTIxIiwKICAibmFtZXMiOiBbXQp9