format: apply repo prettier (3.8.1) to the folded skills tree

963 markdown files reformatted with the repository's pinned prettier so pnpm format:check covers the folded tree like every other repo file. The formatter's embedded-language pass also normalized code fences (TS semicolons, closed HTML tags in examples, lowercased CSS hex colors, one renumbered list that skipped an index). Alphanumeric token deltas vs the fold commit were audited file-by-file; all are formatter-equivalent markup normalizations plus the four sanitized skills.
2026-08-19 14:37:17 -05:00
parent d2eeb64433
commit 1a822493ba
962 changed files with 29594 additions and 27188 deletions
@@ -30,6 +30,7 @@ for page in reader.pages:
 ### pypdf - Basic Operations

 #### Merge PDFs
+
 ```python
 from pypdf import PdfWriter, PdfReader

@@ -44,6 +45,7 @@ with open("merged.pdf", "wb") as output:
 ```

 #### Split PDF
+
 ```python
 reader = PdfReader("input.pdf")
 for i, page in enumerate(reader.pages):
@@ -54,6 +56,7 @@ for i, page in enumerate(reader.pages):
 ```

 #### Extract Metadata
+
 ```python
 reader = PdfReader("document.pdf")
 meta = reader.metadata
@@ -64,6 +67,7 @@ print(f"Creator: {meta.creator}")
 ```

 #### Rotate Pages
+
 ```python
 reader = PdfReader("input.pdf")
 writer = PdfWriter()
@@ -79,6 +83,7 @@ with open("rotated.pdf", "wb") as output:
 ### pdfplumber - Text and Table Extraction

 #### Extract Text with Layout
+
 ```python
 import pdfplumber

@@ -89,6 +94,7 @@ with pdfplumber.open("document.pdf") as pdf:
 ```

 #### Extract Tables
+
 ```python
 with pdfplumber.open("document.pdf") as pdf:
    for i, page in enumerate(pdf.pages):
@@ -100,6 +106,7 @@ with pdfplumber.open("document.pdf") as pdf:
 ```

 #### Advanced Table Extraction
+
 ```python
 import pandas as pd

@@ -121,6 +128,7 @@ if all_tables:
 ### reportlab - Create PDFs

 #### Basic PDF Creation
+
 ```python
 from reportlab.lib.pagesizes import letter
 from reportlab.pdfgen import canvas
@@ -140,6 +148,7 @@ c.save()
 ```

 #### Create PDF with Multiple Pages
+
 ```python
 from reportlab.lib.pagesizes import letter
 from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, PageBreak
@@ -171,6 +180,7 @@ doc.build(story)
 **IMPORTANT**: Never use Unicode subscript/superscript characters (₀₁₂₃₄₅₆₇₈₉, ⁰¹²³⁴⁵⁶⁷⁸⁹) in ReportLab PDFs. The built-in fonts do not include these glyphs, causing them to render as solid black boxes.

 Instead, use ReportLab's XML markup tags in Paragraph objects:
+
 ```python
 from reportlab.platypus import Paragraph
 from reportlab.lib.styles import getSampleStyleSheet
@@ -189,6 +199,7 @@ For canvas-drawn text (not Paragraph objects), manually adjust font the size and
 ## Command-Line Tools

 ### pdftotext (poppler-utils)
+
 ```bash
 # Extract text
 pdftotext input.pdf output.txt
@@ -201,6 +212,7 @@ pdftotext -f 1 -l 5 input.pdf output.txt  # Pages 1-5
 ```

 ### qpdf
+
 ```bash
 # Merge PDFs
 qpdf --empty --pages file1.pdf file2.pdf -- merged.pdf
@@ -217,6 +229,7 @@ qpdf --password=mypassword --decrypt encrypted.pdf decrypted.pdf
 ```

 ### pdftk (if available)
+
 ```bash
 # Merge
 pdftk file1.pdf file2.pdf cat output merged.pdf
@@ -231,6 +244,7 @@ pdftk input.pdf rotate 1east output rotated.pdf
 ## Common Tasks

 ### Extract Text from Scanned PDFs
+
 ```python
 # Requires: pip install pytesseract pdf2image
 import pytesseract
@@ -250,6 +264,7 @@ print(text)
 ```

 ### Add Watermark
+
 ```python
 from pypdf import PdfReader, PdfWriter

@@ -269,6 +284,7 @@ with open("watermarked.pdf", "wb") as output:
 ```

 ### Extract Images
+
 ```bash
 # Using pdfimages (poppler-utils)
 pdfimages -j input.pdf output_prefix
