docs: update API docs to reflect sync operations

Most page and form operations are now synchronous:
- getPage(), getPages(), getForm() are sync
- Form field methods (setValue, check, fill, flatten) are sync
- Text extraction (extractText, findText) is sync
- Annotation methods are sync
- embedFont(), embedImage() are sync
- PDF.create() is sync

Only load() and save() remain async.

Author: Mythie

content/docs/advanced/library-authors.mdx

@@ -156,62 +156,50 @@ try {
 
 ## Async Patterns
 
-### All I/O is Async
+### Loading and Saving are Async
 
-LibPDF uses async/await for all I/O operations:
+LibPDF uses async/await for loading and saving:
 
 ```typescript
 // Loading is async
 const pdf = await PDF.load(bytes);
 
-// Page access is async
-const page = await pdf.getPage(0);
+// Page access is sync
+const page = pdf.getPage(0);
 
-// Text extraction is async
-const text = await page.extractText();
+// Text extraction is sync
+const text = page.extractText();
 
 // Saving is async
 const savedBytes = await pdf.save();
 ```
 
-### Batch Operations
+### Getting Pages
 
-For performance, batch related operations:
+Page access is synchronous:
 
 ```typescript
-// Inefficient: sequential page loading
-const pages: PDFPage[] = [];
-for (let i = 0; i < pdf.getPageCount(); i++) {
-  pages.push(await pdf.getPage(i));
-}
+// Get a single page
+const page = pdf.getPage(0);
 
-// Better: parallel loading
-const pagePromises = [];
-for (let i = 0; i < pdf.getPageCount(); i++) {
-  pagePromises.push(pdf.getPage(i));
-}
-const pages = await Promise.all(pagePromises);
+// Get all pages
+const pages = pdf.getPages();
 
-// Best: use getPages() which is optimized
-const pages = await pdf.getPages();
+// Get page count
+const count = pdf.getPageCount();
 ```
 
-### Streaming Considerations
+### Text Extraction
 
-For large files, consider memory usage:
+Text extraction is synchronous:
 
 ```typescript
-// Process pages one at a time for large documents
-async function extractAllText(pdf: PDF): Promise<string[]> {
+function extractAllText(pdf: PDF): string[] {
   const results: string[] = [];
 
-  for (let i = 0; i < pdf.getPageCount(); i++) {
-    const page = await pdf.getPage(i);
-    if (page) {
-      const text = await page.extractText();
-      results.push(text.text);
-    }
-    // Page can be garbage collected after processing
+  for (const page of pdf.getPages()) {
+    const text = page.extractText();
+    results.push(text.text);
   }
 
   return results;
@@ -227,15 +215,15 @@ For advanced features, access internal APIs.
 Access the raw object storage:
 
 ```typescript
-import { PDF, PdfRef, PdfDict } from "@libpdf/core";
+import { PDF, PdfRef, PdfDict, PdfName } from "@libpdf/core";
 
 const pdf = await PDF.load(bytes);
 
 // Get the registry
 const registry = pdf.context.registry;
 
 // Resolve any reference
-const obj = await registry.resolve(PdfRef.of(5, 0));
+const obj = registry.resolve(PdfRef.of(5, 0));
 
 // Register new objects
 const newDict = PdfDict.of({ Type: PdfName.of("Custom") });
@@ -418,7 +406,7 @@ Here's a complete example of building on LibPDF:
 
 ```typescript
 // pdf-redactor/index.ts
-import { PDF, PDFPage, rgb, type Color } from "@libpdf/core";
+import { PDF, rgb, type Color } from "@libpdf/core";
 
 export interface RedactionOptions {
   color?: Color;
@@ -447,11 +435,13 @@ export async function redactText(
 
   // Process each page with redactions
   for (const [pageIndex, texts] of byPage) {
-    const page = await pdf.getPage(pageIndex);
-    if (!page) continue;
+    const page = pdf.getPage(pageIndex);
+    if (!page) {
+      continue;
+    }
 
     for (const text of texts) {
-      const matches = await page.findText(text);
+      const matches = page.findText(text);
       for (const match of matches) {
         // Draw a filled rectangle over each match
         page.drawRectangle({
@@ -476,7 +466,7 @@ export async function redactText(
 | Dependencies | Peer dependency for libraries, direct for apps |
 | Types        | Preserve generics, don't upcast                |
 | Errors       | Re-export error types, add context             |
-| Async        | Batch operations, consider memory              |
+| Async        | Only load/save are async; page ops are sync    |
 | Low-level    | Use sparingly, document version requirements   |
 | Testing      | Test with real PDFs, cover error cases         |
 | Bundles      | Import only what you need                      |

content/docs/api/annotations.mdx

@@ -15,7 +15,7 @@ PDF annotations add interactive and visual elements to pages - highlights, stick
 ```typescript
 import { PDF, rgb } from "@libpdf/core";
 
-const pdf = await PDF.create();
+const pdf = PDF.create();
 const page = pdf.addPage();
 
 // Add a yellow highlight
@@ -40,18 +40,18 @@ const bytes = await pdf.save();
 
 ```typescript
 const pdf = await PDF.load(existingBytes);
-const page = await pdf.getPage(0);
+const page = pdf.getPage(0);
 
 // Get all annotations
-const annotations = await page.getAnnotations();
+const annotations = page.getAnnotations();
 
 for (const annot of annotations) {
   console.log(annot.type, annot.contents);
 }
 
 // Get specific types
-const highlights = await page.getHighlightAnnotations();
-const links = await page.getLinkAnnotations();
+const highlights = page.getHighlightAnnotations();
+const links = page.getLinkAnnotations();
 ```
 
 ---
@@ -356,7 +356,7 @@ page.addInkAnnotation({
 ## Modifying Annotations
 
 ```typescript
-const highlights = await page.getHighlightAnnotations();
+const highlights = page.getHighlightAnnotations();
 const highlight = highlights[0];
 
 // Update properties
@@ -375,8 +375,8 @@ highlight.setPrintable(true);
 Remove a specific annotation.
 
 ```typescript
-const highlights = await page.getHighlightAnnotations();
-await page.removeAnnotation(highlights[0]);
+const highlights = page.getHighlightAnnotations();
+page.removeAnnotation(highlights[0]);
 ```
 
 ---
@@ -391,10 +391,10 @@ Remove annotations, optionally filtered by type.
 
 ```typescript
 // Remove all highlights
-await page.removeAnnotations({ type: "Highlight" });
+page.removeAnnotations({ type: "Highlight" });
 
 // Remove all annotations
-await page.removeAnnotations();
+page.removeAnnotations();
 ```
 
 ---