Paperdoc Library

https://github.com/paperdoc-dev/paperdoc-lib
Admin
Paperdoc Library is a zero-dependency PHP library for generating, parsing, and converting documents...
Tokens:37,772
Snippets:476
Trust Score:3.9
License:MIT
Update:2 months ago
Show doc for...
Tokens:
Raw
### Install Dependencies and Verify Tests

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/CONTRIBUTING.md

Initial setup commands to install project dependencies and run the test suite.

```bash
# Install dependencies
composer install

# Verify the test suite passes
./vendor/bin/phpunit
```

--------------------------------

### DocumentFactory Usage Examples

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/06-parsers-and-renderers.md

Examples for retrieving a renderer and registering a custom renderer class.

```php
$renderer = DocumentFactory::getRenderer('pdf');
$pdfContent = $renderer->render($doc);
```

```php
DocumentFactory::registerRenderer('custom', MyCustomRenderer::class);
```

--------------------------------

### Usage Example for PostProcessingPipeline

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Demonstrates configuring and running a sequence of post-processors.

```php
$pipeline = new PostProcessingPipeline();
$pipeline->addProcessor(new OcrConfusionCorrector());
$pipeline->addProcessor(new SpellCorrector());

$corrected = $pipeline->process($ocrText);
```

--------------------------------

### ParserFactory Usage Examples

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/06-parsers-and-renderers.md

Examples for retrieving a parser based on filename and registering a custom parser implementation.

```php
$parser = ParserFactory::getParser('report.docx');  // DocxParser
$doc = $parser->parse('report.docx');
```

```php
ParserFactory::registerParser(new MyCustomParser());
```

--------------------------------

### Usage Example for TesseractOcrProcessor

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Demonstrates initializing the processor and executing OCR on an image.

```php
$processor = new TesseractOcrProcessor('/usr/bin/tesseract', ['-l', 'eng+fra']);

if ($processor->isAvailable()) {
    $text = $processor->processImage('scan.jpg', 'eng');
}
```

--------------------------------

### Clone and Setup Repository

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/CONTRIBUTING.md

Commands to clone the repository and configure the upstream remote.

```bash
git clone https://github.com/<your-username>/paperdoc-lib.git
cd paperdoc-lib
```

```bash
git remote add upstream https://github.com/paperdoc-dev/paperdoc-lib.git
```

--------------------------------

### Section Usage Example

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/02-core-document-classes.md

Demonstrates opening sections, adding content, and configuring headers.

```php
$section = $doc->openSection('Intro');
$section->addHeading('Chapter 1', 1);
$section->addParagraph('Content here...');
$section->addPageBreak();

// Add a second section with its own header
$section2 = $doc->openSection('Main');
$section2->setHeader(new RunningElement(...));
```

--------------------------------

### Configure GeminiProvider

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Example configuration array for the Gemini provider.

```php
$config = [
    'provider' => 'gemini',
    'api_key' => env('GEMINI_API_KEY'),
    'model' => 'gemini-1.5-pro',
];
```

--------------------------------

### TextRun Usage Example

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/02-core-document-classes.md

Example of instantiating a TextRun with bold styling and a hyperlink.

```php
$run = new TextRun('Click here', TextStyle::make()->setBold(), new TextLink('https://example.com'));
```

--------------------------------

### Configure OllamaProvider

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Example configuration array for the Ollama provider.

```php
$config = [
    'provider' => 'ollama',
    'base_url' => 'http://localhost:11434',
    'model' => 'llama2',
];
```

--------------------------------

### Document Usage Example

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/02-core-document-classes.md

Demonstrates creating a document, adding content, and saving to a file.

```php
$doc = DocumentManager::create('pdf', 'Report');
$doc->openSection()
    ->addHeading('Introduction', 1)
    ->addText('This is the intro.');
    
DocumentManager::save($doc, 'report.pdf');
```

--------------------------------

### Create and Add CodeBlock

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/04-types-and-enums.md

Example of instantiating a CodeBlock and adding it to a document section.

```php
$code = new CodeBlock('echo "Hello";', 'php');
$section->addElement($code);
```

--------------------------------

### TextLink Usage Example

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/04-types-and-enums.md

Demonstrates creating external and internal links and applying them to a TextRun.

```php
use Paperdoc\Document\Link\TextLink;

// External link
$link1 = TextLink::external('https://example.com');

// Internal link to heading
$link2 = TextLink::internal('section-intro');

$run = new TextRun('Click here', link: $link1);
```

--------------------------------

### Section Page Setup Methods

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/02-core-document-classes.md

Methods for managing per-section page layout properties.

```php
public function getPageSetup(): ?PageSetup
public function setPageSetup(?PageSetup $setup): static
```

--------------------------------

### Configure AnthropicProvider

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Example configuration array for the Anthropic provider.

```php
$config = [
    'provider' => 'anthropic',
    'api_key' => env('ANTHROPIC_API_KEY'),
    'model' => 'claude-3-opus-20240229',
];
```

--------------------------------

### Apply PageSetup to a document section

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/03-styles-and-setup.md

Example demonstrating the fluent configuration of a PageSetup object and applying it to a document section.

```php
$setup = PageSetup::a4('landscape')
    ->setMarginTop(36)
    ->setMarginLeft(54)
    ->setBackgroundColor('#F0F0F0')
    ->setColumnCount(2);

$section = $doc->openSection();
$section->setPageSetup($setup);
```

--------------------------------

### Table Usage Example

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/02-core-document-classes.md

Demonstrates creating a table, setting headers, adding rows, and configuring column widths.

```php
$table = new Table();
$table->setHeaders(['Name', 'Age', 'City']);
$table->addRowFromArray(['Alice', '30', 'NYC']);
$table->addRowFromArray(['Bob', '25', 'LA']);
$table->setColumnWidths([30, 20, 50]);
```

