@ironsoftware/ironpdf 2026.4.1 → 2026.5.1

package/src/public/render.d.ts

@@ -1,6 +1,72 @@
 import { PdfPaperOrientation, PdfPaperSize } from "./paper";
 import { HtmlAffix, TextAffix } from "./affix";
 import { CssMediaType, FitToPaperModes, MarginConfig, UseMargins, TableOfContentsTypes } from "./types";
+/**
+ * Represents the rendered location of an HTML element within a PDF document.
+ *
+ * Returned by {@code PdfDocument.getElementLocations()} after rendering HTML with
+ * {@link ChromePdfRenderOptions.elementQuerySelectors} configured.
+ *
+ * Mirrors {@code IronPdf.RenderedElementLocation} on the C# side.
+ */
+export interface RenderedElementLocation {
+    /**
+     * The text content of the matched element.
+     */
+    text: string;
+    /**
+     * The zero-based page index where the element was rendered.
+     */
+    pageIndex: number;
+    /**
+     * The bounding rectangle of the annotation marker on the page, in PDF points (1/72 inch).
+     * Coordinate origin is the bottom-left corner of the page. The rectangle corresponds to
+     * the injected anchor marker placed at the start of the matched element.
+     */
+    rectangle: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /**
+     * The original index of the element in document order among all matched elements.
+     */
+    elementIndex: number;
+}
+/**
+ * Specifies the linearization strategy to use when producing a linearized
+ * (web-optimized) PDF.
+ *
+ * Mirrors {@code IronPdf.LinearizationMode} on the C# side.
+ */
+export declare enum LinearizationMode {
+    /**
+     * Automatically selects the optimal linearization method based on system capabilities.
+     *
+     * Behavior:
+     *   1. First attempts {@link FileBased} linearization.
+     *   2. If disk access is restricted (e.g. limited permissions, sandboxed environment),
+     *      automatically falls back to {@link InMemory}.
+     *
+     * Recommended default for most applications.
+     */
+    Automatic = 0,
+    /**
+     * Performs linearization entirely in memory without any disk I/O operations.
+     *
+     * Use when:
+     *   - Compliance requirements mandate zero disk I/O (e.g. HIPAA, PCI-DSS)
+     *   - Sandboxed or restricted environments without disk write permissions
+     *   - Cloud-based environments where disk I/O introduces latency
+     */
+    InMemory = 1,
+    /**
+     * Performs linearization using temporary file operations on disk.
+     * Requires write permissions to the system temporary directory.
+     */
+    FileBased = 2
+}
 /**
  * Html or Url To PDF output options for {@link PdfGenerator} and {@link PdfDocument} static method.
  * Specify options such as Paper-Size, DPI and other Chromium specific browser setup options.
@@ -101,6 +167,44 @@ export interface ChromePdfRenderOptions {
      *  @default {@link UseMargins.LeftAndRight}
      */
     useMarginsOnHeaderAndFooter?: UseMargins | undefined;
+    /**
+     * If true, auto-generate PDF outline (bookmarks) from the HTML heading structure.
+     * Use {@link autoBookmarkMinHeadingLevel} / {@link autoBookmarkMaxHeadingLevel} to control
+     * which heading levels are included (1 = h1, 6 = h6). Use {@link autoBookmarkCssSelectors}
+     * to include additional non-heading elements (e.g. {@code ".chapter-title"}).
+     *
+     * @default false
+     */
+    autoBookmarksFromHeadings?: boolean | undefined;
+    /**
+     * Minimum heading level (inclusive) to include in auto-generated bookmarks.
+     * Only used when {@link autoBookmarksFromHeadings} is true.
+     *
+     * @default 1
+     */
+    autoBookmarkMinHeadingLevel?: number | undefined;
+    /**
+     * Maximum heading level (inclusive) to include in auto-generated bookmarks.
+     * Only used when {@link autoBookmarksFromHeadings} is true.
+     *
+     * @default 6
+     */
+    autoBookmarkMaxHeadingLevel?: number | undefined;
+    /**
+     * Additional CSS selectors whose matching elements will be included as auto-bookmarks
+     * (in addition to the heading range). Only used when {@link autoBookmarksFromHeadings} is true.
+     * Example: {@code [".chapter-title", "[data-bookmark]"]}.
+     */
+    autoBookmarkCssSelectors?: string[] | undefined;
+    /**
+     * CSS selectors whose matching HTML elements should be tracked during rendering so their
+     * rendered page positions can later be retrieved by the engine.
+     *
+     * <b>Note:</b> retrieval of the per-element locations from the Node client is not yet
+     * supported. Setting this option still enables engine-side tracking (and any downstream
+     * effects such as auto-bookmarks for those selectors).
+     */
+    elementQuerySelectors?: string[] | undefined;
 }
 /**
  *  A managed wrapper of wait-for configurations. see {@link ChromePdfRenderOptions.waitFor}

package/src/public/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["render.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["render.ts"],"names":[],"mappings":"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"}

package/src/public/render.js

@@ -1,8 +1,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultChromePdfRenderOptions = exports.WaitForType = void 0;
+exports.defaultChromePdfRenderOptions = exports.WaitForType = exports.LinearizationMode = void 0;
 const paper_1 = require("./paper");
 const types_1 = require("./types");
+/**
+ * Specifies the linearization strategy to use when producing a linearized
+ * (web-optimized) PDF.
+ *
+ * Mirrors {@code IronPdf.LinearizationMode} on the C# side.
+ */
+var LinearizationMode;
+(function (LinearizationMode) {
+    /**
+     * Automatically selects the optimal linearization method based on system capabilities.
+     *
+     * Behavior:
+     *   1. First attempts {@link FileBased} linearization.
+     *   2. If disk access is restricted (e.g. limited permissions, sandboxed environment),
+     *      automatically falls back to {@link InMemory}.
+     *
+     * Recommended default for most applications.
+     */
+    LinearizationMode[LinearizationMode["Automatic"] = 0] = "Automatic";
+    /**
+     * Performs linearization entirely in memory without any disk I/O operations.
+     *
+     * Use when:
+     *   - Compliance requirements mandate zero disk I/O (e.g. HIPAA, PCI-DSS)
+     *   - Sandboxed or restricted environments without disk write permissions
+     *   - Cloud-based environments where disk I/O introduces latency
+     */
+    LinearizationMode[LinearizationMode["InMemory"] = 1] = "InMemory";
+    /**
+     * Performs linearization using temporary file operations on disk.
+     * Requires write permissions to the system temporary directory.
+     */
+    LinearizationMode[LinearizationMode["FileBased"] = 2] = "FileBased";
+})(LinearizationMode = exports.LinearizationMode || (exports.LinearizationMode = {}));
 /**
  * A wait-for type. see {@link ChromePdfRenderOptions.waitFor} also {@link WaitFor}
  */

