@dvvebond/core 0.2.12

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lucas Smith
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,214 @@
+# LibPDF
+
+[![npm](https://img.shields.io/npm/v/@libpdf/core)](https://www.npmjs.com/package/@libpdf/core)
+[![npm downloads](https://img.shields.io/npm/dm/@libpdf/core)](https://www.npmjs.com/package/@libpdf/core)
+[![CI](https://github.com/LibPDF-js/core/actions/workflows/ci.yml/badge.svg)](https://github.com/LibPDF-js/core/actions/workflows/ci.yml)
+[![GitHub stars](https://img.shields.io/github/stars/libpdf-js/core?style=flat)](https://github.com/LibPDF-js/core)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+
+A modern PDF library for TypeScript. Parse, modify, and generate PDFs with a clean, intuitive API.
+
+> **Beta Software**: LibPDF is under active development and APIs may change between minor versions, but we use it in production at [Documenso](https://documenso.com) and consider it ready for real-world use.
+
+## Why LibPDF?
+
+LibPDF was born from frustration. At [Documenso](https://documenso.com), we found ourselves wrestling with the JavaScript PDF ecosystem:
+
+- **PDF.js** is excellent for rendering and even has annotation editing — but it requires a browser
+- **pdf-lib** has a great API, but chokes on slightly malformed documents
+- **pdfkit** only generates, no parsing at all
+
+We kept adding workarounds. A patch here for a malformed xref table. A hack there for an encrypted document. Eventually, we decided to build what we actually needed:
+
+- **Lenient like PDFBox and PDF.js**: opens documents other libraries reject
+- **Intuitive like pdf-lib**: clean, TypeScript-first API
+- **Complete**: encryption, digital signatures, incremental saves, form filling
+
+## Features
+
+| Feature            | Status | Notes                                      |
+| ------------------ | ------ | ------------------------------------------ |
+| Parse any PDF      | Yes    | Graceful fallback for malformed documents  |
+| Create PDFs        | Yes    | From scratch or modify existing            |
+| Encryption         | Yes    | RC4, AES-128, AES-256 (R2-R6)              |
+| Digital Signatures | Yes    | PAdES B-B, B-T, B-LT, B-LTA                |
+| Form Filling       | Yes    | Text, checkbox, radio, dropdown, signature |
+| Form Flattening    | Yes    | Bake fields into page content              |
+| Merge & Split      | Yes    | Combine or extract pages                   |
+| Attachments        | Yes    | Embed and extract files                    |
+| Text Extraction    | Yes    | With position information                  |
+| Font Embedding     | Yes    | TTF/OpenType with subsetting               |
+| Images             | Yes    | JPEG, PNG (with alpha)                     |
+| Incremental Saves  | Yes    | Append changes, preserve signatures        |
+
+## Installation
+
+```bash
+npm install @libpdf/core
+# or
+bun add @libpdf/core
+```
+
+## Quick Start
+
+### Parse an existing PDF
+
+```typescript
+import { PDF } from "@libpdf/core";
+
+const pdf = await PDF.load(bytes);
+const pages = pdf.getPages();
+
+console.log(`${pages.length} pages`);
+```
+
+### Open an encrypted PDF
+
+```typescript
+const pdf = await PDF.load(bytes, { credentials: "password" });
+```
+
+### Fill a form
+
+```typescript
+const pdf = await PDF.load(bytes);
+const form = pdf.getForm();
+
+form.fill({
+  name: "Jane Doe",
+  email: "jane@example.com",
+  agreed: true,
+});
+
+const filled = await pdf.save();
+```
+
+### Sign a document
+
+```typescript
+import { PDF, P12Signer } from "@libpdf/core";
+
+const pdf = await PDF.load(bytes);
+const signer = await P12Signer.create(p12Bytes, "password");
+
+const signed = await pdf.sign({
+  signer,
+  reason: "I approve this document",
+});
+```
+
+### Merge PDFs
+
+```typescript
+const merged = await PDF.merge([pdf1Bytes, pdf2Bytes, pdf3Bytes]);
+```
+
+### Draw on a page
+
+```typescript
+import { PDF, rgb } from "@libpdf/core";
+
+const pdf = PDF.create();
+const page = pdf.addPage({ size: "letter" });
+
+page.drawText("Hello, World!", {
+  x: 50,
+  y: 700,
+  fontSize: 24,
+  color: rgb(0, 0, 0),
+});
+
+page.drawRectangle({
+  x: 50,
+  y: 600,
+  width: 200,
+  height: 100,
+  color: rgb(0.9, 0.9, 0.9),
+  borderColor: rgb(0, 0, 0),
+  borderWidth: 1,
+});
+
+const output = await pdf.save();
+```
+
+## Runtime Support
+
+LibPDF runs everywhere:
+
+- **Node.js** 20+
+- **Bun**
+- **Browsers** (modern, with Web Crypto)
+
+## Known Limitations
+
+Some features are not yet implemented:
+
+| Feature                     | Status           | Notes                                  |
+| --------------------------- | ---------------- | -------------------------------------- |
+| Signature verification      | Not implemented  | Signing works; verification is planned |
+| TrueType Collections (.ttc) | Not supported    | Extract individual fonts first         |
+| JBIG2 image decoding        | Passthrough only | Images preserved but not decoded       |
+| JPEG2000 (JPX) decoding     | Passthrough only | Images preserved but not decoded       |
+| Certificate encryption      | Not supported    | Password encryption works              |
+| JavaScript actions          | Ignored          | Form calculations not executed         |
+
+These limitations are documented to set expectations. Most don't affect typical use cases like form filling, signing, or document manipulation.
+
+## Philosophy
+
+### Be lenient
+
+Real-world PDFs are messy. Export a document through three different tools and you'll get three slightly different interpretations of the spec. LibPDF prioritizes _opening your document_ over strict compliance. When standard parsing fails, we fall back to brute-force recovery, scanning the entire file to rebuild the structure.
+
+### Two API layers
+
+- **High-level**: `PDF`, `PDFPage`, `PDFForm` for common tasks
+- **Low-level**: `PdfDict`, `PdfArray`, `PdfStream` for full control
+
+## Demo
+
+Run the interactive PDF viewer demo to explore LibPDF's viewing capabilities:
+
+```bash
+bun run demo
+```
+
+See [demo/README.md](demo/README.md) for features and keyboard shortcuts.
+
+## Documentation
+
+Full documentation at [libpdf.dev](https://libpdf.dev)
+
+## Sponsors
+
+LibPDF is developed by [Documenso](https://documenso.com), the open-source DocuSign alternative.
+
+<a href="https://documenso.com">
+  <img src="apps/docs/public/sponsors/documenso.png" alt="Documenso" height="24">
+</a>
+
+## Contributing
+
+We welcome contributions! See our [contributing guide](CONTRIBUTING.md) for details.
+
+```bash
+# Clone the repo
+git clone https://github.com/libpdf/core.git
+cd libpdf
+
+# Install dependencies
+bun install
+
+# Run tests
+bun run test
+
+# Type check
+bun run typecheck
+```
+
+## License
+
+[MIT](LICENSE)
+
+The `src/fontbox/` directory is licensed under [Apache-2.0](src/fontbox/LICENSE) as it is derived from [Apache PDFBox](https://pdfbox.apache.org/).

package/dist/chunk-15K8U1wQ.mjs

@@ -0,0 +1,18 @@
+//#region rolldown:runtime
+var __defProp = Object.defineProperty;
+var __exportAll = (all, symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+export { __exportAll as t };