--------------------------------

### Install Paperdoc via Composer

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/10-integration-guide.md

Installs the library package into a Laravel project.

```bash
composer require paperdoc-dev/paperdoc-lib
```

--------------------------------

### Image Usage Example

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/02-core-document-classes.md

Demonstrates creating images from URLs and local files, then adding them to a document section.

```php
// URL reference
$img1 = Image::make('https://example.com/pic.jpg', 200, 150, 'Logo');

// Embedded data
$data = file_get_contents('local.png');
$img2 = Image::fromData($data, 'image/png', 300, 200);

$doc->openSection()->addElement($img2);
```

--------------------------------

### Add a Bookmark to a section

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/04-types-and-enums.md

Example showing how to add a bookmark and a corresponding heading to a section.

```php
$section->addElement(new Bookmark('chapter-1'));
$heading = Heading::make('Chapter 1', 1, 'chapter-1');
$section->addElement($heading);
```

--------------------------------

### Add TextZone to PageSetup

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/03-styles-and-setup.md

Example of adding a TextZone instance to a PageSetup object.

```php
$setup = PageSetup::a4();
$setup->addTextZone(new TextZone(
    x: 400, 
    y: 50, 
    width: 150, 
    height: 50,
    text: 'Page Number',
    style: TextStyle::make()->setBold()
));
```

--------------------------------

### ListBlock Usage Example

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/02-core-document-classes.md

Demonstrates creating a bulleted list and nesting an ordered list within it.

```php
$list = ListBlock::bullet()
    ->addText('Item 1')
    ->addText('Item 2');

$nested = ListBlock::ordered();
$nested->addText('Sub-item 1');
$nested->addText('Sub-item 2');

$list->getItems()[0]->addBlock($nested);
```

--------------------------------

### Define production configuration

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/07-configuration.md

Example of a production-ready configuration file using environment variables for sensitive or environment-specific settings.

```php
// config/paperdoc.php (production)

return [
    'ocr' => [
        'enabled' => env('APP_ENV') === 'production' ? 'auto' : false,
        'language' => env('PAPERDOC_OCR_LANGUAGE', 'eng'),
        'tesseract' => [
            'binary' => '/usr/bin/tesseract-ocr',
            'options' => ['--psm', '3'],
        ],
        'min_text_ratio' => 0.15,
        'post_processing' => [
            'spell_corrector' => ['enabled' => true, 'language' => 'eng'],
            'ocr_confusion_corrector' => ['enabled' => true],
        ],
        'pool_size' => env('APP_ENV') === 'production' ? 8 : 2,
        'process_timeout' => 120,
    ],

    'llm' => [
        'enabled' => env('PAPERDOC_LLM_ENABLED', false),
        'provider' => 'openai',
        'api_key' => env('OPENAI_API_KEY'),
        'model' => 'gpt-4-vision',
        'options' => [
            'temperature' => 0.2,      // More deterministic in production
            'max_tokens' => 2000,
        ],
    ],
];
```

--------------------------------

### Use Paperdoc with Laravel Facade

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Examples of creating, parsing, converting, and rendering documents using the Laravel facade.

```php
use Paperdoc\Facades\Paperdoc;

// Create
$doc = Paperdoc::create('docx', 'Invoice #1042');
$doc->openSection()->addParagraph('Amount due: $500');
Paperdoc::save($doc, storage_path('invoices/1042.docx'));

// Parse an existing file
$doc = Paperdoc::open('uploads/report.xlsx');

// Convert directly
Paperdoc::convert('report.docx', 'report.pdf', 'pdf');

// Render as string
$html = Paperdoc::renderAs($doc, 'html');

// Batch open
$docs = Paperdoc::openBatch([
    'file1.pdf',
    'file2.docx',
    'file3.xlsx',
]);
```

--------------------------------

### Handle UnsupportedFormatException

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/09-exceptions.md

Example of catching an UnsupportedFormatException when requesting an unknown renderer format.

```php
try {
    $renderer = DocumentFactory::getRenderer('unknownformat');
} catch (UnsupportedFormatException $e) {
    echo $e->getMessage();
    // Output: No renderer registered for format "unknownformat"
}
```

--------------------------------

### Instantiate provider using ProviderFactory

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Example usage of the factory to create an LLM provider instance.

```php
$config = [
    'provider' => 'openai',
    'api_key' => 'sk-...',
    'model' => 'gpt-4-vision',
];

$provider = ProviderFactory::make($config);
```

--------------------------------

### Execute Document Conversion via CLI

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/10-integration-guide.md

Examples of running the document conversion command for various file types using the artisan CLI.

```bash
php artisan document:convert scan.pdf output.docx docx
php artisan document:convert report.csv report.xlsx xlsx
php artisan document:convert slides.pptx output.html html
```

--------------------------------

### Link construction examples

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Reference table for constructing different types of links using TextLink::make.

```text
TextLink::make('https://x.com')
TextLink::make('', 'section-2')
TextLink::make('https://x.com', 'sect-2')
TextLink::make('https://x.com', '', 'Open site')
```

--------------------------------

### ParagraphStyle Usage Example

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/03-styles-and-setup.md

Demonstrates configuring a paragraph style fluently and applying it to a new Paragraph instance.

```php
$style = ParagraphStyle::make()
    ->setAlignment(Alignment::JUSTIFY)
    ->setLineSpacing(1.5)
    ->setSpaceBefore(12)
    ->setSpaceAfter(6);

$para = new Paragraph($style);
```

--------------------------------

### Applying PdfProtection to a Document

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/03-styles-and-setup.md

