@firecrawl/pdf-inspector 1.17.0 → 1.18.0

package/README.md

@@ -90,6 +90,28 @@ console.log(result.pagesNeedingOcr) // [5, 12, 15] (0-indexed)
 console.log(result.confidence)     // 0.875
 ```
 
+### `extractTextWithPositions(buffer: Buffer, pages?: number[]): TextItem[]`
+
+Every text item (plus image placeholders, links and form fields) with its font
+and position. `x`/`y` are PDF points relative to the page's **visible page
+box** (`CropBox ∩ MediaBox`, else the MediaBox), origin at the box's lower-left
+corner with `y` growing upward. `extractTextInRegions` reads its regions
+relative to the same box but from its top-left corner with `y` growing
+downward, so flip with the box height: `boxHeight - y`. For text items `y` is
+the baseline and `height` the font size, so
+`[x, boxHeight - y - height, x + width, boxHeight - y]` covers the glyph band
+above the baseline (descenders fall below it); for image, link and form-field
+items `y` is the rect bottom and that box is exact. Pages whose CropBox equals
+the MediaBox at `(0, 0)` are unaffected.
+
+```typescript
+import { extractTextWithPositions } from '@firecrawl/pdf-inspector'
+
+for (const item of extractTextWithPositions(pdf, [1])) { // pages are 1-indexed
+  console.log(item.page, item.text, item.x, item.y, item.fontSize)
+}
+```
+
 ### `extractTextInRegions(buffer: Buffer, pageRegions: PageRegions[]): PageRegionTexts[]`
 
 Extract text within bounding-box regions from a PDF. Designed for hybrid OCR pipelines where a layout model detects regions in rendered page images, and this function extracts text from the PDF structure for text-based pages — skipping GPU OCR.
@@ -103,7 +125,7 @@ const result = extractTextInRegions(pdf, [
   {
     page: 0, // 0-indexed
     regions: [
-      [0, 0, 300, 400],    // [x1, y1, x2, y2] in PDF points, top-left origin
+      [0, 0, 300, 400],    // [x1, y1, x2, y2] in PDF points, top-left origin of the visible page box (CropBox)
       [300, 0, 612, 400],
     ]
   }
@@ -146,7 +168,7 @@ interface PdfClassification {
 
 interface PageRegions {
   page: number              // 0-indexed
-  regions: number[][]       // [[x1, y1, x2, y2], ...] in PDF points, top-left origin
+  regions: number[][]       // [[x1, y1, x2, y2], ...] in PDF points, top-left origin of the visible page box
 }
 
 interface PageRegionTexts {

package/index.d.ts

@@ -25,7 +25,8 @@ export declare function detectPdf(buffer: Buffer): PdfResult
  * `null` when the region does not contain a valid vector grid.
  *
  * `pageIdx` is 0-indexed. `regionPdfPtBbox` is `[x1,y1,x2,y2]` in PDF
- * points with top-left origin. `renderDpi` is the DPI of the crop image that
+ * points with top-left origin, relative to the visible page box (see
+ * `extractTextInRegions`). `renderDpi` is the DPI of the crop image that
  * will consume the returned cell bboxes.
  */
 export declare function detectVectorGridInRegion(buffer: Buffer, pageIdx: number, regionPdfPtBbox: Array<number>, renderDpi: number): VectorGridDetectionJs | null
@@ -80,7 +81,8 @@ export declare function extractStructureElements(buffer: Buffer, pages?: Array<n
  * `needsOcr` is `false`. When no table is found, `text` is empty and
  * `needsOcr` is `true` so the caller can fall back to GPU OCR.
  *
- * Coordinates are PDF points with top-left origin.
+ * Coordinates are PDF points with top-left origin, relative to the visible
+ * page box (see `extractTextInRegions`).
  */
 export declare function extractTablesInRegions(buffer: Buffer, pageRegions: Array<PageRegions>): Array<PageRegionTexts>
 
@@ -136,13 +138,35 @@ export declare function extractText(buffer: Buffer): string
  * Each region result includes `needsOcr` — set when the extracted text
  * is unreliable (empty, GID-encoded fonts, garbage, encoding issues).
  *
- * Coordinates are PDF points with top-left origin.
+ * Coordinates are PDF points with top-left origin, relative to the visible
+ * page box (`CropBox ∩ MediaBox`, else the MediaBox) — the same box
+ * [`extractTextWithPositions`] reports items in, flipped to a top-left
+ * origin: a positioned `y` becomes `boxHeight - y`. For text items `y` is
+ * the baseline, so `[x, boxHeight - y - height, x + width, boxHeight - y]`
+ * covers the glyph band above the baseline; for image, link and form-field
+ * items `y` is the rect bottom and that box is exact.
  */
 export declare function extractTextInRegions(buffer: Buffer, pageRegions: Array<PageRegions>): Array<PageRegionTexts>
 
-/** Extract text with position information from a PDF Buffer. */
+/**
+ * Extract text with position information from a PDF Buffer.
+ *
+ * Items are reported in PDF points relative to the page's visible page box
+ * (`CropBox ∩ MediaBox`, else the MediaBox) with the box's lower-left
+ * corner as origin — see [`TextItem`]. `pages` is 1-indexed (matching
+ * `TextItem.page`); omit it for the whole document.
+ */
 export declare function extractTextWithPositions(buffer: Buffer, pages?: Array<number> | undefined | null): Array<TextItem>
 
+/**
+ * Extract text with positions from a PDF Buffer, together with the
+ * coordinate frame of every page whose text was predominantly rotated.
+ * Items on such a page are expressed in the turned frame (their dominant
+ * runs read left-to-right there); pages absent from `pageRotations` are
+ * upright.
+ */
+export declare function extractTextWithPositionsAndRotations(buffer: Buffer): PositionedText
+
 /** Type of a positioned text item. */
 export declare const enum ItemType {
   Text = 'Text',
@@ -260,7 +284,11 @@ export interface PageOcrReasons {
 /** A page's regions for text extraction: (page_index_0based, bboxes). */
 export interface PageRegions {
   page: number
-  /** Each bbox is [x1, y1, x2, y2] in PDF points, top-left origin. */
+  /**
+   * Each bbox is [x1, y1, x2, y2] in PDF points, top-left origin of the
+   * visible page box (`CropBox ∩ MediaBox`, else the MediaBox) — the
+   * frame of a rendered page image.
+   */
   regions: Array<Array<number>>
 }
 
@@ -270,6 +298,18 @@ export interface PageRegionTexts {
   regions: Array<RegionText>
 }
 
+/** The coordinate frame of a page whose text was predominantly rotated. */
+export interface PageRotation {
+  /** 1-indexed page number, matching `TextItem.page`. */
+  page: number
+  /**
+   * `"ccw"` when the page's runs read bottom-to-top and the frame was
+   * turned so they read left-to-right, `"cw"` for runs reading
+   * top-to-bottom.
+   */
+  rotation: string
+}
+
 /** Combined per-page markdown extraction and layout classification result. */
 export interface PagesExtractionResult {
   /** Per-page markdown results. */
@@ -321,6 +361,16 @@ export declare const enum PdfType {
   Mixed = 'Mixed'
 }
 
+/** Positioned text plus the frame of every page whose text was turned. */
+export interface PositionedText {
+  items: Array<TextItem>
+  /**
+   * One entry per re-based page; pages absent here are upright and their
+   * items are in plain page coordinates.
+   */
+  pageRotations: Array<PageRotation>
+}
+
 /** Process a PDF from a Buffer: detect type, extract text, and convert to Markdown. */
 export declare function processPdf(buffer: Buffer, pages?: Array<number> | undefined | null): PdfResult
 
@@ -366,7 +416,8 @@ export interface StructuredCellJs {
   text: string
   /**
    * Axis-aligned bbox `[x1, y1, x2, y2]` in page PDF-points, top-left
-   * origin. Useful for debug overlays or per-cell post-processing.
+   * origin, relative to the visible page box (the crop's own frame).
+   * Useful for debug overlays or per-cell post-processing.
    */
   pagePtBbox: Array<number>
 }
@@ -405,13 +456,52 @@ export interface TableExtractionResultJs {
   fallbackReason?: string
 }
 
-/** A positioned text item extracted from a PDF. */
+/**
+ * A positioned text item extracted from a PDF.
+ *
+ * `x`/`y` are PDF points relative to the page's **visible page box**
+ * (`CropBox ∩ MediaBox`, else the MediaBox; a CropBox that does not overlap
+ * the MediaBox is ignored, and a page without a MediaBox is measured against
+ * US Letter), origin at the box's lower-left corner with `y` growing upward.
+ * [`extractTextInRegions`] reads its regions relative to the same box but
+ * from its top-left corner with `y` growing downward; flip with the box
+ * height. `/Rotate` is not applied.
+ *
+ * On a page whose text is predominantly rotated the extractor turns the
+ * coordinate frame so that text reads left-to-right, and the shift into the
+ * visible page box is turned the same way; items on such a page are
+ * expressed in that turned frame. Use
+ * [`extract_text_with_positions_and_rotations`] (`extractTextWithPositionsAndRotations`
+ * in JavaScript) to learn which pages were turned and which way.
+ */
 export interface TextItem {
   text: string
+  /** Left edge, in PDF points from the visible page box's left edge. */
   x: number
+  /**
+   * Baseline for text (rect bottom edge for image, link and form-field
+   * items), in PDF points from the visible page box's bottom edge.
+   */
   y: number
   width: number
   height: number
+  /**
+   * Rotation of the run's baseline in degrees counter-clockwise from the
+   * page's x axis, in `[0, 360)`: `0` for ordinary horizontal text, `90`
+   * for text reading bottom-to-top (a rotated margin stamp), `270` for
+   * top-to-bottom, `180` for upside-down. `x`/`y`/`width`/`height` is the
+   * run's axis-aligned box, so a vertical run is tall and thin (height
+   * ≫ width) instead of zero-width.
+   */
+  rotation: number
+  /**
+   * Whether the run's advance came from font metrics. `false` when the
+   * font carries no width information (or an ActualText span's advance
+   * could not be recovered): the box's extent along the baseline is then
+   * an estimate of half an em per painted glyph (an ActualText span counts
+   * the glyphs it covers, not its replacement text), not a measurement.
+   */
+  advanceKnown: boolean
   font: string
   fontTag: string
   fontSize: number
@@ -428,6 +518,15 @@ export interface TextItem {
    * x-height).
    */
   isStrikeout: boolean
+  /**
+   * Signed baseline offset (PDF points, y-up) of a super/subscript glyph
+   * run from the body baseline it is attached to; `0` for normal text.
+   * Positive = raised (superscript: footnote/affiliation markers,
+   * exponents), negative = lowered (subscript). Emit `<sup>`/`<sub>` from
+   * the sign. Digit-only markers beside a word are already fused into it
+   * as Unicode super/subscript characters ("word²") and carry `0`.
+   */
+  baselineShift: number
   itemType: ItemType
   /** URL for link items, `None` for other types. */
   linkUrl?: string
@@ -454,7 +553,8 @@ export interface TsrTableInputJs {
   page: number
   /**
    * Crop bbox on the page, `[x1, y1, x2, y2]` in PDF points with
-   * top-left origin.
+   * top-left origin, relative to the visible page box (see
+   * `extractTextInRegions`).
    */
   cropPdfPtBbox: Array<number>
   /** DPI the crop image was rendered at (e.g. `200.0`). */

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-android-arm64')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-android-arm64/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-android-arm-eabi')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-win32-x64-gnu')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-win32-x64-msvc')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-win32-ia32-msvc')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-win32-arm64-msvc')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('@firecrawl/pdf-inspector-darwin-universal')
       const bindingPackageVersion = require('@firecrawl/pdf-inspector-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-darwin-x64')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-darwin-arm64')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-freebsd-x64')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-freebsd-arm64')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('@firecrawl/pdf-inspector-linux-x64-musl')
           const bindingPackageVersion = require('@firecrawl/pdf-inspector-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('@firecrawl/pdf-inspector-linux-x64-gnu')
           const bindingPackageVersion = require('@firecrawl/pdf-inspector-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('@firecrawl/pdf-inspector-linux-arm64-musl')
           const bindingPackageVersion = require('@firecrawl/pdf-inspector-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('@firecrawl/pdf-inspector-linux-arm64-gnu')
           const bindingPackageVersion = require('@firecrawl/pdf-inspector-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('@firecrawl/pdf-inspector-linux-arm-musleabihf')
           const bindingPackageVersion = require('@firecrawl/pdf-inspector-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('@firecrawl/pdf-inspector-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@firecrawl/pdf-inspector-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('@firecrawl/pdf-inspector-linux-loong64-musl')
           const bindingPackageVersion = require('@firecrawl/pdf-inspector-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('@firecrawl/pdf-inspector-linux-loong64-gnu')
           const bindingPackageVersion = require('@firecrawl/pdf-inspector-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('@firecrawl/pdf-inspector-linux-riscv64-musl')
           const bindingPackageVersion = require('@firecrawl/pdf-inspector-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('@firecrawl/pdf-inspector-linux-riscv64-gnu')
           const bindingPackageVersion = require('@firecrawl/pdf-inspector-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-linux-ppc64-gnu')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-linux-s390x-gnu')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-openharmony-arm64')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-openharmony-x64')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('@firecrawl/pdf-inspector-openharmony-arm')
         const bindingPackageVersion = require('@firecrawl/pdf-inspector-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '1.17.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.17.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.18.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.18.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -590,6 +590,7 @@ module.exports.extractTablesWithStructureCells = nativeBinding.extractTablesWith
 module.exports.extractText = nativeBinding.extractText
 module.exports.extractTextInRegions = nativeBinding.extractTextInRegions
 module.exports.extractTextWithPositions = nativeBinding.extractTextWithPositions
+module.exports.extractTextWithPositionsAndRotations = nativeBinding.extractTextWithPositionsAndRotations
 module.exports.ItemType = nativeBinding.ItemType
 module.exports.OcrMode = nativeBinding.OcrMode
 module.exports.PageContentSource = nativeBinding.PageContentSource

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firecrawl/pdf-inspector",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "Fast PDF classification and text extraction. Detect text-based vs scanned PDFs, extract text by region with quality checks. Native Rust performance via napi-rs.",
   "main": "index.js",
   "types": "index.d.ts",
@@ -52,11 +52,11 @@
     "@napi-rs/cli": "^3.4.1"
   },
   "optionalDependencies": {
-    "@firecrawl/pdf-inspector-linux-x64-gnu": "1.17.0",
-    "@firecrawl/pdf-inspector-linux-x64-musl": "1.17.0",
-    "@firecrawl/pdf-inspector-linux-arm64-gnu": "1.17.0",
-    "@firecrawl/pdf-inspector-linux-arm64-musl": "1.17.0",
-    "@firecrawl/pdf-inspector-darwin-arm64": "1.17.0",
-    "@firecrawl/pdf-inspector-win32-x64-msvc": "1.17.0"
+    "@firecrawl/pdf-inspector-linux-x64-gnu": "1.18.0",
+    "@firecrawl/pdf-inspector-linux-x64-musl": "1.18.0",
+    "@firecrawl/pdf-inspector-linux-arm64-gnu": "1.18.0",
+    "@firecrawl/pdf-inspector-linux-arm64-musl": "1.18.0",
+    "@firecrawl/pdf-inspector-darwin-arm64": "1.18.0",
+    "@firecrawl/pdf-inspector-win32-x64-msvc": "1.18.0"
   }
 }