@@ -277,6 +293,7 @@ pdfimages -j input.pdf output_prefix
 ```

 ### Password Protection
+
 ```python
 from pypdf import PdfReader, PdfWriter

@@ -295,16 +312,16 @@ with open("encrypted.pdf", "wb") as output:

 ## Quick Reference

-| Task | Best Tool | Command/Code |
-|------|-----------|--------------|
-| Merge PDFs | pypdf | `writer.add_page(page)` |
-| Split PDFs | pypdf | One page per file |
-| Extract text | pdfplumber | `page.extract_text()` |
-| Extract tables | pdfplumber | `page.extract_tables()` |
-| Create PDFs | reportlab | Canvas or Platypus |
-| Command line merge | qpdf | `qpdf --empty --pages ...` |
-| OCR scanned PDFs | pytesseract | Convert to image first |
-| Fill PDF forms | pdf-lib or pypdf (see FORMS.md) | See FORMS.md |
+| Task               | Best Tool                       | Command/Code               |
+| ------------------ | ------------------------------- | -------------------------- |
+| Merge PDFs         | pypdf                           | `writer.add_page(page)`    |
+| Split PDFs         | pypdf                           | One page per file          |
+| Extract text       | pdfplumber                      | `page.extract_text()`      |
+| Extract tables     | pdfplumber                      | `page.extract_tables()`    |
+| Create PDFs        | reportlab                       | Canvas or Platypus         |
+| Command line merge | qpdf                            | `qpdf --empty --pages ...` |
+| OCR scanned PDFs   | pytesseract                     | Convert to image first     |
+| Fill PDF forms     | pdf-lib or pypdf (see FORMS.md) | See FORMS.md               |

 ## Next Steps

@@ -1,11 +1,14 @@
 **CRITICAL: You MUST complete these steps in order. Do not skip ahead to writing code.**

 If you need to fill out a PDF form, first check to see if the PDF has fillable form fields. Run this script from this file's directory:
- `python scripts/check_fillable_fields <file.pdf>`, and depending on the result go to either the "Fillable fields" or "Non-fillable fields" and follow those instructions.
+`python scripts/check_fillable_fields <file.pdf>`, and depending on the result go to either the "Fillable fields" or "Non-fillable fields" and follow those instructions.

 # Fillable fields
+
 If the PDF has fillable form fields:
+
 - Run this script from this file's directory: `python scripts/extract_form_field_info.py <input.pdf> <field_info.json>`. It will create a JSON file with a list of fields in this format:
+
 ```
 [
  {
@@ -50,10 +53,12 @@ If the PDF has fillable form fields:
  }
 ]
 ```