Example of instantiating PdfProtection with specific credentials and permissions, then applying it to a document instance.

```php
$protection = new PdfProtection(
    userPassword: 'user123',
    ownerPassword: 'owner456',
    permissions: PdfProtection::PERMISSION_PRINT | PdfProtection::PERMISSION_COPY
);

$doc->setProtection($protection);
```

--------------------------------

### Use StyleInterface in functions

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/08-contracts-and-interfaces.md

Example of type-hinting a function to accept any object implementing StyleInterface.

```php
function applyStyle(StyleInterface $style) {
    // ...
}
```

--------------------------------

### Use Paperdoc Facade in Laravel

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/08-contracts-and-interfaces.md

Example of using the Paperdoc facade to open and save documents.

```php
use Paperdoc\Facades\Paperdoc;

$doc = Paperdoc::open('report.pdf');
Paperdoc::save($doc, 'output.docx', 'docx');
```

--------------------------------

### Get Pipeline Processors

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Method signature for retrieving the list of registered processors.

```php
public function getProcessors(): array
```

--------------------------------

### Conventional Commit Format

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/CONTRIBUTING.md

Template and examples for writing commit messages following Conventional Commits.

```text
<type>(<scope>): <short description>

[optional body]

[optional footer: Closes #123]
```

```text
feat(renderer): add table border styles to XLSX renderer
fix(parser): handle empty paragraphs in DOCX parser
docs(readme): add batch processing example
test(pdf): add unit tests for PdfRenderer page breaks
```

--------------------------------

### Handle and throw ParserException

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/09-exceptions.md

Examples of catching parsing errors during document operations and manually throwing the exception.

```php
// Automatic in DocumentManager::open()
try {
    $doc = DocumentManager::open('corrupted.pdf');
} catch (ParserException $e) {
    echo $e->getMessage();
    // Output: Failed to parse "corrupted.pdf": Invalid PDF header
}

// Manual creation
throw ParserException::forFile('data.xlsx', 'Missing required worksheet', $previous);
```

--------------------------------

### Catch RendererException

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/09-exceptions.md

Example of catching a RendererException during document saving.

```php
try {
    DocumentManager::save($doc, 'output.pdf', 'pdf');
} catch (RendererException $e) {
    echo $e->getMessage();
    // Output: Failed to render document as "pdf": Font embedding failed
}
```

--------------------------------

### Create a Document in Standalone PHP

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Demonstrates initializing a document, adding a styled section, and saving the output.

```php
use Paperdoc\Support\DocumentManager;
use Paperdoc\Document\Style\TextStyle;

$doc = DocumentManager::create('pdf', 'My Report');

$doc->openSection()
    ->addParagraph('Hello, Paperdoc!', TextStyle::make()->setBold());

DocumentManager::save($doc, 'output/report.pdf');
```

--------------------------------

### Create documents with styles and watermarks in PHP

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Demonstrates initializing a document, applying a watermark, adding a table of contents, and using text styles like strikethrough and highlighting.

```php
use Paperdoc\Document\Style\{TextStyle, Watermark};
use Paperdoc\Enum\Format;
use Paperdoc\Support\DocumentManager;

$doc = DocumentManager::create(Format::PDF, 'Rapport');
$doc->setWatermark(Watermark::make('CONFIDENTIEL')->setOpacity(0.2)->setAngle(-45));

$section = $doc->openSection();
$section->addTableOfContents(maxLevel: 3, title: 'Sommaire'); // clickable in PDF/HTML/MD, native field in DOCX
$section->addElement(\Paperdoc\Document\Heading::make('Introduction', 1));

$section->addText('ancien prix', TextStyle::make()->setStrikethrough());
$section->addText('à retenir', TextStyle::make()->setHighlight('#FFF3B0'));
```

--------------------------------

### Create Image Instances

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/02-core-document-classes.md

Static factory methods for initializing images from URLs or raw binary data.

```php
public static function make(string $src, int $width = 0, int $height = 0, string $alt = ''): static
```

```php
public static function fromData(string $data, string $mimeType, int $width = 0, int $height = 0, string $alt = ''): static
```

--------------------------------

### Handle InvalidDocumentException

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/09-exceptions.md

Example of catching an InvalidDocumentException when providing invalid parameters to a factory method.

```php
try {
    $heading = Heading::make('Title', level: 7);  // Invalid level
} catch (InvalidDocumentException $e) {
    echo $e->getMessage();
    // Output: Invalid heading level 7; expected between 1 and 6.
}
```

--------------------------------

### Initialize Images for Rendering

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Use these methods to handle images from either local disk paths or raw memory bytes. Both methods are supported across all output formats.

```php
Image::make($path)
```

```php
Image::fromData($bytes, $mimeType)
```

--------------------------------

### Handle LlmException transport error

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/09-exceptions.md

Example of displaying an LlmException message for transport failures.

```php
// Automatic (raised by transport layer)
echo $e->getMessage();
// Output: LLM provider "ollama" request failed: Connection refused to http://localhost:11434
```

--------------------------------

### OpenAiProvider::__construct

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Initializes the OpenAI provider with an API key and a specified model.

```APIDOC
## Method: __construct

### Description
Constructs a new instance of the OpenAiProvider to interact with OpenAI models.

### Signature
`public function __construct(string $apiKey, string $model = 'gpt-4-vision')`

### Parameters
- **$apiKey** (string) - Required - The OpenAI API key.
- **$model** (string) - Optional - The model to use (e.g., 'gpt-4-vision', 'gpt-4', 'gpt-3.5-turbo'). Defaults to 'gpt-4-vision'.
```

--------------------------------

### Catch LlmException for HTTP errors

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/09-exceptions.md

Example of catching an LlmException triggered by an HTTP error.