package/src/public/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["render.ts"],"names":[],"mappings":";;;AAAA,mCAAuE;AAEvE,mCAMiB;AAwHjB;;GAEG;AACH,IAAY,WAQX;AARD,WAAY,WAAW;IACtB,oCAAqB,CAAA;IACrB,wCAAyB,CAAA;IACzB,0CAA2B,CAAA;IAC3B,4CAA6B,CAAA;IAC7B,4CAA6B,CAAA;IAC7B,4CAA6B,CAAA;IAC7B,0CAA2B,CAAA;AAC5B,CAAC,EARW,WAAW,GAAX,mBAAW,KAAX,mBAAW,QAQtB;AAiGD,SAAgB,6BAA6B;IACrC,OAAO;QACC,YAAY,EAAE,oBAAY,CAAC,KAAK;QAChC,gBAAgB,EAAE,IAAI;QACtB,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,4BAAoB,CAAC,IAAI;QAC1C,cAAc,EAAE,uBAAe,CAAC,OAAO;QACrD,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,OAAO;QACtB,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;QAChD,SAAS,EAAE,iBAAS,CAAC,EAAE;QACvB,gBAAgB,EAAE,2BAAmB,CAAC,QAAQ;QAC9C,oBAAoB,EAAE,IAAI;QAC1B,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE;QACrD,uBAAuB;QACvB,wBAAwB;QACxB,aAAa;QACb,sBAAsB,EAAE,IAAI;QACd,YAAY,EAAE,EAAE;QAChB,2BAA2B,EAAE,kBAAU,CAAC,GAAG;KAClD,CAAC;AACV,CAAC;AArBD,sEAqBC"}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["render.ts"],"names":[],"mappings":";;;AAAA,mCAAuE;AAEvE,mCAMiB;AA+BjB;;;;;GAKG;AACH,IAAY,iBA0BX;AA1BD,WAAY,iBAAiB;IAC5B;;;;;;;;;OASG;IACH,mEAAa,CAAA;IACb;;;;;;;OAOG;IACH,iEAAY,CAAA;IACZ;;;OAGG;IACH,mEAAa,CAAA;AACd,CAAC,EA1BW,iBAAiB,GAAjB,yBAAiB,KAAjB,yBAAiB,QA0B5B;AA8JD;;GAEG;AACH,IAAY,WAQX;AARD,WAAY,WAAW;IACtB,oCAAqB,CAAA;IACrB,wCAAyB,CAAA;IACzB,0CAA2B,CAAA;IAC3B,4CAA6B,CAAA;IAC7B,4CAA6B,CAAA;IAC7B,4CAA6B,CAAA;IAC7B,0CAA2B,CAAA;AAC5B,CAAC,EARW,WAAW,GAAX,mBAAW,KAAX,mBAAW,QAQtB;AAiGD,SAAgB,6BAA6B;IACrC,OAAO;QACC,YAAY,EAAE,oBAAY,CAAC,KAAK;QAChC,gBAAgB,EAAE,IAAI;QACtB,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,4BAAoB,CAAC,IAAI;QAC1C,cAAc,EAAE,uBAAe,CAAC,OAAO;QACrD,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,OAAO;QACtB,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;QAChD,SAAS,EAAE,iBAAS,CAAC,EAAE;QACvB,gBAAgB,EAAE,2BAAmB,CAAC,QAAQ;QAC9C,oBAAoB,EAAE,IAAI;QAC1B,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE;QACrD,uBAAuB;QACvB,wBAAwB;QACxB,aAAa;QACb,sBAAsB,EAAE,IAAI;QACd,YAAY,EAAE,EAAE;QAChB,2BAA2B,EAAE,kBAAU,CAAC,GAAG;KAClD,CAAC;AACV,CAAC;AArBD,sEAqBC"}