+
 - Convert the PDF to PNGs (one image for each page) with this script (run from this file's directory):
-`python scripts/convert_pdf_to_images.py <file.pdf> <output_directory>`
-Then analyze the images to determine the purpose of each form field (make sure to convert the bounding box PDF coordinates to image coordinates).
+  `python scripts/convert_pdf_to_images.py <file.pdf> <output_directory>`
+  Then analyze the images to determine the purpose of each form field (make sure to convert the bounding box PDF coordinates to image coordinates).
 - Create a `field_values.json` file in this format with the values to be entered for each field:
+
 ```
 [
  {
@@ -71,11 +76,13 @@ Then analyze the images to determine the purpose of each form field (make sure t
  // more fields
 ]
 ```
+
 - Run the `fill_fillable_fields.py` script from this file's directory to create a filled-in PDF:
-`python scripts/fill_fillable_fields.py <input pdf> <field_values.json> <output pdf>`
-This script will verify that the field IDs and values you provide are valid; if it prints error messages, correct the appropriate fields and try again.
+  `python scripts/fill_fillable_fields.py <input pdf> <field_values.json> <output pdf>`
+  This script will verify that the field IDs and values you provide are valid; if it prints error messages, correct the appropriate fields and try again.

 # Non-fillable fields
+
 If the PDF doesn't have fillable form fields, you'll add text annotations. First try to extract coordinates from the PDF structure (more accurate), then fall back to visual estimation if needed.

 ## Step 1: Try Structure Extraction First
@@ -84,6 +91,7 @@ Run this script to extract text labels, lines, and checkboxes with their exact P
 `python scripts/extract_form_structure.py <input.pdf> form_structure.json`

 This creates a JSON file containing:
+
 - **labels**: Every text element with exact coordinates (x0, top, x1, bottom in PDF points)
 - **lines**: Horizontal lines that define row boundaries
 - **checkboxes**: Small square rectangles that are checkboxes (with center coordinates)
@@ -111,6 +119,7 @@ Read form_structure.json and identify:
 ### A.2: Check for Missing Elements

 The structure extraction may not detect all form elements. Common cases:
+
 - **Circular checkboxes**: Only square rectangles are detected as checkboxes
 - **Complex graphics**: Decorative elements or non-standard form controls
 - **Faded or light-colored elements**: May not be extracted
@@ -122,21 +131,22 @@ If you see form fields in the PDF images that aren't in form_structure.json, you
 For each field, calculate entry coordinates from the extracted structure:

 **Text fields:**
+
 - entry x0 = label x1 + 5 (small gap after label)
 - entry x1 = next label's x0, or row boundary
 - entry top = same as label top
 - entry bottom = row boundary line below, or label bottom + row_height

 **Checkboxes:**
+
 - Use the checkbox rectangle coordinates directly from form_structure.json
 - entry_bounding_box = [checkbox.x0, checkbox.top, checkbox.x1, checkbox.bottom]

 Create fields.json using `pdf_width` and `pdf_height` (signals PDF coordinates):
+
 ```json
 {
-  "pages": [
-    {"page_number": 1, "pdf_width": 612, "pdf_height": 792}
-  ],
+  "pages": [{ "page_number": 1, "pdf_width": 612, "pdf_height": 792 }],
  "form_fields": [
    {
      "page_number": 1,
@@ -144,7 +154,7 @@ Create fields.json using `pdf_width` and `pdf_height` (signals PDF coordinates):
      "field_label": "Last Name",
      "label_bounding_box": [43, 63, 87, 73],
      "entry_bounding_box": [92, 63, 260, 79],
-      "entry_text": {"text": "Smith", "font_size": 10}
+      "entry_text": { "text": "Smith", "font_size": 10 }
    },
    {
      "page_number": 1,
@@ -152,7 +162,7 @@ Create fields.json using `pdf_width` and `pdf_height` (signals PDF coordinates):
      "field_label": "Yes",
      "label_bounding_box": [260, 200, 280, 210],
      "entry_bounding_box": [285, 197, 292, 205],
-      "entry_text": {"text": "X"}
+      "entry_text": { "text": "X" }
    }
  ]
 }
@@ -180,6 +190,7 @@ Use this when the PDF is scanned/image-based and structure extraction found no u
 ### B.2: Initial Field Identification

 Examine each page image to identify form sections and get **rough estimates** of field locations:
+
 - Form field labels and their approximate positions
 - Entry areas (lines, boxes, or blank spaces for text input)
 - Checkboxes and their approximate locations
@@ -191,15 +202,18 @@ For each field, note approximate pixel coordinates (they don't need to be precis
 For each field, crop a region around the estimated position to refine coordinates precisely.

 **Create a zoomed crop using ImageMagick:**
+
 ```bash
 magick <page_image> -crop <width>x<height>+<x>+<y> +repage <crop_output.png>
 ```

 Where:
+
 - `<x>, <y>` = top-left corner of crop region (use your rough estimate minus padding)
 - `<width>, <height>` = size of crop region (field area plus ~50px padding on each side)

 **Example:** To refine a "Name" field estimated around (100, 150):
+
 ```bash
 magick images_dir/page_1.png -crop 300x80+50+120 +repage crops/name_field.png
 ```
@@ -207,15 +221,18 @@ magick images_dir/page_1.png -crop 300x80+50+120 +repage crops/name_field.png
 (Note: if the `magick` command isn't available, try `convert` with the same arguments).

 **Examine the cropped image** to determine precise coordinates:
+
 1. Identify the exact pixel where the entry area begins (after the label)
 2. Identify where the entry area ends (before next field or edge)
 3. Identify the top and bottom of the entry line/box

 **Convert crop coordinates back to full image coordinates:**
+
 - full_x = crop_x + crop_offset_x
 - full_y = crop_y + crop_offset_y

 Example: If the crop started at (50, 120) and the entry box starts at (52, 18) within the crop:
+
 - entry_x0 = 52 + 50 = 102
 - entry_top = 18 + 120 = 138

@@ -224,11 +241,10 @@ Example: If the crop started at (50, 120) and the entry box starts at (52, 18) w
 ### B.4: Create fields.json with Refined Coordinates

 Create fields.json using `image_width` and `image_height` (signals image coordinates):
+
 ```json
 {
-  "pages": [
-    {"page_number": 1, "image_width": 1700, "image_height": 2200}
-  ],
+  "pages": [{ "page_number": 1, "image_width": 1700, "image_height": 2200 }],
  "form_fields": [
    {
      "page_number": 1,
@@ -236,7 +252,7 @@ Create fields.json using `image_width` and `image_height` (signals image coordin
      "field_label": "Last Name",
      "label_bounding_box": [120, 175, 242, 198],
      "entry_bounding_box": [255, 175, 720, 218],
-      "entry_text": {"text": "Smith", "font_size": 10}
+      "entry_text": { "text": "Smith", "font_size": 10 }
    }
  ]
 }
@@ -261,8 +277,8 @@ Use this when structure extraction works for most fields but misses some element
 2. **Convert PDF to images** for visual analysis of missing fields
 3. **Use zoom refinement** (from Approach B) for the missing fields
 4. **Combine coordinates**: For fields from structure extraction, use `pdf_width`/`pdf_height`. For visually-estimated fields, you must convert image coordinates to PDF coordinates:
-   - pdf_x = image_x * (pdf_width / image_width)
-   - pdf_y = image_y * (pdf_height / image_height)
+   - pdf_x = image_x \* (pdf_width / image_width)
+   - pdf_y = image_y \* (pdf_height / image_height)
 5. **Use a single coordinate system** in fields.json - convert all to PDF coordinates with `pdf_width`/`pdf_height`

 ---
@@ -273,6 +289,7 @@ Use this when structure extraction works for most fields but misses some element
 `python scripts/check_bounding_boxes.py fields.json`

 This checks for:
+
 - Intersecting bounding boxes (which would cause overlapping text)
 - Entry boxes that are too small for the specified font size

@@ -289,6 +306,7 @@ Convert the filled PDF to images and verify text placement:
 `python scripts/convert_pdf_to_images.py <output.pdf> <verify_images/>`

 If text is mispositioned:
+
 - **Approach A**: Check that you're using PDF coordinates from form_structure.json with `pdf_width`/`pdf_height`
 - **Approach B**: Check that image dimensions match and coordinates are accurate pixels
 - **Hybrid**: Ensure coordinate conversions are correct for visually-estimated fields
@@ -5,9 +5,11 @@ This document contains advanced PDF processing features, detailed examples, and
 ## pypdfium2 Library (Apache/BSD License)

 ### Overview
+
 pypdfium2 is a Python binding for PDFium (Chromium's PDF library). It's excellent for fast PDF rendering, image generation, and serves as a PyMuPDF replacement.

 ### Render PDF to Images
+
 ```python
 import pypdfium2 as pdfium
 from PIL import Image
@@ -34,6 +36,7 @@ for i, page in enumerate(pdf):
 ```

 ### Extract Text with pypdfium2
+
 ```python
 import pypdfium2 as pdfium

@@ -50,120 +53,123 @@ for i, page in enumerate(pdf):
 pdf-lib is a powerful JavaScript library for creating and modifying PDF documents in any JavaScript environment.

 #### Load and Manipulate Existing PDF
+
 ```javascript
 import { PDFDocument } from 'pdf-lib';
 import fs from 'fs';

 async function manipulatePDF() {
-    // Load existing PDF
-    const existingPdfBytes = fs.readFileSync('input.pdf');
-    const pdfDoc = await PDFDocument.load(existingPdfBytes);
+  // Load existing PDF
+  const existingPdfBytes = fs.readFileSync('input.pdf');
+  const pdfDoc = await PDFDocument.load(existingPdfBytes);

-    // Get page count
-    const pageCount = pdfDoc.getPageCount();
-    console.log(`Document has ${pageCount} pages`);
+  // Get page count
+  const pageCount = pdfDoc.getPageCount();
+  console.log(`Document has ${pageCount} pages`);

-    // Add new page
-    const newPage = pdfDoc.addPage([600, 400]);
-    newPage.drawText('Added by pdf-lib', {
-        x: 100,
-        y: 300,
-        size: 16
-    });
+  // Add new page
+  const newPage = pdfDoc.addPage([600, 400]);
+  newPage.drawText('Added by pdf-lib', {
+    x: 100,
+    y: 300,
+    size: 16,
+  });

-    // Save modified PDF
-    const pdfBytes = await pdfDoc.save();
-    fs.writeFileSync('modified.pdf', pdfBytes);
+  // Save modified PDF
+  const pdfBytes = await pdfDoc.save();
+  fs.writeFileSync('modified.pdf', pdfBytes);
 }
 ```

 #### Create Complex PDFs from Scratch
+
 ```javascript
 import { PDFDocument, rgb, StandardFonts } from 'pdf-lib';
 import fs from 'fs';

 async function createPDF() {
-    const pdfDoc = await PDFDocument.create();
+  const pdfDoc = await PDFDocument.create();

-    // Add fonts
-    const helveticaFont = await pdfDoc.embedFont(StandardFonts.Helvetica);
-    const helveticaBold = await pdfDoc.embedFont(StandardFonts.HelveticaBold);
+  // Add fonts
+  const helveticaFont = await pdfDoc.embedFont(StandardFonts.Helvetica);
+  const helveticaBold = await pdfDoc.embedFont(StandardFonts.HelveticaBold);

-    // Add page
-    const page = pdfDoc.addPage([595, 842]); // A4 size
-    const { width, height } = page.getSize();
+  // Add page
+  const page = pdfDoc.addPage([595, 842]); // A4 size
+  const { width, height } = page.getSize();

-    // Add text with styling
-    page.drawText('Invoice #12345', {
-        x: 50,
-        y: height - 50,
-        size: 18,
-        font: helveticaBold,
-        color: rgb(0.2, 0.2, 0.8)
+  // Add text with styling
+  page.drawText('Invoice #12345', {
+    x: 50,
+    y: height - 50,
+    size: 18,
+    font: helveticaBold,
+    color: rgb(0.2, 0.2, 0.8),
+  });
+
+  // Add rectangle (header background)
+  page.drawRectangle({
+    x: 40,
+    y: height - 100,
+    width: width - 80,
+    height: 30,
+    color: rgb(0.9, 0.9, 0.9),
+  });
+
+  // Add table-like content
+  const items = [
+    ['Item', 'Qty', 'Price', 'Total'],
+    ['Widget', '2', '$50', '$100'],
+    ['Gadget', '1', '$75', '$75'],
+  ];
+
+  let yPos = height - 150;
+  items.forEach((row) => {
+    let xPos = 50;
+    row.forEach((cell) => {
+      page.drawText(cell, {
+        x: xPos,
+        y: yPos,
+        size: 12,
+        font: helveticaFont,
+      });
+      xPos += 120;
    });
+    yPos -= 25;
+  });

-    // Add rectangle (header background)
-    page.drawRectangle({
-        x: 40,
-        y: height - 100,
-        width: width - 80,
-        height: 30,
-        color: rgb(0.9, 0.9, 0.9)
-    });
-
-    // Add table-like content
-    const items = [
-        ['Item', 'Qty', 'Price', 'Total'],
-        ['Widget', '2', '$50', '$100'],
-        ['Gadget', '1', '$75', '$75']
-    ];
-
-    let yPos = height - 150;
-    items.forEach(row => {
-        let xPos = 50;
-        row.forEach(cell => {
-            page.drawText(cell, {
-                x: xPos,
-                y: yPos,
-                size: 12,
-                font: helveticaFont
-            });
-            xPos += 120;
-        });
-        yPos -= 25;
-    });
-
-    const pdfBytes = await pdfDoc.save();
-    fs.writeFileSync('created.pdf', pdfBytes);
+  const pdfBytes = await pdfDoc.save();
+  fs.writeFileSync('created.pdf', pdfBytes);
 }
 ```

 #### Advanced Merge and Split Operations
+
 ```javascript
 import { PDFDocument } from 'pdf-lib';
 import fs from 'fs';

 async function mergePDFs() {
-    // Create new document
-    const mergedPdf = await PDFDocument.create();
+  // Create new document
+  const mergedPdf = await PDFDocument.create();

-    // Load source PDFs
-    const pdf1Bytes = fs.readFileSync('doc1.pdf');
-    const pdf2Bytes = fs.readFileSync('doc2.pdf');
+  // Load source PDFs
+  const pdf1Bytes = fs.readFileSync('doc1.pdf');
+  const pdf2Bytes = fs.readFileSync('doc2.pdf');

-    const pdf1 = await PDFDocument.load(pdf1Bytes);
-    const pdf2 = await PDFDocument.load(pdf2Bytes);
+  const pdf1 = await PDFDocument.load(pdf1Bytes);
+  const pdf2 = await PDFDocument.load(pdf2Bytes);

-    // Copy pages from first PDF
-    const pdf1Pages = await mergedPdf.copyPages(pdf1, pdf1.getPageIndices());
-    pdf1Pages.forEach(page => mergedPdf.addPage(page));
+  // Copy pages from first PDF
+  const pdf1Pages = await mergedPdf.copyPages(pdf1, pdf1.getPageIndices());
+  pdf1Pages.forEach((page) => mergedPdf.addPage(page));

-    // Copy specific pages from second PDF (pages 0, 2, 4)
-    const pdf2Pages = await mergedPdf.copyPages(pdf2, [0, 2, 4]);
-    pdf2Pages.forEach(page => mergedPdf.addPage(page));
+  // Copy specific pages from second PDF (pages 0, 2, 4)
+  const pdf2Pages = await mergedPdf.copyPages(pdf2, [0, 2, 4]);
+  pdf2Pages.forEach((page) => mergedPdf.addPage(page));

-    const mergedPdfBytes = await mergedPdf.save();
-    fs.writeFileSync('merged.pdf', mergedPdfBytes);
+  const mergedPdfBytes = await mergedPdf.save();
+  fs.writeFileSync('merged.pdf', mergedPdfBytes);
 }
 ```

@@ -172,6 +178,7 @@ async function mergePDFs() {
 PDF.js is Mozilla's JavaScript library for rendering PDFs in the browser.

 #### Basic PDF Loading and Rendering
+
 ```javascript
 import * as pdfjsLib from 'pdfjs-dist';

@@ -179,86 +186,86 @@ import * as pdfjsLib from 'pdfjs-dist';
 pdfjsLib.GlobalWorkerOptions.workerSrc = './pdf.worker.js';

 async function renderPDF() {
-    // Load PDF
-    const loadingTask = pdfjsLib.getDocument('document.pdf');
-    const pdf = await loadingTask.promise;
+  // Load PDF
+  const loadingTask = pdfjsLib.getDocument('document.pdf');
+  const pdf = await loadingTask.promise;

-    console.log(`Loaded PDF with ${pdf.numPages} pages`);
+  console.log(`Loaded PDF with ${pdf.numPages} pages`);

-    // Get first page
-    const page = await pdf.getPage(1);
-    const viewport = page.getViewport({ scale: 1.5 });
+  // Get first page
+  const page = await pdf.getPage(1);
+  const viewport = page.getViewport({ scale: 1.5 });

-    // Render to canvas
-    const canvas = document.createElement('canvas');
-    const context = canvas.getContext('2d');
-    canvas.height = viewport.height;
-    canvas.width = viewport.width;
+  // Render to canvas
+  const canvas = document.createElement('canvas');
+  const context = canvas.getContext('2d');
+  canvas.height = viewport.height;
+  canvas.width = viewport.width;

-    const renderContext = {
-        canvasContext: context,
-        viewport: viewport
-    };
+  const renderContext = {
+    canvasContext: context,
+    viewport: viewport,
+  };

-    await page.render(renderContext).promise;
-    document.body.appendChild(canvas);
+  await page.render(renderContext).promise;
+  document.body.appendChild(canvas);
 }
 ```

 #### Extract Text with Coordinates
+
 ```javascript
 import * as pdfjsLib from 'pdfjs-dist';

 async function extractText() {
-    const loadingTask = pdfjsLib.getDocument('document.pdf');
-    const pdf = await loadingTask.promise;
+  const loadingTask = pdfjsLib.getDocument('document.pdf');
+  const pdf = await loadingTask.promise;

-    let fullText = '';
+  let fullText = '';

-    // Extract text from all pages
-    for (let i = 1; i <= pdf.numPages; i++) {
-        const page = await pdf.getPage(i);
-        const textContent = await page.getTextContent();
+  // Extract text from all pages
+  for (let i = 1; i <= pdf.numPages; i++) {
+    const page = await pdf.getPage(i);
+    const textContent = await page.getTextContent();

-        const pageText = textContent.items
-            .map(item => item.str)
-            .join(' ');
+    const pageText = textContent.items.map((item) => item.str).join(' ');

-        fullText += `\n--- Page ${i} ---\n${pageText}`;
+    fullText += `\n--- Page ${i} ---\n${pageText}`;

-        // Get text with coordinates for advanced processing
-        const textWithCoords = textContent.items.map(item => ({
-            text: item.str,
-            x: item.transform[4],
-            y: item.transform[5],
-            width: item.width,
-            height: item.height
-        }));
-    }
+    // Get text with coordinates for advanced processing
+    const textWithCoords = textContent.items.map((item) => ({
+      text: item.str,
+      x: item.transform[4],
+      y: item.transform[5],
+      width: item.width,
+      height: item.height,
+    }));
+  }

-    console.log(fullText);
-    return fullText;
+  console.log(fullText);
+  return fullText;
 }
 ```

 #### Extract Annotations and Forms
+
 ```javascript
 import * as pdfjsLib from 'pdfjs-dist';

 async function extractAnnotations() {
-    const loadingTask = pdfjsLib.getDocument('annotated.pdf');
-    const pdf = await loadingTask.promise;
+  const loadingTask = pdfjsLib.getDocument('annotated.pdf');
+  const pdf = await loadingTask.promise;

-    for (let i = 1; i <= pdf.numPages; i++) {
-        const page = await pdf.getPage(i);
-        const annotations = await page.getAnnotations();
+  for (let i = 1; i <= pdf.numPages; i++) {
+    const page = await pdf.getPage(i);
+    const annotations = await page.getAnnotations();

-        annotations.forEach(annotation => {
-            console.log(`Annotation type: ${annotation.subtype}`);
-            console.log(`Content: ${annotation.contents}`);
-            console.log(`Coordinates: ${JSON.stringify(annotation.rect)}`);
-        });
-    }
+    annotations.forEach((annotation) => {
+      console.log(`Annotation type: ${annotation.subtype}`);
+      console.log(`Content: ${annotation.contents}`);
+      console.log(`Coordinates: ${JSON.stringify(annotation.rect)}`);
+    });
+  }
 }
 ```

@@ -267,6 +274,7 @@ async function extractAnnotations() {
 ### poppler-utils Advanced Features

 #### Extract Text with Bounding Box Coordinates
+
 ```bash
 # Extract text with bounding box coordinates (essential for structured data)
 pdftotext -bbox-layout document.pdf output.xml
@@ -275,6 +283,7 @@ pdftotext -bbox-layout document.pdf output.xml
 ```

 #### Advanced Image Conversion
+
 ```bash
 # Convert to PNG images with specific resolution
 pdftoppm -png -r 300 document.pdf output_prefix
@@ -287,6 +296,7 @@ pdftoppm -jpeg -jpegopt quality=85 -r 200 document.pdf jpeg_output
 ```

 #### Extract Embedded Images
+
 ```bash
 # Extract all embedded images with metadata
 pdfimages -j -p document.pdf page_images
@@ -301,6 +311,7 @@ pdfimages -all document.pdf images/img
 ### qpdf Advanced Features

 #### Complex Page Manipulation
+
 ```bash
 # Split PDF into groups of pages
 qpdf --split-pages=3 input.pdf output_group_%02d.pdf
@@ -313,6 +324,7 @@ qpdf --empty --pages doc1.pdf 1-3 doc2.pdf 5-7 doc3.pdf 2,4 -- combined.pdf
 ```

 #### PDF Optimization and Repair
+
 ```bash
 # Optimize PDF for web (linearize for streaming)
 qpdf --linearize input.pdf optimized.pdf
@@ -329,6 +341,7 @@ qpdf --show-all-pages input.pdf > structure.txt
 ```

 #### Advanced Encryption
+
 ```bash
 # Add password protection with specific permissions
 qpdf --encrypt user_pass owner_pass 256 --print=none --modify=none -- input.pdf encrypted.pdf
@@ -345,29 +358,31 @@ qpdf --password=secret123 --decrypt encrypted.pdf decrypted.pdf
 ### pdfplumber Advanced Features

 #### Extract Text with Precise Coordinates
+
 ```python
 import pdfplumber

 with pdfplumber.open("document.pdf") as pdf:
    page = pdf.pages[0]
-    
+
    # Extract all text with coordinates
    chars = page.chars
    for char in chars[:10]:  # First 10 characters
        print(f"Char: '{char['text']}' at x:{char['x0']:.1f} y:{char['y0']:.1f}")
-    
+
    # Extract text by bounding box (left, top, right, bottom)
    bbox_text = page.within_bbox((100, 100, 400, 200)).extract_text()
 ```

 #### Advanced Table Extraction with Custom Settings
+
 ```python
 import pdfplumber
 import pandas as pd

 with pdfplumber.open("complex_table.pdf") as pdf:
    page = pdf.pages[0]
-    
+
    # Extract tables with custom settings for complex layouts
    table_settings = {
        "vertical_strategy": "lines",
@@ -376,7 +391,7 @@ with pdfplumber.open("complex_table.pdf") as pdf:
        "intersection_tolerance": 15
    }
    tables = page.extract_tables(table_settings)
-    
+
    # Visual debugging for table extraction
    img = page.to_image(resolution=150)
    img.save("debug_layout.png")
@@ -385,6 +400,7 @@ with pdfplumber.open("complex_table.pdf") as pdf:
 ### reportlab Advanced Features

 #### Create Professional Reports with Tables
+
 ```python
 from reportlab.platypus import SimpleDocTemplate, Table, TableStyle, Paragraph
 from reportlab.lib.styles import getSampleStyleSheet
@@ -428,12 +444,14 @@ doc.build(elements)
 ### Extract Figures/Images from PDF

 #### Method 1: Using pdfimages (fastest)
+
 ```bash
 # Extract all images with original quality
 pdfimages -all document.pdf images/img
 ```

 #### Method 2: Using pypdfium2 + Image Processing
+
 ```python
 import pypdfium2 as pdfium
 from PIL import Image
@@ -441,26 +459,27 @@ import numpy as np

 def extract_figures(pdf_path, output_dir):
    pdf = pdfium.PdfDocument(pdf_path)
-    
+
    for page_num, page in enumerate(pdf):
        # Render high-resolution page
        bitmap = page.render(scale=3.0)
        img = bitmap.to_pil()
-        
+
        # Convert to numpy for processing
        img_array = np.array(img)
-        
+
        # Simple figure detection (non-white regions)
        mask = np.any(img_array != [255, 255, 255], axis=2)
-        
+
        # Find contours and extract bounding boxes
        # (This is simplified - real implementation would need more sophisticated detection)
-        
+
        # Save detected figures
        # ... implementation depends on specific needs
 ```

 ### Batch PDF Processing with Error Handling
+
 ```python
 import os
 import glob
@@ -472,7 +491,7 @@ logger = logging.getLogger(__name__)

 def batch_process_pdfs(input_dir, operation='merge'):
    pdf_files = glob.glob(os.path.join(input_dir, "*.pdf"))
-    
+
    if operation == 'merge':
        writer = PdfWriter()
        for pdf_file in pdf_files:
@@ -484,10 +503,10 @@ def batch_process_pdfs(input_dir, operation='merge'):
            except Exception as e:
                logger.error(f"Failed to process {pdf_file}: {e}")
                continue
-        
+
        with open("batch_merged.pdf", "wb") as output:
            writer.write(output)
-    
+
    elif operation == 'extract_text':
        for pdf_file in pdf_files:
            try:
@@ -495,18 +514,19 @@ def batch_process_pdfs(input_dir, operation='merge'):
                text = ""
                for page in reader.pages:
                    text += page.extract_text()
-                
+
                output_file = pdf_file.replace('.pdf', '.txt')
                with open(output_file, 'w', encoding='utf-8') as f:
                    f.write(text)
                logger.info(f"Extracted text from: {pdf_file}")
-                
+
            except Exception as e:
                logger.error(f"Failed to extract text from {pdf_file}: {e}")
                continue
 ```

 ### Advanced PDF Cropping
+
 ```python
 from pypdf import PdfWriter, PdfReader

@@ -528,37 +548,42 @@ with open("cropped.pdf", "wb") as output:
 ## Performance Optimization Tips

 ### 1. For Large PDFs
+
 - Use streaming approaches instead of loading entire PDF in memory
 - Use `qpdf --split-pages` for splitting large files
 - Process pages individually with pypdfium2

 ### 2. For Text Extraction
+
 - `pdftotext -bbox-layout` is fastest for plain text extraction
 - Use pdfplumber for structured data and tables
 - Avoid `pypdf.extract_text()` for very large documents

 ### 3. For Image Extraction
+
 - `pdfimages` is much faster than rendering pages
 - Use low resolution for previews, high resolution for final output

 ### 4. For Form Filling
+
 - pdf-lib maintains form structure better than most alternatives
 - Pre-validate form fields before processing

 ### 5. Memory Management
+
 ```python
 # Process PDFs in chunks
 def process_large_pdf(pdf_path, chunk_size=10):
    reader = PdfReader(pdf_path)
    total_pages = len(reader.pages)
-    
+
    for start_idx in range(0, total_pages, chunk_size):
        end_idx = min(start_idx + chunk_size, total_pages)
        writer = PdfWriter()
-        
+
        for i in range(start_idx, end_idx):
            writer.add_page(reader.pages[i])
-        
+
        # Process chunk
        with open(f"chunk_{start_idx//chunk_size}.pdf", "wb") as output:
            writer.write(output)
@@ -567,6 +592,7 @@ def process_large_pdf(pdf_path, chunk_size=10):
 ## Troubleshooting Common Issues

 ### Encrypted PDFs
+
 ```python
 # Handle password-protected PDFs
 from pypdf import PdfReader
@@ -580,6 +606,7 @@ except Exception as e:
 ```

 ### Corrupted PDFs
+
 ```bash
 # Use qpdf to repair
 qpdf --check corrupted.pdf
@@ -587,6 +614,7 @@ qpdf --replace-input corrupted.pdf
 ```

 ### Text Extraction Issues
+
 ```python
 # Fallback to OCR for scanned PDFs
 import pytesseract
@@ -609,4 +637,4 @@ def extract_text_with_ocr(pdf_path):
 - **poppler-utils**: GPL-2 License
 - **qpdf**: Apache License
 - **pdf-lib**: MIT License
- **pdfjs-dist**: Apache License
+- **pdfjs-dist**: Apache License