```php
// Automatic (raised by AbstractHttpProvider)
try {
    $text = $augmenter->enhance($ocrText);
} catch (LlmException $e) {
    echo $e->getMessage();
    // Output: LLM provider "openai" returned HTTP 401: {"error": "Invalid API key"}
}
```

--------------------------------

### Manage Bookmark ID

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/04-types-and-enums.md

Methods to get or set the unique anchor ID for the bookmark.

```php
public function getId(): string
public function setId(string $id): static
```

--------------------------------

### convert()

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/01-document-manager.md

Shortcut: opens a source file, converts to target format, and saves in one call.

```APIDOC
## convert(string $sourceFile, string $targetFile, Format|string $targetFormat, array $options = []): void

### Description
Shortcut: opens a source file, converts to target format, and saves in one call.

### Parameters
- **$sourceFile** (string) - Required - Input file path
- **$targetFile** (string) - Required - Output file path
- **$targetFormat** (Format|string) - Required - Output format
- **$options** (array) - Optional - OCR/LLM options (default: [])

### Example
```php
DocumentManager::convert('data.csv', 'output.pdf', 'pdf');
DocumentManager::convert('old.doc', 'new.docx', Format::DOCX, ['ocr' => true]);
```
```

--------------------------------

### Handle LlmException response error

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/09-exceptions.md

Example of displaying an LlmException message for invalid LLM responses.

```php
echo $e->getMessage();
// Output: LLM provider "structured-output" returned an unexpected response: 
//         no valid JSON after 3 attempts: This is not JSON data
```

--------------------------------

### Add text zones

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/03-styles-and-setup.md

Fluent method to add an absolutely-positioned text zone to the page setup.

```php
public function addTextZone(TextZone $zone): static
```

--------------------------------

### Create and save a document in standalone PHP

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/10-integration-guide.md

Initializes a document, adds sections and tables, and saves the output to a file.

```php
<?php

require_once 'vendor/autoload.php';

use Paperdoc\Support\DocumentManager;
use Paperdoc\Enum\Format;
use Paperdoc\Document\Style\TextStyle;

// Create a document
$doc = DocumentManager::create(Format::PDF, 'My Report');

// Add content
$section = $doc->openSection();
$section->addHeading('Introduction', 1);
$section->addParagraph('This is the first paragraph.');
$section->addParagraph('This is the second paragraph.');

// Add a table
$section->addElement($table = new \Paperdoc\Document\Table());
$table->setHeaders(['Name', 'Age', 'City']);
$table->addRowFromArray(['Alice', '30', 'NYC']);
$table->addRowFromArray(['Bob', '25', 'LA']);

// Save
DocumentManager::save($doc, 'output.pdf');
```

--------------------------------

### Manage TableOfContents levels

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/04-types-and-enums.md

Methods to get and set the maximum heading level for the table of contents.

```php
public function getMaxLevel(): int
public function setMaxLevel(int $level): static
```

--------------------------------

### Apply Header to Document

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/03-styles-and-setup.md

Demonstrates creating a section with styled text and assigning it as a document header.

```php
$headerSection = new Section();
$headerSection->addText('Document Title', TextStyle::make()->setBold());

$header = new RunningElement($headerSection);
$doc->setHeader($header);
```

--------------------------------

### OpenAiProvider Configuration

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Defines the OpenAiProvider class constructor and provides a sample configuration array for initialization.

```php
class OpenAiProvider extends AbstractHttpProvider
{
    public function __construct(string $apiKey, string $model = 'gpt-4-vision')
}
```

```php
$config = [
    'provider' => 'openai',
    'api_key' => env('OPENAI_API_KEY'),
    'model' => 'gpt-4-vision',
    'options' => ['temperature' => 0.3],
];
```

--------------------------------

### Get Detected Language

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Returns the language code detected by the manager, or null if detection has not occurred.

```php
public function getDetectedLanguage(): ?string
```

--------------------------------

### Handling Configuration Exceptions

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/09-exceptions.md

Demonstrates catching LlmException when external service configurations or API keys are invalid.

```php
try {
    $doc = DocumentManager::open('scan.pdf', ['ocr' => true, 'language' => 'fra']);
} catch (LlmException $e) {
    // Check OPENAI_API_KEY, model availability, rate limits
}
```

--------------------------------

### Configure Page Geometry and Backgrounds

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Define page size, padding, and background properties for different sections using PageSetup.

```php
use Paperdoc\Document\{Image, Section};
use Paperdoc\Document\Style\PageSetup;
use Paperdoc\Enum\PageSize;

$cover = Section::make('cover')->setPageSetup(
    PageSetup::fromSize(PageSize::A4)
        ->setPadding(0)                                // 1, 2, 3 or 4 values (CSS shorthand)
        ->setBackgroundImage(Image::make('cover.jpg')) // full-bleed image
);

$body = Section::make('body')->setPageSetup(
    PageSetup::fromSize(PageSize::A4, PageSetup::ORIENTATION_LANDSCAPE)
        ->setPadding(50)
        ->setBackgroundColor('#F8F5EC')                // solid color
);

$square = Section::make('back-cover')->setPageSetup(
    PageSetup::custom(500, 500)                        // any width × height in pt
        ->setBackgroundImage(Image::make('back.jpg'))
);
```

--------------------------------

### Handle document generation and parsing in Laravel controllers

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/10-integration-guide.md

Demonstrates creating a document from scratch and parsing an uploaded file with OCR and LLM options.