package/src/public/render.ts

@@ -8,6 +8,69 @@ import {
         TableOfContentsTypes,
 } from "./types";
 
+/**
+ * Represents the rendered location of an HTML element within a PDF document.
+ *
+ * Returned by {@code PdfDocument.getElementLocations()} after rendering HTML with
+ * {@link ChromePdfRenderOptions.elementQuerySelectors} configured.
+ *
+ * Mirrors {@code IronPdf.RenderedElementLocation} on the C# side.
+ */
+export interface RenderedElementLocation {
+	/**
+	 * The text content of the matched element.
+	 */
+	text: string;
+	/**
+	 * The zero-based page index where the element was rendered.
+	 */
+	pageIndex: number;
+	/**
+	 * The bounding rectangle of the annotation marker on the page, in PDF points (1/72 inch).
+	 * Coordinate origin is the bottom-left corner of the page. The rectangle corresponds to
+	 * the injected anchor marker placed at the start of the matched element.
+	 */
+	rectangle: { x: number; y: number; width: number; height: number };
+	/**
+	 * The original index of the element in document order among all matched elements.
+	 */
+	elementIndex: number;
+}
+ 
+/**
+ * Specifies the linearization strategy to use when producing a linearized
+ * (web-optimized) PDF.
+ *
+ * Mirrors {@code IronPdf.LinearizationMode} on the C# side.
+ */
+export enum LinearizationMode {
+	/**
+	 * Automatically selects the optimal linearization method based on system capabilities.
+	 *
+	 * Behavior:
+	 *   1. First attempts {@link FileBased} linearization.
+	 *   2. If disk access is restricted (e.g. limited permissions, sandboxed environment),
+	 *      automatically falls back to {@link InMemory}.
+	 *
+	 * Recommended default for most applications.
+	 */
+	Automatic = 0,
+	/**
+	 * Performs linearization entirely in memory without any disk I/O operations.
+	 *
+	 * Use when:
+	 *   - Compliance requirements mandate zero disk I/O (e.g. HIPAA, PCI-DSS)
+	 *   - Sandboxed or restricted environments without disk write permissions
+	 *   - Cloud-based environments where disk I/O introduces latency
+	 */
+	InMemory = 1,
+	/**
+	 * Performs linearization using temporary file operations on disk.
+	 * Requires write permissions to the system temporary directory.
+	 */
+	FileBased = 2,
+}
+
 /**
  * Html or Url To PDF output options for {@link PdfGenerator} and {@link PdfDocument} static method.
  * Specify options such as Paper-Size, DPI and other Chromium specific browser setup options.
@@ -112,6 +175,44 @@ export interface ChromePdfRenderOptions {
 	 *  @default {@link UseMargins.LeftAndRight}
 	 */
 	useMarginsOnHeaderAndFooter?: UseMargins | undefined;
+	/**
+	 * If true, auto-generate PDF outline (bookmarks) from the HTML heading structure.
+	 * Use {@link autoBookmarkMinHeadingLevel} / {@link autoBookmarkMaxHeadingLevel} to control
+	 * which heading levels are included (1 = h1, 6 = h6). Use {@link autoBookmarkCssSelectors}
+	 * to include additional non-heading elements (e.g. {@code ".chapter-title"}).
+	 *
+	 * @default false
+	 */
+	autoBookmarksFromHeadings?: boolean | undefined;
+	/**
+	 * Minimum heading level (inclusive) to include in auto-generated bookmarks.
+	 * Only used when {@link autoBookmarksFromHeadings} is true.
+	 *
+	 * @default 1
+	 */
+	autoBookmarkMinHeadingLevel?: number | undefined;
+	/**
+	 * Maximum heading level (inclusive) to include in auto-generated bookmarks.
+	 * Only used when {@link autoBookmarksFromHeadings} is true.
+	 *
+	 * @default 6
+	 */
+	autoBookmarkMaxHeadingLevel?: number | undefined;
+	/**
+	 * Additional CSS selectors whose matching elements will be included as auto-bookmarks
+	 * (in addition to the heading range). Only used when {@link autoBookmarksFromHeadings} is true.
+	 * Example: {@code [".chapter-title", "[data-bookmark]"]}.
+	 */
+	autoBookmarkCssSelectors?: string[] | undefined;
+	/**
+	 * CSS selectors whose matching HTML elements should be tracked during rendering so their
+	 * rendered page positions can later be retrieved by the engine.
+	 *
+	 * <b>Note:</b> retrieval of the per-element locations from the Node client is not yet
+	 * supported. Setting this option still enables engine-side tracking (and any downstream
+	 * effects such as auto-bookmarks for those selectors).
+	 */
+	elementQuerySelectors?: string[] | undefined;
 }
 
 /**