```php
<?php

namespace App\Http\Controllers;

use Paperdoc\Facades\Paperdoc;
use Paperdoc\Enum\Format;

class ReportController extends Controller
{
    public function generate()
    {
        // Create document
        $doc = Paperdoc::create(Format::PDF, 'Monthly Report');
        
        // Add sections and content
        $section = $doc->openSection();
        $section->addHeading('Sales Summary', 1);
        $section->addParagraph('Total revenue: $50,000');
        
        // Save to storage
        $path = storage_path('reports/monthly.pdf');
        Paperdoc::save($doc, $path);
        
        return response()->download($path);
    }

    public function upload(Request $request)
    {
        // Parse uploaded file
        $file = $request->file('document');
        $path = $file->store('temp');
        
        try {
            $doc = Paperdoc::open(storage_path('app/' . $path), [
                'ocr' => 'auto',
                'llm' => true,
            ]);
            
            // Process document
            $sections = $doc->getSections();
            // ...
            
            return response()->json(['success' => true, 'sections' => count($sections)]);
        } catch (\Paperdoc\Exceptions\PaperdocException $e) {
            return response()->json(['error' => $e->getMessage()], 422);
        }
    }
}
```

--------------------------------

### Document Instance Methods

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/02-core-document-classes.md

Methods for managing document properties, sections, and metadata.

```php
public function getTitle(): string
public function setTitle(string $title): static
```

```php
public function getFormat(): string
```

```php
public function getSections(): array
```

```php
public function addSection(?Section $section = null): static
```

```php
public function openSection(?Section $section = null): Section
```

```php
public function removeSection(int $index): static
```

```php
public function getMetadata(): array
public function setMetadata(string $key, mixed $value): static
```

```php
public function getDefaultTextStyle(): TextStyle
public function setDefaultTextStyle(TextStyle $style): static
```

```php
public function getFirstImage(): ?Image
```

```php
public function getThumbnail(int $maxWidth = 300, int $maxHeight = 300, int $quality = 85): ?array
public function getThumbnailDataUri(int $maxWidth = 300, int $maxHeight = 300, int $quality = 85): ?string
public function getThumbnailBase64(int $maxWidth = 300, int $maxHeight = 300, int $quality = 85): ?string
```

--------------------------------

### Configure Background Image Fitting

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Set the background image size behavior using PageSetup constants.

```php
use Paperdoc\Document\Style\PageSetup;

$page->setPageSetup(
    PageSetup::fromSize(PageSize::A4)
        ->setBackgroundImage(Image::make('hero.jpg'))
        ->setBackgroundSize(PageSetup::BG_SIZE_COVER)   // default
);
```

--------------------------------

### Build a richly-typed document in PHP

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Demonstrates the fluent API for constructing a document with metadata, sections, lists, code blocks, and styled text.

```php
use Paperdoc\Document\{Document, Section, Metadata, ListBlock};
use Paperdoc\Document\Style\TextStyle;

$doc = Document::make('md', 'Release notes v0.5.0')
    ->setProperties(
        Metadata::make()
            ->setAuthor('Alice')
            ->setKeywords('release, changelog, paperdoc')
            ->setLanguage('en-US')
    );

$section = $doc->openSection();

$section->addElement(\Paperdoc\Document\Heading::make('Getting started', 2, 'intro'));

$section->addBulletList()
    ->addText('Install the library')
    ->addText('Run the quick start')
    ->addText('Read the docs');

$section->addCodeBlock("composer require paperdoc-dev/paperdoc-lib", 'bash');

$section->addBookmark('ready-to-go');

$section->addBlockquote()
    ->addText('You are all set.', TextStyle::make()->setItalic());
```

--------------------------------

### Table Instance Methods

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/02-core-document-classes.md

Methods for managing table structure, content, and styling.

```php
public function getType(): string
```

```php
public function addRow(TableRow $row): static
```

```php
public function getRows(): array
```

```php
public function addRowFromArray(array $cells, bool $isHeader = false): TableRow
```

```php
public function setHeaders(array $headers): static
```

```php
public function setColumnWidths(array $widths): static
```

```php
public function getColumnWidths(): array
```

```php
public function getStyle(): ?TableStyle
public function setStyle(TableStyle $style): static
```

```php
public function getColumnCount(): int
```

--------------------------------

### Run Static Analysis

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/CONTRIBUTING.md

Command to execute static analysis on the codebase.

```bash
./vendor/bin/phpstan analyse
```

--------------------------------

### Run Tests

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Executes the project test suite using Composer or PHPUnit directly.

```bash
composer test
# or
./vendor/bin/phpunit
```

--------------------------------

### Exception Handling Best Practices

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/09-exceptions.md

Compares recommended specific exception handling with discouraged silent failure patterns.

```php
// Good
try {
    process($doc);
} catch (LlmException $e) {
    $logger->warning("LLM call failed, continuing without augmentation", [
        'error' => $e->getMessage(),
    ]);
    // Continue without LLM
} catch (PaperdocException $e) {
    $logger->error("Unrecoverable error", ['error' => $e->getMessage()]);
    throw; // Re-throw
}

// Avoid
try {
    process($doc);
} catch (Exception $e) {
    // Silent failure — hard to debug!
}
```

--------------------------------

### Constructing a Post-Processing Pipeline

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Defines the PipelineFactory class structure and demonstrates how to instantiate a pipeline from a configuration array.

```php
class PipelineFactory
{
    public static function fromConfig(array $config): PostProcessingPipeline
}
```

```php
$config = [
    'processors' => [
        'confusion_corrector' => ['enabled' => true],
        'spell_corrector' => ['enabled' => true, 'language' => 'eng'],
    ],
];

$pipeline = PipelineFactory::fromConfig($config);
```

--------------------------------

### Create a new document with DocumentManager

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/01-document-manager.md

Use these methods to initialize a new document object. The format can be specified as a string or via the Format enum.

```php
use Paperdoc\Support\DocumentManager;

$doc = DocumentManager::create('pdf', 'My Report');
$doc->openSection()->addParagraph('Hello, Paperdoc!');
```

```php
use Paperdoc\Support\DocumentManager;
use Paperdoc\Enum\Format;

$doc = DocumentManager::create(Format::DOCX, 'Invoice #42');
```

--------------------------------

### Parse and convert document strings in PHP

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Shows how to convert content between formats or open strings directly without filesystem interaction.

```php
// Parse & convert without touching the filesystem:
$html = DocumentManager::convertString("# Titre\n\nCorps.", 'md', 'html');
$doc  = DocumentManager::openString($csvContent, Format::CSV);
```

--------------------------------

### Configure PageSetup with fluent setters

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/03-styles-and-setup.md

Fluent setter methods for modifying page layout properties.

```php
public function setPageSize(PageSize $v): static
public function setOrientation(string $v): static
public function setMarginTop(float $v): static
public function setMarginBottom(float $v): static
public function setMarginLeft(float $v): static
public function setMarginRight(float $v): static
public function setMargins(float $top, float $bottom, float $left, float $right): static
public function setColumnCount(int $v): static
public function setColumnGap(float $v): static
public function setBackgroundColor(?string $color): static
public function setBackgroundImage(?string $url): static
```

--------------------------------

### Use Format Enum

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/04-types-and-enums.md

Demonstrates retrieving MIME types and resolving formats from file extensions.

```php
use Paperdoc\Enum\Format;

$format = Format::PDF;
echo $format->mimeType();  // 'application/pdf'

$format2 = Format::fromExtension('.docx');  // Format::DOCX
```

--------------------------------

### Define PageSetup class

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/03-styles-and-setup.md

The class definition for PageSetup implementing StyleInterface and JsonSerializable.

```php
final class PageSetup implements StyleInterface, JsonSerializable
```

--------------------------------

### ListItem Static and Instance Methods

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/04-types-and-enums.md

Methods for creating a list item and managing its text runs and nested document blocks.

```php
public static function make(string $text = '', ?TextStyle $style = null, ?TextLink $link = null): static
```

```php
public function addRun(TextRun $run): static
```

```php
public function getRuns(): array
```

```php
public function addBlock(DocumentElementInterface $block): static
```

```php
public function getBlocks(): array
```

```php
public function getPlainText(): string
```

--------------------------------

### Initialize PostProcessingPipeline

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Defines the class structure for the post-processing pipeline.

```php
class PostProcessingPipeline
{
    public function __construct(array $processors = [])
}
```

--------------------------------

### GeminiProvider

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Initializes the Google Gemini LLM provider.

```APIDOC
## GeminiProvider::__construct

### Description
Initializes the Gemini provider with an API key and a specific model.

### Signature
public function __construct(string $apiKey, string $model = 'gemini-1.5-pro')

### Parameters
- **apiKey** (string) - Required - The Gemini API key.
- **model** (string) - Optional - The model identifier (e.g., 'gemini-1.5-pro').
```

--------------------------------

### Configuring Document-wide Headers and Footers

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Configures global headers and footers using RunningElement with support for dynamic placeholders like page numbers and dates.

```php
use Paperdoc\Document\Style\{RunningElement, TextStyle};
use Paperdoc\Enum\Alignment;
use Paperdoc\Support\DocumentManager;

$doc = DocumentManager::create('pdf', 'Quarterly report');

$doc->setHeader(
    RunningElement::make('{title}')
        ->setAlignment(Alignment::LEFT)
        ->setStyle(TextStyle::make()->setFontSize(9)->setItalic()->setColor('#FFFFFF'))
);

$doc->setFooter(
    RunningElement::make('Page {page} / {pages}  ·  {date}')
        ->setAlignment(Alignment::CENTER)
        ->setStyle(TextStyle::make()->setFontSize(9)->setColor('#FFFFFF'))
);
```

--------------------------------

### DocumentManager::create()

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/01-document-manager.md

Creates a new blank document with the specified format and optional title.

```APIDOC
## static DocumentManager::create(Format|string $format, string $title = '')

### Description
Creates a new blank document object.

### Parameters
- **$format** (Format|string) - Required - Document format as Format enum or string (e.g., 'pdf', 'docx', 'html').
- **$title** (string) - Optional - Document title, stored in document metadata.

### Returns
- **DocumentInterface** - A new empty document object.
```

--------------------------------

### CodeBlock Instance Methods

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/04-types-and-enums.md

Methods for managing code content and language metadata.

```php
public function getType(): string
```

```php
public function getCode(): string
public function setCode(string $code): static
```

```php
public function getLanguage(): string
public function setLanguage(string $language): static
```

--------------------------------

### Implement Multi-column Layout

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Configure column count and gap for a section to enable multi-column text flow.

```php
$section->setPageSetup(
    PageSetup::fromSize(PageSize::A4)
        ->setColumnCount(2)
        ->setColumnGap(18.0) // points
);
```

--------------------------------

### Set Tesseract CLI options

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/07-configuration.md

Pass additional command-line arguments to the Tesseract binary.

```php
'options' => [
    '--psm', '3',           // Page segmentation mode
    '--oem', '1',           // OCR engine mode
    '-l', 'eng+fra',        // Multiple languages
    '--dpi', '150',         // DPI override
],
```

--------------------------------

### Retrieve PageSetup properties

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/03-styles-and-setup.md

Getter methods for accessing current page layout configuration.

```php
public function getPageSize(): PageSize
public function getOrientation(): string
public function getMarginTop(): float
public function getMarginBottom(): float
public function getMarginLeft(): float
public function getMarginRight(): float
public function getColumnCount(): int
public function getColumnGap(): float
public function getBackgroundColor(): ?string
public function getBackgroundImage(): ?string
public function getTextZones(): array
```

--------------------------------

### Create a TableRow instance

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/04-types-and-enums.md

Static factory method to initialize a new table row.

```php
public static function make(bool $isHeader = false): static
```

--------------------------------

### Execute Test Suites

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/CONTRIBUTING.md

Commands for running the full test suite or specific test subsets.

```bash
# Run all tests
./vendor/bin/phpunit

# Run a specific suite
./vendor/bin/phpunit --testsuite Unit
./vendor/bin/phpunit --testsuite Integration

# Run a single test file
./vendor/bin/phpunit tests/Unit/Parsers/DocxParserTest.php
```

--------------------------------

### Add programmatic links in PHP

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Illustrates creating a document section and adding text with an associated hyperlink.

```php
use Paperdoc\Support\DocumentManager;
use Paperdoc\Document\Section;
use Paperdoc\Document\Link\TextLink;

$doc = DocumentManager::create('md', 'Release notes');
$section = Section::make('main');

$section->addText(
    'See the full changelog',
    null,
    TextLink::make('https://github.com/paperdoc-dev/paperdoc-lib/blob/main/CHANGELOG.md', '', 'Changelog')
);

$doc->addSection($section);
echo DocumentManager::renderAs($doc, 'md');
// [See the full changelog](https://github.com/paperdoc-dev/paperdoc-lib/blob/main/CHANGELOG.md "Changelog")
```

--------------------------------

### Generate Dynamic Document

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/README.md

Creates a new document instance and adds content programmatically before saving.

```php
$doc = DocumentManager::create('pdf', 'Invoice');
$section = $doc->openSection();
$section->addHeading('Invoice #42', 1);
// ... build content
DocumentManager::save($doc, 'invoice.pdf');
```

--------------------------------

### Document Static Factory Methods

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/02-core-document-classes.md

Methods for creating or hydrating document instances.

```php
public static function make(Format|string $format, string $title = ''): static
```

```php
public static function fromArray(array $data): static
```

```php
public static function fromJson(string $json): static
```

--------------------------------

### Configure LLM API Keys

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/07-configuration.md

Use environment variables to securely set the API key for the chosen LLM provider.

```php
'api_key' => env('OPENAI_API_KEY'),
'api_key' => env('ANTHROPIC_API_KEY'),
'api_key' => env('GEMINI_API_KEY'),
```

--------------------------------

### Standalone PHP Document Management

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/README.md

Demonstrates document creation, saving, format conversion, and parsing using the DocumentManager class.

```php
use Paperdoc\Support\DocumentManager;

// Create
$doc = DocumentManager::create('pdf', 'My Report');
$doc->openSection()
    ->addHeading('Title', 1)
    ->addParagraph('Content here');

// Save
DocumentManager::save($doc, 'report.pdf');

// Convert
DocumentManager::convert('report.pdf', 'report.docx', 'docx');

// Parse
$parsed = DocumentManager::open('existing.pdf');
```

--------------------------------

### Initialize TesseractOcrProcessor

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Defines the class structure for the Tesseract OCR processor.

```php
class TesseractOcrProcessor implements OcrProcessorInterface
{
    public function __construct(string $binary = 'tesseract', array $options = [])
}
```

--------------------------------

### ListBlock Static Factory Methods

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/02-core-document-classes.md

Static methods for instantiating ListBlock instances.

```php
public static function make(string $style = self::STYLE_BULLET, int $start = 1): static
```

```php
public static function bullet(): static
```

```php
public static function ordered(int $start = 1): static
```

--------------------------------

### Run Pipeline Processing

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Method signature for executing all processors sequentially on text.

```php
public function process(string $text): string
```

--------------------------------

### Convert files with convert()

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/01-document-manager.md

Performs file-to-file conversion in a single call. Supports optional OCR or LLM configuration via the options array.

```php
DocumentManager::convert('data.csv', 'output.pdf', 'pdf');
DocumentManager::convert('old.doc', 'new.docx', Format::DOCX, ['ocr' => true]);
```

--------------------------------

### Handling Format Parsing Exceptions

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/09-exceptions.md

Demonstrates catching ParserException when document formats are incompatible with requested options like OCR.

```php
try {
    $doc = DocumentManager::open('presentation.pptx', ['ocr' => true]);
} catch (ParserException $e) {
    // OCR doesn't apply to PPTX; may be unused images
}
```

--------------------------------

### DocumentManager::open()

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/01-document-manager.md

Opens and parses an existing document file, supporting OCR and LLM augmentation.

```APIDOC
## static DocumentManager::open(string $filename, array $options = [])

### Description
Opens and parses an existing document file. Supports OCR and LLM augmentation for scanned documents.

### Parameters
- **$filename** (string) - Required - Path to the document file.
- **$options** (array) - Optional - Associative array with keys: 'ocr' (bool|'auto'), 'llm' (bool), 'language' (string).

### Returns
- **DocumentInterface** - Parsed document object.

### Throws
- **ParserException** - If the file cannot be read or has an unsupported format.
```

--------------------------------

### Configure Tesseract binary path

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/07-configuration.md

Define the location of the Tesseract executable using system paths or absolute paths.

```php
'binary' => 'tesseract',              // System PATH
'binary' => '/usr/bin/tesseract',     // Absolute path
'binary' => 'C:\\Program Files\\Tesseract\\tesseract.exe', // Windows
```

--------------------------------

### Positioning TextZones and Handling Overflow

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Demonstrates adding text zones with specific coordinates, background colors, borders, and overflow strategies like ellipsis.

```php
use Paperdoc\Document\TextZone;
use Paperdoc\Document\Style\{ParagraphStyle, TextStyle};
use Paperdoc\Enum\Alignment;

$cover->addTextZone(x: 40, y: 40, width: 515, height: 90)
    ->setBackgroundColor('#0B1437')
    ->setBorder('#FFFFFF', 0.8)
    ->setPadding(16)
    ->addText(
        'Paperdoc — Cover title',
        TextStyle::make()->setBold()->setFontSize(20)->setColor('#FFFFFF'),
        ParagraphStyle::make()->setAlignment(Alignment::LEFT),
    );

// Long lorem with the ellipsis strategy: text is truncated to fit
// exactly the visible height and the last visible line ends with "…".
$cover->addTextZone(x: 40, y: 160, width: 250, height: 260)
    ->setPadding(12)
    ->setBackgroundColor('#FFFFFF')
    ->setBorder('#1F2937', 0.5)
    ->setOverflow(TextZone::OVERFLOW_ELLIPSIS)
    ->addText($veryLongText,
        TextStyle::make()->setFontSize(10)->setColor('#111827'),
        ParagraphStyle::make()->setLineSpacing(1.25),
    );
```

--------------------------------

### Manage Post-Processing Pipeline

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Methods to set and retrieve the post-processing pipeline.

```php
public function setPipeline(?PostProcessingPipeline $pipeline): void
public function getPipeline(): ?PostProcessingPipeline
```

--------------------------------

### Run Static Analysis

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/README.md

Performs static analysis on the source code using PHPStan.

```bash
composer phpstan
```

--------------------------------

### Implement OCR Pipeline with Logging

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/10-integration-guide.md

Encapsulates document parsing with OCR and LLM augmentation. Includes fallback logic for LLM failures and error logging for parsing exceptions.

```php
<?php

class OcrPipeline
{
    public function __construct(private Logger $logger) {}

    public function process(string $filePath): DocumentInterface
    {
        $this->logger->info('Starting OCR', ['file' => $filePath]);

        try {
            // Step 1: Parse with OCR enabled
            $this->logger->debug('Opening file with OCR');
            $doc = DocumentManager::open($filePath, [
                'ocr' => true,
                'language' => 'auto',
            ]);

            // Step 2: Check OCR success
            $section = $doc->getSections()[0] ?? null;
            if ($section && $section->getMetadata('ocr_processed')) {
                $this->logger->info('OCR completed successfully');
            }

            // Step 3: Optional LLM enhancement
            if (config('paperdoc.llm.enabled')) {
                $this->logger->debug('Applying LLM enhancement');
                // DocumentManager handles this internally if configured
            }

            return $doc;

        } catch (LlmException $e) {
            $this->logger->warning('LLM failed, continuing without augmentation', [
                'error' => $e->getMessage(),
            ]);
            
            // Fallback: re-parse without LLM
            return DocumentManager::open($filePath, [
                'ocr' => true,
                'llm' => false,
            ]);

        } catch (ParserException $e) {
            $this->logger->error('Failed to parse document', [
                'file' => $filePath,
                'error' => $e->getMessage(),
            ]);
            throw;
        }
    }
}

// Usage
$pipeline = new OcrPipeline($logger);
$doc = $pipeline->process('scan.pdf');
```

--------------------------------

### Sync and Branching Commands

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/CONTRIBUTING.md

Commands to synchronize with the upstream repository and create a new feature branch.

```bash
git fetch upstream
git checkout develop
git merge upstream/develop
```

```bash
git checkout -b feature/xlsx-table-styling
```

--------------------------------

### Section Static Factory Methods

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/02-core-document-classes.md

Methods for creating new Section instances.

```php
public static function make(string $name = ''): static
```

```php
public static function fromArray(array $data): static
```

--------------------------------

### Open and parse documents with DocumentManager

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/01-document-manager.md

Methods for loading existing files, including options for OCR and LLM processing.

```php
$doc = DocumentManager::open('report.pdf');
```

```php
$doc = DocumentManager::open('scan.pdf', [
    'ocr' => true,
    'llm' => true,
    'language' => 'fra'
]);
```

--------------------------------

### Create common page sizes

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/03-styles-and-setup.md

Convenience static methods for initializing common paper sizes with optional orientation.

```php
public static function a4(?string $orientation = null): static
public static function letter(?string $orientation = null): static
public static function a5(?string $orientation = null): static
```

--------------------------------

### Initialize OcrManager

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Constructor for the OcrManager class, defining the processor, language settings, and processing constraints.

```php
class OcrManager
{
    public function __construct(
        OcrProcessorInterface $processor,
        string $language = 'auto',
        float $minTextRatio = 0.1,
        ?PostProcessingPipeline $pipeline = null,
        int $poolSize = 0,
        int $processTimeout = 60,
    )
}
```

--------------------------------

### Render document to string with renderAs()

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/01-document-manager.md

Use to generate document content in a specific format without disk I/O. Requires a DocumentInterface instance.

```php
$html = DocumentManager::renderAs($doc, 'html');
$markdown = DocumentManager::renderAs($doc, Format::MD);
```

--------------------------------

### Export to Multiple Formats

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/README.md

Saves a single opened document instance into multiple output formats sequentially.

```php
$doc = DocumentManager::open('data.xlsx');
DocumentManager::save($doc, 'data.pdf', 'pdf');
DocumentManager::save($doc, 'data.docx', 'docx');
DocumentManager::save($doc, 'data.html', 'html');
```

--------------------------------

### Retrieve Processor Instance

Source: https://github.com/paperdoc-dev/paperdoc-lib/blob/main/_autodocs/05-llm-ocr-api.md

Returns the underlying OCR processor instance.

```php
public function getProcessor(): OcrProcessorInterface
```
Tokens:
Raw