@libpdf/core 0.2.5 → 0.2.7

package/dist/index.d.mts

@@ -1543,6 +1543,110 @@ declare function rectToQuadPoints(rect: Rect): number[];
  */
 declare function rectsToQuadPoints(rects: Rect[]): number[][];
 //#endregion
+//#region src/content/operators.d.ts
+/** Valid operand types */
+type Operand = number | string | PdfName | PdfString | PdfArray | PdfDict;
+/** All PDF content stream operator names */
+declare const Op: {
+  readonly PushGraphicsState: "q";
+  readonly PopGraphicsState: "Q";
+  readonly ConcatMatrix: "cm";
+  readonly SetLineWidth: "w";
+  readonly SetLineCap: "J";
+  readonly SetLineJoin: "j";
+  readonly SetMiterLimit: "M";
+  readonly SetDashPattern: "d";
+  readonly SetRenderingIntent: "ri";
+  readonly SetFlatness: "i";
+  readonly SetGraphicsState: "gs";
+  readonly MoveTo: "m";
+  readonly LineTo: "l";
+  readonly CurveTo: "c";
+  readonly CurveToInitial: "v";
+  readonly CurveToFinal: "y";
+  readonly ClosePath: "h";
+  readonly Rectangle: "re";
+  readonly Stroke: "S";
+  readonly CloseAndStroke: "s";
+  readonly Fill: "f";
+  readonly FillCompat: "F";
+  readonly FillEvenOdd: "f*";
+  readonly FillAndStroke: "B";
+  readonly FillAndStrokeEvenOdd: "B*";
+  readonly CloseFillAndStroke: "b";
+  readonly CloseFillAndStrokeEvenOdd: "b*";
+  readonly EndPath: "n";
+  readonly Clip: "W";
+  readonly ClipEvenOdd: "W*";
+  readonly SetCharSpacing: "Tc";
+  readonly SetWordSpacing: "Tw";
+  readonly SetHorizontalScale: "Tz";
+  readonly SetLeading: "TL";
+  readonly SetFont: "Tf";
+  readonly SetTextRenderMode: "Tr";
+  readonly SetTextRise: "Ts";
+  readonly BeginText: "BT";
+  readonly EndText: "ET";
+  readonly MoveText: "Td";
+  readonly MoveTextSetLeading: "TD";
+  readonly SetTextMatrix: "Tm";
+  readonly NextLine: "T*";
+  readonly ShowText: "Tj";
+  readonly ShowTextArray: "TJ";
+  readonly MoveAndShowText: "'";
+  readonly MoveSetSpacingShowText: "\"";
+  readonly SetStrokingColorSpace: "CS";
+  readonly SetNonStrokingColorSpace: "cs";
+  readonly SetStrokingColor: "SC";
+  readonly SetStrokingColorN: "SCN";
+  readonly SetNonStrokingColor: "sc";
+  readonly SetNonStrokingColorN: "scn";
+  readonly SetStrokingGray: "G";
+  readonly SetNonStrokingGray: "g";
+  readonly SetStrokingRGB: "RG";
+  readonly SetNonStrokingRGB: "rg";
+  readonly SetStrokingCMYK: "K";
+  readonly SetNonStrokingCMYK: "k";
+  readonly DrawXObject: "Do";
+  readonly DesignateMarkedContentPoint: "MP";
+  readonly DesignateMarkedContentPointProps: "DP";
+  readonly BeginMarkedContent: "BMC";
+  readonly BeginMarkedContentProps: "BDC";
+  readonly EndMarkedContent: "EMC";
+  readonly PaintShading: "sh";
+  readonly BeginInlineImage: "BI";
+  readonly BeginInlineImageData: "ID";
+  readonly EndInlineImage: "EI";
+};
+type Op = (typeof Op)[keyof typeof Op];
+/**
+ * A single content stream operator with its operands.
+ * Immutable - create via factory functions or Operator.of().
+ */
+declare class Operator {
+  readonly op: Op;
+  readonly operands: readonly Operand[];
+  private constructor();
+  /**
+   * Create an operator with operands.
+   */
+  static of(op: Op, ...operands: Operand[]): Operator;
+  /**
+   * Serialize to bytes for content stream output.
+   * Format: "operand1 operand2 ... operator"
+   */
+  toBytes(): Uint8Array;
+  /**
+   * Serialize to PDF content stream syntax string.
+   * Format: "operand1 operand2 ... operator"
+   */
+  toString(): string;
+  /**
+   * Get byte length when serialized (for pre-allocation).
+   */
+  byteLength(): number;
+}
+//#endregion
 //#region src/io/binary-scanner.d.ts
 /**
  * Scanner extended with big-endian binary reading methods.
@@ -2571,6 +2675,8 @@ declare class EmbeddedFont extends PdfFont {
   private _subsetTag;
   /** Whether this font is used in a form field (prevents subsetting) */
   private _usedInForm;
+  /** Pre-allocated PDF reference (set by PDFFonts.embed()) */
+  private _ref;
   /** Cached descriptor */
   private _descriptor;
   private constructor();
@@ -2686,6 +2792,22 @@ declare class EmbeddedFont extends PdfFont {
    * Call this before re-encoding if you want a fresh subset.
    */
   resetUsage(): void;
+  /**
+   * Get the pre-allocated PDF reference for this font.
+   *
+   * Set by `PDFFonts.embed()`. At save time, the actual font objects
+   * (Type0 dict, CIDFont, FontDescriptor, font program, ToUnicode)
+   * are created and registered at this ref.
+   *
+   * @throws {Error} if the font was not embedded via `pdf.embedFont()`
+   */
+  get ref(): PdfRef;
+  /**
+   * Set the pre-allocated PDF reference.
+   *
+   * @internal Called by PDFFonts.embed()
+   */
+  setRef(ref: PdfRef): void;
   /**
    * Mark this font as used in a form field.
    *
@@ -3575,221 +3697,633 @@ declare class TextField extends TerminalField {
   setValue(value: string): void;
 }
 //#endregion
-//#region src/images/pdf-image.d.ts
+//#region src/svg/path-executor.d.ts
 /**
- * PDFImage represents an embedded image XObject.
- *
- * @example
- * ```typescript
- * const image = await pdf.embedImage(jpegBytes);
- * console.log(`Image size: ${image.width}x${image.height}`);
- *
- * page.drawImage(image, {
- *   x: 50,
- *   y: 500,
- *   width: 200,
- * });
- * ```
+ * Options for SVG path execution.
  */
-declare class PDFImage {
-  /** Image width in pixels */
-  readonly width: number;
-  /** Image height in pixels */
-  readonly height: number;
-  /** Reference to the image XObject in the document */
-  readonly ref: PdfRef;
+interface SvgPathExecutorOptions {
   /**
-   * Scale factor to convert pixels to points.
-   * Default is 1 (1 pixel = 1 point).
-   * For print-quality (300 DPI), use 72/300 = 0.24.
+   * Flip Y coordinates (negate Y values).
+   *
+   * SVG uses a top-left origin with Y increasing downward.
+   * PDF uses a bottom-left origin with Y increasing upward.
+   *
+   * When true (default), Y coordinates are negated to convert
+   * SVG paths to PDF coordinate space.
+   *
+   * @default true
    */
-  readonly scale: number;
-  constructor(ref: PdfRef, width: number, height: number, scale?: number);
+  flipY?: boolean;
   /**
-   * Width in points (pixels * scale).
+   * Scale factor to apply to all coordinates.
+   * @default 1
    */
-  get widthInPoints(): number;
+  scale?: number;
   /**
-   * Height in points (pixels * scale).
+   * X offset to add after scaling and flipping.
+   * @default 0
    */
-  get heightInPoints(): number;
+  translateX?: number;
   /**
-   * Aspect ratio (width / height).
+   * Y offset to add after scaling and flipping.
+   * @default 0
    */
-  get aspectRatio(): number;
+  translateY?: number;
 }
 //#endregion
-//#region src/text/types.d.ts
+//#region src/drawing/resources/types.d.ts
 /**
- * Types for text extraction from PDF documents.
- *
- * These types represent text content extracted from PDF pages,
- * including position information for searching and highlighting.
+ * Common types for drawing resources.
  */
 /**
- * Rectangle in PDF coordinates (origin at bottom-left).
+ * Bounding box in PDF coordinate space.
+ *
+ * Defines a rectangle where (x, y) is the lower-left corner.
+ * Used for patterns, Form XObjects, and clipping regions.
  */
-interface BoundingBox {
-  /** Left edge (x coordinate) */
+interface BBox {
   x: number;
-  /** Bottom edge (y coordinate) */
   y: number;
-  /** Width of the box */
   width: number;
-  /** Height of the box */
   height: number;
 }
 /**
- * A single extracted character with its position and style information.
+ * Matrix for transforming a pattern.
+ *
+ * Standard PDF transformation matrix [a, b, c, d, e, f] where:
+ * - a, d: Scale factors
+ * - b, c: Rotation/skew factors
+ * - e, f: Translation
  */
-interface ExtractedChar {
-  /** The Unicode character(s) */
-  char: string;
-  /** Bounding box of the character */
-  bbox: BoundingBox;
-  /** Font size in points */
-  fontSize: number;
-  /** Font name (e.g., "Helvetica", "Arial-BoldMT") */
-  fontName: string;
-  /** Y coordinate of the text baseline */
-  baseline: number;
-}
+type PatternMatrix = [a: number, b: number, c: number, d: number, e: number, f: number];
 /**
- * A span of text with the same font and size on the same line.
+ * PDF blend modes for compositing.
+ *
+ * These control how colors are combined when drawing over existing content.
  */
-interface TextSpan {
-  /** The text content */
-  text: string;
-  /** Bounding box around the entire span */
-  bbox: BoundingBox;
-  /** Individual characters (for precise positioning) */
-  chars: ExtractedChar[];
-  /** Font size in points */
-  fontSize: number;
-  /** Font name */
-  fontName: string;
-}
+type BlendMode = "Normal" | "Multiply" | "Screen" | "Overlay" | "Darken" | "Lighten" | "ColorDodge" | "ColorBurn" | "HardLight" | "SoftLight" | "Difference" | "Exclusion" | "Hue" | "Saturation" | "Color" | "Luminosity";
+//#endregion
+//#region src/drawing/resources/shading.d.ts
 /**
- * A line of text (multiple spans on the same baseline).
+ * Axial (linear) shading coordinates: start point (x0, y0) to end point (x1, y1).
+ *
+ * The gradient is drawn along the line from (x0, y0) to (x1, y1).
  */
-interface TextLine$1 {
-  /** Combined text from all spans */
-  text: string;
-  /** Bounding box around the entire line */
-  bbox: BoundingBox;
-  /** Individual spans within the line */
-  spans: TextSpan[];
-  /** Y coordinate of the baseline */
-  baseline: number;
-}
+type AxialCoords = [x0: number, y0: number, x1: number, y1: number];
 /**
- * Full page text extraction result.
+ * Radial shading coordinates: two circles defined by center and radius.
+ *
+ * - First circle: center (x0, y0), radius r0
+ * - Second circle: center (x1, y1), radius r1
+ *
+ * The gradient blends between the two circles.
  */
-interface PageText {
-  /** Page index (0-based) */
-  pageIndex: number;
-  /** Page width in points */
-  width: number;
-  /** Page height in points */
-  height: number;
-  /** All text lines on the page */
-  lines: TextLine$1[];
-  /** Plain text content (lines joined with newlines) */
-  text: string;
-}
+type RadialCoords = [x0: number, y0: number, r0: number, x1: number, y1: number, r1: number];
 /**
- * A search match result.
+ * A color stop in a gradient.
+ *
+ * @example
+ * ```typescript
+ * const stops: ColorStop[] = [
+ *   { offset: 0, color: rgb(1, 0, 0) },    // Red at start
+ *   { offset: 0.5, color: rgb(1, 1, 0) },  // Yellow at midpoint
+ *   { offset: 1, color: rgb(0, 1, 0) },    // Green at end
+ * ];
+ * ```
  */
-interface TextMatch {
-  /** The matched text */
-  text: string;
-  /** Bounding box around the entire match */
-  bbox: BoundingBox;
-  /** Page index where the match was found */
-  pageIndex: number;
-  /** Individual character bounding boxes (useful for multi-line matches or highlighting) */
-  charBoxes: BoundingBox[];
+interface ColorStop {
+  /** Position along the gradient (0 = start, 1 = end) */
+  offset: number;
+  /** Color at this position */
+  color: Color;
 }
 /**
- * Options for text extraction.
+ * Options for creating an axial (linear) shading.
+ *
+ * @example
+ * ```typescript
+ * const gradient = pdf.createAxialShading({
+ *   coords: [0, 0, 100, 0],  // Horizontal gradient, 100pt wide
+ *   stops: [
+ *     { offset: 0, color: rgb(1, 0, 0) },
+ *     { offset: 1, color: rgb(0, 0, 1) },
+ *   ],
+ * });
+ * ```
  */
-interface ExtractTextOptions {
+interface AxialShadingOptions {
   /**
-   * Include individual character positions.
-   * Default: true (needed for search support)
+   * Line segment defining the gradient direction: [x0, y0, x1, y1].
+   *
+   * - (x0, y0): Start point where offset 0 colors appear
+   * - (x1, y1): End point where offset 1 colors appear
    */
-  includeChars?: boolean;
-}
-/**
- * Options for text search.
- */
-interface FindTextOptions {
-  /** Page indices to search (default: all pages) */
-  pages?: number[];
-  /** Case-sensitive matching (default: true) */
-  caseSensitive?: boolean;
-  /** Match whole words only (default: false) */
-  wholeWord?: boolean;
+  coords: AxialCoords;
+  /** Color stops defining the gradient colors and positions */
+  stops: ColorStop[];
+  /**
+   * Whether to extend the gradient beyond its bounds.
+   *
+   * - [true, true] (default): Extend both ends with the endpoint colors
+   * - [false, false]: No extension, transparent beyond bounds
+   */
+  extend?: [boolean, boolean];
 }
-//#endregion
-//#region src/svg/path-executor.d.ts
 /**
- * Options for SVG path execution.
+ * Options for creating a radial shading.
+ *
+ * @example
+ * ```typescript
+ * // Classic radial gradient: point to circle
+ * const radial = pdf.createRadialShading({
+ *   coords: [50, 50, 0, 50, 50, 50],  // From center point to 50pt radius
+ *   stops: [
+ *     { offset: 0, color: rgb(1, 1, 1) },  // White at center
+ *     { offset: 1, color: rgb(0, 0, 0) },  // Black at edge
+ *   ],
+ * });
+ * ```
  */
-interface SvgPathExecutorOptions {
+interface RadialShadingOptions {
   /**
-   * Flip Y coordinates (negate Y values).
+   * Two circles defining the gradient: [x0, y0, r0, x1, y1, r1].
    *
-   * SVG uses a top-left origin with Y increasing downward.
-   * PDF uses a bottom-left origin with Y increasing upward.
+   * - First circle: center (x0, y0), radius r0
+   * - Second circle: center (x1, y1), radius r1
    *
-   * When true (default), Y coordinates are negated to convert
-   * SVG paths to PDF coordinate space.
+   * Common patterns:
+   * - Point-to-circle: r0 = 0 for a classic radial gradient from center
+   * - Circle-to-circle: Both radii > 0 for cone/spotlight effects
+   */
+  coords: RadialCoords;
+  /** Color stops defining the gradient colors and positions */
+  stops: ColorStop[];
+  /**
+   * Whether to extend the gradient beyond its bounds.
    *
-   * @default true
+   * - [true, true] (default): Extend both ends
+   * - [false, false]: No extension
    */
-  flipY?: boolean;
+  extend?: [boolean, boolean];
+}
+/**
+ * Options for creating a linear gradient using CSS-style angle and length.
+ *
+ * This is a convenience wrapper around axial shading that uses familiar
+ * CSS gradient conventions.
+ *
+ * @example
+ * ```typescript
+ * // Horizontal gradient (left to right)
+ * const gradient = pdf.createLinearGradient({
+ *   angle: 90,    // CSS: 0 = up, 90 = right, 180 = down, 270 = left
+ *   length: 100,  // Gradient spans 100pt
+ *   stops: [
+ *     { offset: 0, color: rgb(1, 0, 0) },
+ *     { offset: 1, color: rgb(0, 0, 1) },
+ *   ],
+ * });
+ * ```
+ */
+interface LinearGradientOptions {
   /**
-   * Scale factor to apply to all coordinates.
-   * @default 1
+   * Angle in degrees using CSS convention:
+   * - 0: Bottom to top
+   * - 90: Left to right
+   * - 180: Top to bottom
+   * - 270: Right to left
    */
-  scale?: number;
+  angle: number;
+  /** Length of the gradient in points */
+  length: number;
+  /** Color stops defining the gradient colors and positions */
+  stops: ColorStop[];
+}
+/**
+ * A shading (gradient) resource.
+ *
+ * Shadings define smooth color transitions (gradients) that can fill
+ * arbitrary shapes. Two types are supported:
+ * - **axial**: Linear gradient along a line segment
+ * - **radial**: Circular gradient between two circles
+ *
+ * @example
+ * ```typescript
+ * const gradient = pdf.createAxialShading({
+ *   coords: [0, 0, 100, 0],
+ *   stops: [
+ *     { offset: 0, color: rgb(1, 0, 0) },
+ *     { offset: 1, color: rgb(0, 0, 1) },
+ *   ],
+ * });
+ *
+ * const name = page.registerShading(gradient);
+ * page.drawOperators([
+ *   ops.pushGraphicsState(),
+ *   ops.rectangle(50, 50, 100, 100),
+ *   ops.clip(),
+ *   ops.endPath(),
+ *   ops.paintShading(name),
+ *   ops.popGraphicsState(),
+ * ]);
+ * ```
+ */
+declare class PDFShading {
+  readonly type = "shading";
+  readonly ref: PdfRef;
+  readonly shadingType: "axial" | "radial";
+  constructor(ref: PdfRef, shadingType: "axial" | "radial");
   /**
-   * X offset to add after scaling and flipping.
-   * @default 0
+   * Create the PDF dictionary for an axial shading.
    */
-  translateX?: number;
+  static createAxialDict(options: AxialShadingOptions): PdfDict;
   /**
-   * Y offset to add after scaling and flipping.
-   * @default 0
+   * Create the PDF dictionary for a radial shading.
    */
-  translateY?: number;
+  static createRadialDict(options: RadialShadingOptions): PdfDict;
+  /**
+   * Calculate axial gradient coordinates from angle and length.
+   *
+   * CSS angle convention: 0 = up, 90 = right, 180 = down, 270 = left
+   */
+  static calculateAxialCoords(angle: number, length: number): AxialCoords;
 }
 //#endregion
-//#region src/fonts/standard-14.d.ts
-/**
- * Standard 14 font names.
- */
-declare const STANDARD_14_FONTS: readonly ["Courier", "Courier-Bold", "Courier-Oblique", "Courier-BoldOblique", "Helvetica", "Helvetica-Bold", "Helvetica-Oblique", "Helvetica-BoldOblique", "Times-Roman", "Times-Bold", "Times-Italic", "Times-BoldItalic", "Symbol", "ZapfDingbats"];
-type Standard14FontName = (typeof STANDARD_14_FONTS)[number];
+//#region src/drawing/resources/pattern.d.ts
 /**
- * Standard 14 fonts enum for convenient access.
+ * Options for creating a tiling pattern.
+ *
+ * Tiling patterns repeat a small graphic cell to fill an area. The cell is
+ * defined by operators that draw into the bbox, and the pattern tiles with
+ * the specified step sizes.
  *
  * @example
  * ```typescript
- * page.drawText("Hello", { font: StandardFonts.Helvetica });
- * page.drawText("Bold", { font: StandardFonts.HelveticaBold });
+ * // Checkerboard pattern
+ * const pattern = pdf.createTilingPattern({
+ *   bbox: { x: 0, y: 0, width: 10, height: 10 },
+ *   xStep: 10,
+ *   yStep: 10,
+ *   operators: [
+ *     ops.setNonStrokingGray(0.8),
+ *     ops.rectangle(0, 0, 5, 5),
+ *     ops.fill(),
+ *   ],
+ * });
  * ```
  */
-declare const StandardFonts: {
-  readonly Helvetica: "Helvetica";
-  readonly HelveticaBold: "Helvetica-Bold";
-  readonly HelveticaOblique: "Helvetica-Oblique";
-  readonly HelveticaBoldOblique: "Helvetica-BoldOblique";
-  readonly TimesRoman: "Times-Roman";
-  readonly TimesBold: "Times-Bold";
-  readonly TimesItalic: "Times-Italic";
-  readonly TimesBoldItalic: "Times-BoldItalic";
+interface TilingPatternOptions {
+  /**
+   * Bounding box of the pattern cell.
+   *
+   * Defines the coordinate space for the pattern's operators.
+   * Usually starts at { x: 0, y: 0, width, height }.
+   */
+  bbox: BBox;
+  /**
+   * Horizontal distance between pattern cell origins.
+   *
+   * Set equal to bbox width for seamless tiling, or larger for gaps.
+   */
+  xStep: number;
+  /**
+   * Vertical distance between pattern cell origins.
+   *
+   * Set equal to bbox height for seamless tiling, or larger for gaps.
+   */
+  yStep: number;
+  /** Operators that draw the pattern cell content */
+  operators: Operator[];
+}
+/**
+ * Options for creating an image pattern.
+ *
+ * Image patterns tile an embedded image to fill an area, similar to
+ * CSS `background-image` with `background-repeat: repeat`.
+ *
+ * @example
+ * ```typescript
+ * const image = pdf.embedImage(textureBytes);
+ * const pattern = pdf.createImagePattern({
+ *   image,
+ *   width: 50,   // Tile size in points
+ *   height: 50,
+ * });
+ *
+ * const patternName = page.registerPattern(pattern);
+ * page.drawOperators([
+ *   ops.setNonStrokingColorSpace(ColorSpace.Pattern),
+ *   ops.setNonStrokingColorN(patternName),
+ *   ops.rectangle(100, 100, 300, 200),
+ *   ops.fill(),
+ * ]);
+ * ```
+ */
+interface ImagePatternOptions {
+  /**
+   * The embedded image to use as the pattern tile.
+   *
+   * Created via `pdf.embedImage()`, `pdf.embedJpeg()`, or `pdf.embedPng()`.
+   */
+  image: {
+    ref: PdfRef;
+    width: number;
+    height: number;
+  };
+  /**
+   * Width of each tile in points.
+   *
+   * If not specified, uses the image's natural width in points.
+   */
+  width?: number;
+  /**
+   * Height of each tile in points.
+   *
+   * If not specified, uses the image's natural height in points.
+   */
+  height?: number;
+}
+/**
+ * Options for creating a shading pattern.
+ *
+ * Shading patterns wrap a gradient (shading) so it can be used as a fill or
+ * stroke color, just like tiling patterns.
+ *
+ * @example
+ * ```typescript
+ * // Create a gradient
+ * const gradient = pdf.createAxialShading({
+ *   coords: [0, 0, 100, 0],
+ *   stops: [
+ *     { offset: 0, color: rgb(1, 0, 0) },
+ *     { offset: 1, color: rgb(0, 0, 1) },
+ *   ],
+ * });
+ *
+ * // Wrap in a pattern (optionally with transform)
+ * const pattern = pdf.createShadingPattern({
+ *   shading: gradient,
+ *   matrix: [1, 0, 0, 1, 50, 100],  // Translate by (50, 100)
+ * });
+ * ```
+ */
+interface ShadingPatternOptions {
+  /**
+   * The shading (gradient) to use.
+   *
+   * Created via pdf.createAxialShading() or pdf.createRadialShading().
+   */
+  shading: PDFShading;
+  /**
+   * Optional transformation matrix for the pattern.
+   *
+   * Transforms the shading's coordinate space. Useful for positioning
+   * a gradient relative to shapes that will use it.
+   *
+   * Default: identity matrix (no transformation)
+   */
+  matrix?: PatternMatrix;
+}
+/**
+ * A tiling pattern resource (PatternType 1).
+ *
+ * Tiling patterns repeat a small graphic cell to fill an area.
+ * Useful for textures, backgrounds, and decorative fills.
+ *
+ * @example
+ * ```typescript
+ * const dots = pdf.createTilingPattern({
+ *   bbox: { x: 0, y: 0, width: 10, height: 10 },
+ *   xStep: 10,
+ *   yStep: 10,
+ *   operators: [
+ *     ops.setNonStrokingGray(0.5),
+ *     ops.moveTo(7, 5),
+ *     ops.curveTo(7, 6.1, 6.1, 7, 5, 7),
+ *     ops.curveTo(3.9, 7, 3, 6.1, 3, 5),
+ *     ops.curveTo(3, 3.9, 3.9, 3, 5, 3),
+ *     ops.curveTo(6.1, 3, 7, 3.9, 7, 5),
+ *     ops.fill(),
+ *   ],
+ * });
+ *
+ * const name = page.registerPattern(dots);
+ * ```
+ */
+declare class PDFTilingPattern {
+  readonly type = "pattern";
+  readonly ref: PdfRef;
+  readonly patternType = "tiling";
+  constructor(ref: PdfRef);
+  /**
+   * Create the PDF stream for a tiling pattern.
+   */
+  static createStream(options: TilingPatternOptions, contentBytes: Uint8Array): PdfStream;
+  /**
+   * Create the PDF stream for an image pattern.
+   */
+  static createImageStream(options: ImagePatternOptions): PdfStream;
+}
+/**
+ * A shading pattern resource (PatternType 2).
+ *
+ * Shading patterns wrap a gradient (shading) so it can be used as a fill or
+ * stroke color. Unlike direct shading fills via `paintShading()`, shading
+ * patterns work with any path shape without explicit clipping.
+ *
+ * @example
+ * ```typescript
+ * const gradient = pdf.createAxialShading({
+ *   coords: [0, 0, 100, 0],
+ *   stops: [
+ *     { offset: 0, color: rgb(1, 0, 0) },
+ *     { offset: 1, color: rgb(0, 0, 1) },
+ *   ],
+ * });
+ *
+ * const gradientPattern = pdf.createShadingPattern({ shading: gradient });
+ * const name = page.registerPattern(gradientPattern);
+ * ```
+ */
+declare class PDFShadingPattern {
+  readonly type = "pattern";
+  readonly ref: PdfRef;
+  readonly patternType = "shading";
+  readonly shading: PDFShading;
+  constructor(ref: PdfRef, shading: PDFShading);
+  /**
+   * Create the PDF dictionary for a shading pattern.
+   */
+  static createDict(options: ShadingPatternOptions): PdfDict;
+}
+/**
+ * Any pattern resource (tiling or shading).
+ */
+type PDFPattern = PDFTilingPattern | PDFShadingPattern;
+//#endregion
+//#region src/drawing/resources/extgstate.d.ts
+/**
+ * Options for creating extended graphics state.
+ */
+interface ExtGStateOptions {
+  /** Fill (non-stroking) opacity (0-1) */
+  fillOpacity?: number;
+  /** Stroke opacity (0-1) */
+  strokeOpacity?: number;
+  /** Blend mode for compositing */
+  blendMode?: BlendMode;
+}
+/**
+ * An extended graphics state resource.
+ *
+ * Extended graphics state (ExtGState) provides advanced rendering options
+ * not available in the basic graphics state:
+ * - **Opacity**: Separate fill and stroke transparency
+ * - **Blend modes**: Photoshop-style compositing (Multiply, Screen, etc.)
+ *
+ * @example
+ * ```typescript
+ * const semiTransparent = pdf.createExtGState({
+ *   fillOpacity: 0.5,
+ *   blendMode: "Multiply",
+ * });
+ *
+ * const name = page.registerExtGState(semiTransparent);
+ * page.drawOperators([
+ *   ops.pushGraphicsState(),
+ *   ops.setGraphicsState(name),
+ *   ops.setNonStrokingRGB(1, 0, 0),
+ *   ops.rectangle(100, 100, 50, 50),
+ *   ops.fill(),
+ *   ops.popGraphicsState(),
+ * ]);
+ * ```
+ */
+declare class PDFExtGState {
+  readonly type = "extgstate";
+  readonly ref: PdfRef;
+  constructor(ref: PdfRef);
+  /**
+   * Create the PDF dictionary for an extended graphics state.
+   *
+   * Opacity values are clamped to the range [0, 1].
+   */
+  static createDict(options: ExtGStateOptions): PdfDict;
+}
+//#endregion
+//#region src/drawing/resources/form-xobject.d.ts
+/**
+ * Options for creating a Form XObject (reusable content).
+ *
+ * Form XObjects are like "stamps" - define once, use many times.
+ * They're perfect for watermarks, headers, footers, and repeated graphics.
+ *
+ * @example
+ * ```typescript
+ * // Create a "DRAFT" watermark stamp
+ * const draftStamp = pdf.createFormXObject({
+ *   bbox: { x: 0, y: 0, width: 200, height: 50 },
+ *   operators: [
+ *     ops.setNonStrokingRGB(0.9, 0.1, 0.1),
+ *     ops.beginText(),
+ *     ops.setFont(fontName, 36),
+ *     ops.moveText(10, 10),
+ *     ops.showText("DRAFT"),
+ *     ops.endText(),
+ *   ],
+ * });
+ *
+ * // Use on every page
+ * for (const page of pdf.getPages()) {
+ *   const name = page.registerXObject(draftStamp);
+ *   page.drawOperators([
+ *     ops.pushGraphicsState(),
+ *     ops.concatMatrix(1, 0, 0, 1, 200, 700),
+ *     ops.paintXObject(name),
+ *     ops.popGraphicsState(),
+ *   ]);
+ * }
+ * ```
+ */
+interface FormXObjectOptions {
+  /**
+   * Bounding box of the Form XObject.
+   *
+   * Defines the coordinate space for the form's operators.
+   * Usually starts at { x: 0, y: 0, width, height }.
+   */
+  bbox: BBox;
+  /** Operators that draw the form content */
+  operators: Operator[];
+}
+/**
+ * A Form XObject (reusable content) resource.
+ *
+ * Form XObjects are like "stamps" - define once, use many times.
+ * They're ideal for:
+ * - Watermarks applied to every page
+ * - Headers and footers
+ * - Logos and repeated graphics
+ * - Any content that appears multiple times
+ *
+ * @example
+ * ```typescript
+ * const logo = pdf.createFormXObject({
+ *   bbox: { x: 0, y: 0, width: 100, height: 50 },
+ *   operators: [
+ *     ops.setNonStrokingRGB(0.2, 0.4, 0.8),
+ *     ops.rectangle(0, 0, 100, 50),
+ *     ops.fill(),
+ *   ],
+ * });
+ *
+ * // Use on multiple pages
+ * for (const page of pdf.getPages()) {
+ *   const name = page.registerXObject(logo);
+ *   page.drawOperators([
+ *     ops.pushGraphicsState(),
+ *     ops.concatMatrix(1, 0, 0, 1, 50, 700),
+ *     ops.paintXObject(name),
+ *     ops.popGraphicsState(),
+ *   ]);
+ * }
+ * ```
+ */
+declare class PDFFormXObject {
+  readonly type = "formxobject";
+  readonly ref: PdfRef;
+  readonly bbox: BBox;
+  constructor(ref: PdfRef, bbox: BBox);
+  /**
+   * Create the PDF stream for a Form XObject.
+   */
+  static createStream(options: FormXObjectOptions, contentBytes: Uint8Array): PdfStream;
+}
+//#endregion
+//#region src/fonts/standard-14.d.ts
+/**
+ * Standard 14 font names.
+ */
+declare const STANDARD_14_FONTS: readonly ["Courier", "Courier-Bold", "Courier-Oblique", "Courier-BoldOblique", "Helvetica", "Helvetica-Bold", "Helvetica-Oblique", "Helvetica-BoldOblique", "Times-Roman", "Times-Bold", "Times-Italic", "Times-BoldItalic", "Symbol", "ZapfDingbats"];
+type Standard14FontName = (typeof STANDARD_14_FONTS)[number];
+/**
+ * Standard 14 fonts enum for convenient access.
+ *
+ * @example
+ * ```typescript
+ * page.drawText("Hello", { font: StandardFonts.Helvetica });
+ * page.drawText("Bold", { font: StandardFonts.HelveticaBold });
+ * ```
+ */
+declare const StandardFonts: {
+  readonly Helvetica: "Helvetica";
+  readonly HelveticaBold: "Helvetica-Bold";
+  readonly HelveticaOblique: "Helvetica-Oblique";
+  readonly HelveticaBoldOblique: "Helvetica-BoldOblique";
+  readonly TimesRoman: "Times-Roman";
+  readonly TimesBold: "Times-Bold";
+  readonly TimesItalic: "Times-Italic";
+  readonly TimesBoldItalic: "Times-BoldItalic";
   readonly Courier: "Courier";
   readonly CourierBold: "Courier-Bold";
   readonly CourierOblique: "Courier-Oblique";
@@ -3798,7 +4332,7 @@ declare const StandardFonts: {
   readonly ZapfDingbats: "ZapfDingbats";
 };
 //#endregion
-//#region src/api/drawing/types.d.ts
+//#region src/drawing/types.d.ts
 /**
  * Text alignment for multiline text.
  */
@@ -3900,11 +4434,23 @@ interface DrawRectangleOptions {
   width: number;
   /** Height in points */
   height: number;
-  /** Fill color (omit for no fill) */
+  /** Fill color (omit for no fill, mutually exclusive with pattern) */
   color?: Color;
-  /** Border/stroke color (omit for no stroke) */
+  /**
+   * Fill pattern (tiling or shading pattern).
+   * Use instead of color to fill with a gradient or repeating pattern.
+   * Mutually exclusive with color.
+   */
+  pattern?: PDFPattern;
+  /** Border/stroke color (omit for no stroke, mutually exclusive with borderPattern) */
   borderColor?: Color;
-  /** Border width in points (default: 1 if borderColor set) */
+  /**
+   * Stroke pattern (tiling or shading pattern).
+   * Use instead of borderColor to stroke with a gradient or repeating pattern.
+   * Mutually exclusive with borderColor.
+   */
+  borderPattern?: PDFPattern;
+  /** Border width in points (default: 1 if borderColor/borderPattern set) */
   borderWidth?: number;
   /** Dash pattern array (e.g., [5, 3] for 5pt dash, 3pt gap) */
   borderDashArray?: number[];
@@ -3956,11 +4502,23 @@ interface DrawCircleOptions {
   y: number;
   /** Circle radius in points */
   radius: number;
-  /** Fill color (omit for no fill) */
+  /** Fill color (omit for no fill, mutually exclusive with pattern) */
   color?: Color;
-  /** Border/stroke color (omit for no stroke) */
+  /**
+   * Fill pattern (tiling or shading pattern).
+   * Use instead of color to fill with a gradient or repeating pattern.
+   * Mutually exclusive with color.
+   */
+  pattern?: PDFPattern;
+  /** Border/stroke color (omit for no stroke, mutually exclusive with borderPattern) */
   borderColor?: Color;
-  /** Border width in points (default: 1 if borderColor set) */
+  /**
+   * Stroke pattern (tiling or shading pattern).
+   * Use instead of borderColor to stroke with a gradient or repeating pattern.
+   * Mutually exclusive with borderColor.
+   */
+  borderPattern?: PDFPattern;
+  /** Border width in points (default: 1 if borderColor/borderPattern set) */
   borderWidth?: number;
   /** Fill opacity 0-1 (default: 1) */
   opacity?: number;
@@ -3979,11 +4537,23 @@ interface DrawEllipseOptions {
   xRadius: number;
   /** Vertical radius in points */
   yRadius: number;
-  /** Fill color (omit for no fill) */
+  /** Fill color (omit for no fill, mutually exclusive with pattern) */
   color?: Color;
-  /** Border/stroke color (omit for no stroke) */
+  /**
+   * Fill pattern (tiling or shading pattern).
+   * Use instead of color to fill with a gradient or repeating pattern.
+   * Mutually exclusive with color.
+   */
+  pattern?: PDFPattern;
+  /** Border/stroke color (omit for no stroke, mutually exclusive with borderPattern) */
   borderColor?: Color;
-  /** Border width in points (default: 1 if borderColor set) */
+  /**
+   * Stroke pattern (tiling or shading pattern).
+   * Use instead of borderColor to stroke with a gradient or repeating pattern.
+   * Mutually exclusive with borderColor.
+   */
+  borderPattern?: PDFPattern;
+  /** Border width in points (default: 1 if borderColor/borderPattern set) */
   borderWidth?: number;
   /** Fill opacity 0-1 (default: 1) */
   opacity?: number;
@@ -4028,11 +4598,23 @@ interface DrawSvgPathOptions {
    * @default true
    */
   flipY?: boolean;
-  /** Fill color (default: black; omit to stroke only if borderColor set) */
+  /** Fill color (default: black; omit to stroke only if borderColor set, mutually exclusive with pattern) */
   color?: Color;
-  /** Stroke color (omit for no stroke) */
+  /**
+   * Fill pattern (tiling or shading pattern).
+   * Use instead of color to fill with a gradient or repeating pattern.
+   * Mutually exclusive with color.
+   */
+  pattern?: PDFPattern;
+  /** Stroke color (omit for no stroke, mutually exclusive with borderPattern) */
   borderColor?: Color;
-  /** Stroke width in points (default: 1 if borderColor set) */
+  /**
+   * Stroke pattern (tiling or shading pattern).
+   * Use instead of borderColor to stroke with a gradient or repeating pattern.
+   * Mutually exclusive with borderColor.
+   */
+  borderPattern?: PDFPattern;
+  /** Stroke width in points (default: 1 if borderColor/borderPattern set) */
   borderWidth?: number;
   /** Line cap style */
   lineCap?: LineCap;
@@ -4053,13 +4635,44 @@ interface DrawSvgPathOptions {
 }
 /**
  * Options for path painting.
+ *
+ * @example
+ * ```typescript
+ * // Solid color fill
+ * page.drawPath().rectangle(0, 0, 100, 100).fill({ color: rgb(1, 0, 0) });
+ *
+ * // Pattern fill (tiling or shading pattern)
+ * const gradient = pdf.createAxialShading({...});
+ * const pattern = pdf.createShadingPattern({ shading: gradient });
+ * page.drawPath().circle(50, 50, 30).fill({ pattern });
+ *
+ * // Stroke with pattern
+ * page.drawPath().rectangle(0, 0, 100, 100).stroke({
+ *   borderPattern: pattern,
+ *   borderWidth: 5,
+ * });
+ * ```
  */
 interface PathOptions {
-  /** Fill color (omit for no fill) */
+  /** Fill color (omit for no fill, mutually exclusive with pattern) */
   color?: Color;
-  /** Stroke color (omit for no stroke) */
+  /**
+   * Fill pattern (tiling or shading pattern).
+   *
+   * Use instead of color to fill with a gradient or repeating pattern.
+   * Mutually exclusive with color.
+   */
+  pattern?: PDFPattern;
+  /** Stroke color (omit for no stroke, mutually exclusive with borderPattern) */
   borderColor?: Color;
-  /** Stroke width in points (default: 1 if borderColor set) */
+  /**
+   * Stroke pattern (tiling or shading pattern).
+   *
+   * Use instead of borderColor to stroke with a gradient or repeating pattern.
+   * Mutually exclusive with borderColor.
+   */
+  borderPattern?: PDFPattern;
+  /** Stroke width in points (default: 1 if borderColor/borderPattern set) */
   borderWidth?: number;
   /** Line cap style */
   lineCap?: LineCap;
@@ -4087,7 +4700,7 @@ declare function lineCapToNumber(cap: LineCap): 0 | 1 | 2;
  */
 declare function lineJoinToNumber(join: LineJoin): 0 | 1 | 2;
 //#endregion
-//#region src/api/drawing/path-builder.d.ts
+//#region src/drawing/path-builder.d.ts
 /**
  * Callback type for appending content to a page.
  * Accepts a string (for ASCII-only content) or raw bytes.
@@ -4095,33 +4708,66 @@ declare function lineJoinToNumber(join: LineJoin): 0 | 1 | 2;
 type ContentAppender = (content: string | Uint8Array) => void;
 /**
  * Callback type for registering a graphics state and returning its name.
+ * Returns null if no graphics state is needed (both opacities undefined).
+ */
+type GraphicsStateRegistrar = (options: {
+  fillOpacity?: number;
+  strokeOpacity?: number;
+}) => string | null;
+/**
+ * Callback type for registering a shading and returning its name.
+ */
+type ShadingRegistrar = (shading: PDFShading) => string;
+/**
+ * Callback type for registering a pattern and returning its name.
  */
-type GraphicsStateRegistrar = (fillOpacity?: number, strokeOpacity?: number) => string | null;
+type PatternRegistrar = (pattern: PDFPattern) => string;
 /**
  * PathBuilder provides a fluent interface for constructing PDF paths.
  *
  * @example
  * ```typescript
- * // Triangle
+ * // Triangle with solid color
  * page.drawPath()
  *   .moveTo(300, 200)
  *   .lineTo(350, 300)
  *   .lineTo(250, 300)
  *   .close()
  *   .fill({ color: rgb(0, 0, 1) });
+ *
+ * // Rectangle with gradient fill
+ * const gradient = pdf.createAxialShading({
+ *   coords: [0, 0, 100, 0],
+ *   stops: [
+ *     { offset: 0, color: rgb(1, 0, 0) },
+ *     { offset: 1, color: rgb(0, 0, 1) },
+ *   ],
+ * });
+ * const gradientPattern = pdf.createShadingPattern({ shading: gradient });
+ * page.drawPath()
+ *   .rectangle(50, 50, 100, 100)
+ *   .fill({ pattern: gradientPattern });
+ *
+ * // Circle with tiling pattern fill
+ * const pattern = pdf.createTilingPattern({...});
+ * page.drawPath()
+ *   .circle(200, 200, 50)
+ *   .fill({ pattern });
  * ```
  */
 declare class PathBuilder {
   private readonly pathOps;
   private readonly appendContent;
   private readonly registerGraphicsState;
+  private readonly registerShading?;
+  private readonly registerPattern?;
   /** Current point for quadratic-to-cubic conversion */
   private currentX;
   private currentY;
   /** Start point of current subpath (for close operations) */
   private subpathStartX;
   private subpathStartY;
-  constructor(appendContent: ContentAppender, registerGraphicsState: GraphicsStateRegistrar);
+  constructor(appendContent: ContentAppender, registerGraphicsState: GraphicsStateRegistrar, registerShading?: ShadingRegistrar, registerPattern?: PatternRegistrar);
   /**
    * Move to a point (start a new subpath).
    */
@@ -4232,38 +4878,199 @@ declare class PathBuilder {
    * Paint the path with the given options.
    */
   private paint;
+  /**
+   * Register a pattern and return its name, or undefined if no pattern.
+   */
+  private ensurePatternRegistered;
   /**
    * Emit operators to the page content.
    */
   private emitOps;
 }
 //#endregion
-//#region src/security/credentials.d.ts
+//#region src/images/pdf-image.d.ts
 /**
- * Credentials for decrypting PDF documents.
+ * PDFImage represents an embedded image XObject.
  *
- * Currently supports password-based authentication (Standard security handler).
- * Certificate-based authentication (Public Key handler) is planned for the future.
- */
-/**
- * Password credential for Standard security handler.
+ * @example
+ * ```typescript
+ * const image = await pdf.embedImage(jpegBytes);
+ * console.log(`Image size: ${image.width}x${image.height}`);
+ *
+ * page.drawImage(image, {
+ *   x: 50,
+ *   y: 500,
+ *   width: 200,
+ * });
+ * ```
  */
-interface PasswordCredential {
-  type: "password";
-  password: string;
+declare class PDFImage {
+  /** Image width in pixels */
+  readonly width: number;
+  /** Image height in pixels */
+  readonly height: number;
+  /** Reference to the image XObject in the document */
+  readonly ref: PdfRef;
+  /**
+   * Scale factor to convert pixels to points.
+   * Default is 1 (1 pixel = 1 point).
+   * For print-quality (300 DPI), use 72/300 = 0.24.
+   */
+  readonly scale: number;
+  constructor(ref: PdfRef, width: number, height: number, scale?: number);
+  /**
+   * Width in points (pixels * scale).
+   */
+  get widthInPoints(): number;
+  /**
+   * Height in points (pixels * scale).
+   */
+  get heightInPoints(): number;
+  /**
+   * Aspect ratio (width / height).
+   */
+  get aspectRatio(): number;
 }
+//#endregion
+//#region src/text/types.d.ts
 /**
- * Certificate credential for Public Key security handler (future).
+ * Types for text extraction from PDF documents.
+ *
+ * These types represent text content extracted from PDF pages,
+ * including position information for searching and highlighting.
  */
-interface CertificateCredential {
-  type: "certificate";
-  certificate: Uint8Array;
-  privateKey: Uint8Array;
-}
 /**
- * Credentials for decrypting a document.
- *
- * Can be provided as:
+ * Rectangle in PDF coordinates (origin at bottom-left).
+ */
+interface BoundingBox {
+  /** Left edge (x coordinate) */
+  x: number;
+  /** Bottom edge (y coordinate) */
+  y: number;
+  /** Width of the box */
+  width: number;
+  /** Height of the box */
+  height: number;
+}
+/**
+ * A single extracted character with its position and style information.
+ */
+interface ExtractedChar {
+  /** The Unicode character(s) */
+  char: string;
+  /** Bounding box of the character */
+  bbox: BoundingBox;
+  /** Font size in points */
+  fontSize: number;
+  /** Font name (e.g., "Helvetica", "Arial-BoldMT") */
+  fontName: string;
+  /** Y coordinate of the text baseline */
+  baseline: number;
+}
+/**
+ * A span of text with the same font and size on the same line.
+ */
+interface TextSpan {
+  /** The text content */
+  text: string;
+  /** Bounding box around the entire span */
+  bbox: BoundingBox;
+  /** Individual characters (for precise positioning) */
+  chars: ExtractedChar[];
+  /** Font size in points */
+  fontSize: number;
+  /** Font name */
+  fontName: string;
+}
+/**
+ * A line of text (multiple spans on the same baseline).
+ */
+interface TextLine$1 {
+  /** Combined text from all spans */
+  text: string;
+  /** Bounding box around the entire line */
+  bbox: BoundingBox;
+  /** Individual spans within the line */
+  spans: TextSpan[];
+  /** Y coordinate of the baseline */
+  baseline: number;
+}
+/**
+ * Full page text extraction result.
+ */
+interface PageText {
+  /** Page index (0-based) */
+  pageIndex: number;
+  /** Page width in points */
+  width: number;
+  /** Page height in points */
+  height: number;
+  /** All text lines on the page */
+  lines: TextLine$1[];
+  /** Plain text content (lines joined with newlines) */
+  text: string;
+}
+/**
+ * A search match result.
+ */
+interface TextMatch {
+  /** The matched text */
+  text: string;
+  /** Bounding box around the entire match */
+  bbox: BoundingBox;
+  /** Page index where the match was found */
+  pageIndex: number;
+  /** Individual character bounding boxes (useful for multi-line matches or highlighting) */
+  charBoxes: BoundingBox[];
+}
+/**
+ * Options for text extraction.
+ */
+interface ExtractTextOptions {
+  /**
+   * Include individual character positions.
+   * Default: true (needed for search support)
+   */
+  includeChars?: boolean;
+}
+/**
+ * Options for text search.
+ */
+interface FindTextOptions {
+  /** Page indices to search (default: all pages) */
+  pages?: number[];
+  /** Case-sensitive matching (default: true) */
+  caseSensitive?: boolean;
+  /** Match whole words only (default: false) */
+  wholeWord?: boolean;
+}
+//#endregion
+//#region src/security/credentials.d.ts
+/**
+ * Credentials for decrypting PDF documents.
+ *
+ * Currently supports password-based authentication (Standard security handler).
+ * Certificate-based authentication (Public Key handler) is planned for the future.
+ */
+/**
+ * Password credential for Standard security handler.
+ */
+interface PasswordCredential {
+  type: "password";
+  password: string;
+}
+/**
+ * Certificate credential for Public Key security handler (future).
+ */
+interface CertificateCredential {
+  type: "certificate";
+  certificate: Uint8Array;
+  privateKey: Uint8Array;
+}
+/**
+ * Credentials for decrypting a document.
+ *
+ * Can be provided as:
  * - A plain string (shorthand for password credential)
  * - A PasswordCredential object
  * - A CertificateCredential object (future support)
@@ -5003,6 +5810,8 @@ declare class PDFPage {
   readonly index: number;
   /** Document context for registering objects */
   private readonly ctx;
+  /** Resource cache for deduplication - maps object refs to resource names */
+  private _resourceCache;
   constructor(ref: PdfRef, dict: PdfDict, index: number, ctx: PDFContext);
   /**
    * Get the MediaBox (page boundary).
@@ -5049,6 +5858,12 @@ declare class PDFPage {
    * returns the width of the MediaBox instead.
    */
   get height(): number;
+  /**
+   * Get the effective box for dimension calculations.
+   *
+   * Returns CropBox if it's smaller than MediaBox, otherwise MediaBox.
+   */
+  private getEffectiveBox;
   /**
    * Whether the page is in landscape orientation.
    *
@@ -5290,6 +6105,10 @@ declare class PDFPage {
    * ```
    */
   drawImage(image: PDFImage, options?: DrawImageOptions): void;
+  /**
+   * Compute image dimensions based on options, preserving aspect ratio when appropriate.
+   */
+  private computeImageDimensions;
   /**
    * Start building a custom path.
    *
@@ -5298,7 +6117,7 @@ declare class PDFPage {
    *
    * @example
    * ```typescript
-   * // Triangle
+   * // Triangle with solid color
    * page.drawPath()
    *   .moveTo(100, 100)
    *   .lineTo(200, 100)
@@ -5306,7 +6125,7 @@ declare class PDFPage {
    *   .close()
    *   .fill({ color: rgb(1, 0, 0) });
    *
-   * // Complex shape
+   * // Complex shape with fill and stroke
    * page.drawPath()
    *   .moveTo(50, 50)
    *   .curveTo(100, 100, 150, 100, 200, 50)
@@ -5316,6 +6135,22 @@ declare class PDFPage {
    *     color: rgb(0.9, 0.9, 1),
    *     borderColor: rgb(0, 0, 1),
    *   });
+   *
+   * // Circle with gradient fill (using shading pattern)
+   * const gradient = pdf.createAxialShading({
+   *   coords: [0, 0, 100, 0],
+   *   stops: [{ offset: 0, color: rgb(1, 0, 0) }, { offset: 1, color: rgb(0, 0, 1) }],
+   * });
+   * const gradientPattern = pdf.createShadingPattern({ shading: gradient });
+   * page.drawPath()
+   *   .circle(200, 200, 50)
+   *   .fill({ pattern: gradientPattern });
+   *
+   * // Rectangle with tiling pattern fill
+   * const pattern = pdf.createTilingPattern({...});
+   * page.drawPath()
+   *   .rectangle(50, 300, 100, 100)
+   *   .fill({ pattern });
    * ```
    */
   drawPath(): PathBuilder;
@@ -5362,6 +6197,206 @@ declare class PDFPage {
    * ```
    */
   drawSvgPath(pathData: string, options?: DrawSvgPathOptions): void;
+  /**
+   * Emit raw PDF operators to the page content stream.
+   *
+   * This is the low-level drawing API that gives you direct control over
+   * PDF content stream operators. Use this when you need advanced features
+   * like matrix transforms, graphics state stack, gradients, or patterns
+   * that aren't available through the high-level drawing methods.
+   *
+   * **Important**: The caller is responsible for valid operator sequences.
+   * Invalid sequences may produce corrupted PDFs that won't render correctly.
+   *
+   * @param operators - Array of operators to emit
+   *
+   * @example
+   * ```typescript
+   * import { PDF, ops } from "@libpdf/core";
+   *
+   * const pdf = await PDF.create();
+   * const page = pdf.addPage();
+   *
+   * page.drawOperators([
+   *   ops.pushGraphicsState(),
+   *   ops.concatMatrix(1, 0, 0, 1, 100, 200),  // translate
+   *   ops.setNonStrokingRGB(1, 0, 0),
+   *   ops.rectangle(0, 0, 50, 50),
+   *   ops.fill(),
+   *   ops.popGraphicsState(),
+   * ]);
+   * ```
+   */
+  drawOperators(operators: Operator[]): void;
+  /**
+   * Register a font resource and return its operator name.
+   *
+   * The same font registered multiple times returns the same name (deduplication).
+   *
+   * @param font - Font to register (EmbeddedFont or Standard 14 font name)
+   * @returns The resource name for use with operators (e.g., "F0")
+   *
+   * @example
+   * ```typescript
+   * const font = await pdf.embedFont(fontBytes);
+   * const fontName = page.registerFont(font);
+   *
+   * page.drawOperators([
+   *   ops.beginText(),
+   *   ops.setFont(fontName, 12),
+   *   ops.showText("Hello"),
+   *   ops.endText(),
+   * ]);
+   * ```
+   */
+  registerFont(font: FontInput): string;
+  /**
+   * Register an image resource and return its operator name.
+   *
+   * The same image registered multiple times returns the same name (deduplication).
+   *
+   * @param image - The PDFImage to register
+   * @returns The resource name for use with paintXObject operator (e.g., "Im0")
+   *
+   * @example
+   * ```typescript
+   * const image = await pdf.embedImage(imageBytes);
+   * const imageName = page.registerImage(image);
+   *
+   * page.drawOperators([
+   *   ops.pushGraphicsState(),
+   *   ops.concatMatrix(100, 0, 0, 100, 200, 500),
+   *   ops.paintXObject(imageName),
+   *   ops.popGraphicsState(),
+   * ]);
+   * ```
+   */
+  registerImage(image: PDFImage): string;
+  /**
+   * Register a shading (gradient) resource and return its operator name.
+   *
+   * The same shading registered multiple times returns the same name (deduplication).
+   *
+   * @param shading - The PDFShading to register
+   * @returns The resource name for use with paintShading operator (e.g., "Sh0")
+   *
+   * @example
+   * ```typescript
+   * const gradient = pdf.createAxialShading({
+   *   coords: [0, 0, 100, 0],
+   *   stops: [{ offset: 0, color: rgb(1, 0, 0) }, { offset: 1, color: rgb(0, 0, 1) }],
+   * });
+   * const shadingName = page.registerShading(gradient);
+   *
+   * page.drawOperators([
+   *   ops.pushGraphicsState(),
+   *   ops.rectangle(50, 50, 100, 100),
+   *   ops.clip(),
+   *   ops.endPath(),
+   *   ops.paintShading(shadingName),
+   *   ops.popGraphicsState(),
+   * ]);
+   * ```
+   */
+  registerShading(shading: PDFShading): string;
+  /**
+   * Register a pattern resource and return its operator name.
+   *
+   * The same pattern registered multiple times returns the same name (deduplication).
+   *
+   * @param pattern - The PDFPattern to register
+   * @returns The resource name for use with setNonStrokingColorN operator (e.g., "P0")
+   *
+   * @example
+   * ```typescript
+   * // Create a checkerboard pattern
+   * const pattern = pdf.createTilingPattern({
+   *   bbox: { x: 0, y: 0, width: 10, height: 10 },
+   *   xStep: 10,
+   *   yStep: 10,
+   *   operators: [
+   *     ops.setNonStrokingGray(0.8),
+   *     ops.rectangle(0, 0, 5, 5),
+   *     ops.fill(),
+   *   ],
+   * });
+   * const patternName = page.registerPattern(pattern);
+   *
+   * // Fill a rectangle with the pattern
+   * page.drawOperators([
+   *   ops.setNonStrokingColorSpace(ColorSpace.Pattern),
+   *   ops.setNonStrokingColorN(patternName),
+   *   ops.rectangle(100, 100, 200, 200),
+   *   ops.fill(),
+   * ]);
+   * ```
+   */
+  registerPattern(pattern: PDFPattern): string;
+  /**
+   * Register an extended graphics state resource and return its operator name.
+   *
+   * The same ExtGState registered multiple times returns the same name (deduplication).
+   *
+   * @param state - The PDFExtGState to register
+   * @returns The resource name for use with setGraphicsState operator (e.g., "GS0")
+   *
+   * @example
+   * ```typescript
+   * const gs = pdf.createExtGState({
+   *   fillOpacity: 0.5,
+   *   strokeOpacity: 0.8,
+   *   blendMode: "Multiply",
+   * });
+   * const gsName = page.registerExtGState(gs);
+   *
+   * page.drawOperators([
+   *   ops.pushGraphicsState(),
+   *   ops.setGraphicsState(gsName),
+   *   ops.setNonStrokingRGB(1, 0, 0),
+   *   ops.rectangle(100, 100, 50, 50),
+   *   ops.fill(),
+   *   ops.popGraphicsState(),
+   * ]);
+   * ```
+   */
+  registerExtGState(state: PDFExtGState): string;
+  /**
+   * Register a Form XObject resource and return its operator name.
+   *
+   * The same XObject registered multiple times returns the same name (deduplication).
+   *
+   * @param xobject - The PDFFormXObject or PDFEmbeddedPage to register
+   * @returns The resource name for use with paintXObject operator (e.g., "Fm0")
+   *
+   * @example
+   * ```typescript
+   * // Create a reusable stamp
+   * const stamp = pdf.createFormXObject({
+   *   bbox: { x: 0, y: 0, width: 100, height: 50 },
+   *   operators: [
+   *     ops.setNonStrokingRGB(1, 0, 0),
+   *     ops.rectangle(0, 0, 100, 50),
+   *     ops.fill(),
+   *     ops.beginText(),
+   *     ops.setFont(fontName, 12),
+   *     ops.setNonStrokingGray(1),
+   *     ops.moveText(10, 18),
+   *     ops.showText("STAMP"),
+   *     ops.endText(),
+   *   ],
+   * });
+   * const xobjectName = page.registerXObject(stamp);
+   *
+   * // Use the stamp at different positions
+   * page.drawOperators([
+   *   ops.pushGraphicsState(),
+   *   ops.concatMatrix(1, 0, 0, 1, 200, 700),
+   *   ops.paintXObject(xobjectName),
+   *   ops.popGraphicsState(),
+   * ]);
+   * ```
+   */
+  registerXObject(xobject: PDFFormXObject | PDFEmbeddedPage): string;
   /** Cached annotations for this page */
   private _annotationCache;
   /**
@@ -5635,19 +6670,21 @@ declare class PDFPage {
    * Returns the name assigned to the XObject.
    */
   private addXObjectResource;
-  /**
-   * Add a graphics state to the page's resources.
-   * Returns the name assigned to the ExtGState.
-   */
-  private addGraphicsState;
   /**
    * Generate a unique name not already in the dictionary.
    */
   private generateUniqueName;
   /**
-   * Format a number for PDF content stream (avoid unnecessary decimals).
+   * Register a resource reference in a resource subdictionary.
+   *
+   * Handles deduplication via cache and existing entry scanning.
+   *
+   * @param ref - The object reference to register
+   * @param resourceType - The resource subdictionary key (e.g., "Font", "XObject")
+   * @param prefix - The name prefix (e.g., "F", "Im", "Sh")
+   * @returns The resource name for use in operators
    */
-  private formatNumber;
+  private registerResource;
   /**
    * Create and register a content stream.
    *
@@ -5674,17 +6711,20 @@ declare class PDFPage {
    */
   private getBox;
   /**
-   * Register a graphics state for opacity and return its name.
-   * Returns null if no opacity is needed.
+   * Create and register a graphics state, returning its resource name.
+   *
+   * This is an internal helper for high-level drawing methods.
+   * For the public low-level API, use `pdf.createExtGState()` + `page.registerExtGState()`.
    */
-  private registerGraphicsStateForOpacity;
+  private registerGraphicsState;
   /**
-   * Append operators to the page content stream.
-   *
-   * Uses Operator.toBytes() directly to avoid UTF-8 round-trip corruption
-   * of non-ASCII bytes in PdfString operands (e.g., WinAnsi-encoded text).
+   * Append operators to the page content stream (foreground).
    */
   private appendOperators;
+  /**
+   * Prepend operators to the page content stream (background).
+   */
+  private prependOperators;
   /**
    * Add a font resource to the page and return its name.
    */
@@ -8499,51 +9539,265 @@ declare class PDF {
    */
   embedPng(bytes: Uint8Array): PDFImage;
   /**
-   * Access the attachments API for managing file attachments.
+   * Create an axial (linear) shading with explicit coordinates.
+   *
+   * @param options - Shading options including coords and color stops
+   * @returns PDFShading resource for use with page.registerShading()
    *
    * @example
    * ```typescript
-   * // List attachments
-   * const attachments = await pdf.attachments.list();
-   *
-   * // Add an attachment
-   * await pdf.attachments.add("report.pdf", pdfBytes, {
-   *   description: "Annual report",
+   * const gradient = pdf.createAxialShading({
+   *   coords: [0, 0, 100, 0], // x0, y0, x1, y1
+   *   stops: [
+   *     { offset: 0, color: rgb(1, 0, 0) },
+   *     { offset: 0.5, color: rgb(0, 1, 0) },
+   *     { offset: 1, color: rgb(0, 0, 1) },
+   *   ],
    * });
-   *
-   * // Get attachment data
-   * const data = await pdf.attachments.get("report.pdf");
-   *
-   * // Remove an attachment
-   * await pdf.attachments.remove("old-file.txt");
+   * const shadingName = page.registerShading(gradient);
    * ```
    */
-  get attachments(): PDFAttachments;
+  createAxialShading(options: AxialShadingOptions): PDFShading;
   /**
-   * List all attachments in the document.
+   * Create a radial shading with explicit coordinates.
    *
-   * Convenience method that delegates to `pdf.attachments.list()`.
+   * @param options - Shading options including coords and color stops
+   * @returns PDFShading resource for use with page.registerShading()
    *
-   * @returns Map of attachment name to attachment info
+   * @example
+   * ```typescript
+   * const radial = pdf.createRadialShading({
+   *   coords: [50, 50, 0, 50, 50, 50], // x0, y0, r0, x1, y1, r1
+   *   stops: [
+   *     { offset: 0, color: rgb(1, 1, 1) },
+   *     { offset: 1, color: rgb(0, 0, 0) },
+   *   ],
+   * });
+   * const shadingName = page.registerShading(radial);
+   * ```
    */
-  getAttachments(): Map<string, AttachmentInfo>;
+  createRadialShading(options: RadialShadingOptions): PDFShading;
   /**
-   * Get the raw bytes of an attachment.
+   * Create a linear gradient using angle and length (CSS-style).
    *
-   * Convenience method that delegates to `pdf.attachments.get()`.
+   * @param options - Gradient options including angle, length, and color stops
+   * @returns PDFShading resource for use with page.registerShading()
    *
-   * @param name The attachment name (key in the EmbeddedFiles tree)
-   * @returns The attachment bytes, or null if not found
+   * @example
+   * ```typescript
+   * const gradient = pdf.createLinearGradient({
+   *   angle: 90, // CSS convention: 0 = up, 90 = right, 180 = down, 270 = left
+   *   length: 100,
+   *   stops: [
+   *     { offset: 0, color: rgb(1, 0, 0) },
+   *     { offset: 1, color: rgb(0, 0, 1) },
+   *   ],
+   * });
+   * const shadingName = page.registerShading(gradient);
+   * ```
    */
-  getAttachment(name: string): Uint8Array | null;
+  createLinearGradient(options: LinearGradientOptions): PDFShading;
   /**
-   * Check if an attachment exists.
+   * Create a tiling pattern.
    *
-   * Convenience method that delegates to `pdf.attachments.has()`.
+   * @param options - Pattern options including bbox, step sizes, and operators
+   * @returns PDFPattern resource for use with page.registerPattern()
    *
-   * @param name The attachment name
-   * @returns True if the attachment exists
-   */
+   * @example
+   * ```typescript
+   * const pattern = pdf.createTilingPattern({
+   *   bbox: { x: 0, y: 0, width: 10, height: 10 },
+   *   xStep: 10,
+   *   yStep: 10,
+   *   operators: [
+   *     ops.setNonStrokingRGB(0.8, 0.8, 0.8),
+   *     ops.rectangle(0, 0, 5, 5),
+   *     ops.fill(),
+   *   ],
+   * });
+   * const patternName = page.registerPattern(pattern);
+   * ```
+   */
+  createTilingPattern(options: TilingPatternOptions): PDFTilingPattern;
+  /**
+   * Create an image pattern for filling shapes with a tiled image.
+   *
+   * This is a convenience method that creates a tiling pattern containing
+   * an embedded image. Similar to CSS `background-image` with `background-repeat`.
+   *
+   * @param options - Image pattern options including the image and tile dimensions
+   * @returns PDFTilingPattern resource for use with page.registerPattern()
+   *
+   * @example
+   * ```typescript
+   * // Create a repeating texture pattern
+   * const texture = pdf.embedImage(textureBytes);
+   * const pattern = pdf.createImagePattern({
+   *   image: texture,
+   *   width: 50,   // Each tile is 50x50 points
+   *   height: 50,
+   * });
+   *
+   * const patternName = page.registerPattern(pattern);
+   * page.drawOperators([
+   *   ops.setNonStrokingColorSpace(ColorSpace.Pattern),
+   *   ops.setNonStrokingColorN(patternName),
+   *   ops.rectangle(100, 100, 300, 200),
+   *   ops.fill(),
+   * ]);
+   *
+   * // Or use with PathBuilder
+   * page.drawPath()
+   *   .rectangle(100, 100, 300, 200)
+   *   .fill({ pattern });
+   * ```
+   *
+   * @example
+   * ```typescript
+   * // Horizontal stripes using repeat-x
+   * const stripe = pdf.embedImage(stripeBytes);
+   * const pattern = pdf.createImagePattern({
+   *   image: stripe,
+   *   width: 100,
+   *   height: 20,
+   *   repeat: "repeat-x",
+   * });
+   * ```
+   */
+  createImagePattern(options: ImagePatternOptions): PDFTilingPattern;
+  /**
+   * Create a shading pattern from a shading (gradient).
+   *
+   * Shading patterns wrap a gradient so it can be used as a fill or stroke color,
+   * just like tiling patterns. This is the recommended way to use gradients with
+   * PathBuilder and high-level drawing methods.
+   *
+   * @param options - Shading pattern options (shading and optional matrix)
+   * @returns PDFShadingPattern resource for use with page.registerPattern()
+   *
+   * @example
+   * ```typescript
+   * // Create a gradient
+   * const gradient = pdf.createAxialShading({
+   *   coords: [0, 0, 100, 0],
+   *   stops: [
+   *     { offset: 0, color: rgb(1, 0, 0) },
+   *     { offset: 1, color: rgb(0, 0, 1) },
+   *   ],
+   * });
+   *
+   * // Wrap in a pattern
+   * const gradientPattern = pdf.createShadingPattern({ shading: gradient });
+   *
+   * // Use with PathBuilder
+   * page.drawPath()
+   *   .circle(200, 200, 50)
+   *   .fill({ pattern: gradientPattern });
+   *
+   * // Or register and use directly
+   * const patternName = page.registerPattern(gradientPattern);
+   * page.drawOperators([
+   *   ops.setNonStrokingColorSpace(ColorSpace.Pattern),
+   *   ops.setNonStrokingColorN(patternName),
+   *   ops.rectangle(100, 100, 200, 200),
+   *   ops.fill(),
+   * ]);
+   * ```
+   */
+  createShadingPattern(options: ShadingPatternOptions): PDFShadingPattern;
+  /**
+   * Create an extended graphics state (ExtGState) for advanced graphics options.
+   *
+   * @param options - ExtGState options including opacity and blend mode
+   * @returns PDFExtGState resource for use with page.registerExtGState()
+   *
+   * @example
+   * ```typescript
+   * const gs = pdf.createExtGState({
+   *   fillOpacity: 0.5,
+   *   strokeOpacity: 0.8,
+   *   blendMode: "Multiply",
+   * });
+   * const gsName = page.registerExtGState(gs);
+   * ```
+   */
+  createExtGState(options: ExtGStateOptions): PDFExtGState;
+  /**
+   * Create a Form XObject (reusable content).
+   *
+   * @param options - Form XObject options including bbox and operators
+   * @returns PDFFormXObject resource for use with page.registerXObject()
+   *
+   * @example
+   * ```typescript
+   * const stamp = pdf.createFormXObject({
+   *   bbox: { x: 0, y: 0, width: 100, height: 50 },
+   *   operators: [
+   *     ops.setNonStrokingRGB(1, 0, 0),
+   *     ops.rectangle(0, 0, 100, 50),
+   *     ops.fill(),
+   *   ],
+   * });
+   * const xobjectName = page.registerXObject(stamp);
+   *
+   * // Use on multiple pages
+   * for (const page of pdf.getPages()) {
+   *   page.drawOperators([
+   *     ops.pushGraphicsState(),
+   *     ops.concatMatrix(1, 0, 0, 1, 200, 700),
+   *     ops.paintXObject(xobjectName),
+   *     ops.popGraphicsState(),
+   *   ]);
+   * }
+   * ```
+   */
+  createFormXObject(options: FormXObjectOptions): PDFFormXObject;
+  /**
+   * Access the attachments API for managing file attachments.
+   *
+   * @example
+   * ```typescript
+   * // List attachments
+   * const attachments = await pdf.attachments.list();
+   *
+   * // Add an attachment
+   * await pdf.attachments.add("report.pdf", pdfBytes, {
+   *   description: "Annual report",
+   * });
+   *
+   * // Get attachment data
+   * const data = await pdf.attachments.get("report.pdf");
+   *
+   * // Remove an attachment
+   * await pdf.attachments.remove("old-file.txt");
+   * ```
+   */
+  get attachments(): PDFAttachments;
+  /**
+   * List all attachments in the document.
+   *
+   * Convenience method that delegates to `pdf.attachments.list()`.
+   *
+   * @returns Map of attachment name to attachment info
+   */
+  getAttachments(): Map<string, AttachmentInfo>;
+  /**
+   * Get the raw bytes of an attachment.
+   *
+   * Convenience method that delegates to `pdf.attachments.get()`.
+   *
+   * @param name The attachment name (key in the EmbeddedFiles tree)
+   * @returns The attachment bytes, or null if not found
+   */
+  getAttachment(name: string): Uint8Array | null;
+  /**
+   * Check if an attachment exists.
+   *
+   * Convenience method that delegates to `pdf.attachments.has()`.
+   *
+   * @param name The attachment name
+   * @returns True if the attachment exists
+   */
   hasAttachment(name: string): boolean;
   /**
    * Add a file attachment to the document.
@@ -9301,7 +10555,7 @@ declare class Standard14Font {
   sizeAtWidth(text: string, width: number): number;
 }
 //#endregion
-//#region src/api/drawing/text-layout.d.ts
+//#region src/drawing/text-layout.d.ts
 /**
  * A single line of laid out text.
  */
@@ -9367,6 +10621,757 @@ declare function layoutText(text: string, font: FontInput, fontSize: number, max
  */
 declare function layoutJustifiedLine(words: string[], font: FontInput, fontSize: number, targetWidth: number): PositionedWord[];
 //#endregion
+//#region src/helpers/matrix.d.ts
+/**
+ * 2D transformation matrix for PDF coordinate transformations.
+ *
+ * PDF uses a 3x3 transformation matrix represented as [a b c d e f]
+ * which corresponds to the matrix:
+ *
+ * | a  b  0 |
+ * | c  d  0 |
+ * | e  f  1 |
+ *
+ * This is used for both the CTM (Current Transformation Matrix) and
+ * text matrices (Tm/Tlm).
+ */
+/** biome-ignore-all lint/suspicious/useAdjacentOverloadSignatures: biome is whiffing */
+declare class Matrix {
+  readonly a: number;
+  readonly b: number;
+  readonly c: number;
+  readonly d: number;
+  readonly e: number;
+  readonly f: number;
+  constructor(a: number, b: number, c: number, d: number, e: number, f: number);
+  /**
+   * Create an identity matrix.
+   */
+  static identity(): Matrix;
+  /**
+   * Create a matrix from an array of 6 numbers.
+   */
+  static fromArray(arr: number[]): Matrix;
+  /**
+   * Create a translation matrix.
+   */
+  static translate(tx: number, ty: number): Matrix;
+  /**
+   * Create a scaling matrix.
+   */
+  static scale(sx: number, sy: number): Matrix;
+  /**
+   * Create a rotation matrix (angle in radians).
+   */
+  static rotate(angle: number): Matrix;
+  /**
+   * Multiply this matrix by another: this × other.
+   *
+   * Matrix multiplication is done as:
+   * | a1 b1 0 |   | a2 b2 0 |
+   * | c1 d1 0 | × | c2 d2 0 |
+   * | e1 f1 1 |   | e2 f2 1 |
+   */
+  multiply(other: Matrix): Matrix;
+  /**
+   * Apply a translation to this matrix.
+   */
+  translate(tx: number, ty: number): Matrix;
+  /**
+   * Apply scaling to this matrix.
+   */
+  scale(sx: number, sy: number): Matrix;
+  /**
+   * Apply rotation to this matrix (angle in radians).
+   */
+  rotate(angle: number): Matrix;
+  /**
+   * Transform a point using this matrix.
+   *
+   * x' = a*x + c*y + e
+   * y' = b*x + d*y + f
+   */
+  transformPoint(x: number, y: number): {
+    x: number;
+    y: number;
+  };
+  /**
+   * Transform a distance (vector) using this matrix.
+   * Unlike transformPoint, this doesn't include the translation component.
+   *
+   * dx' = a*dx + c*dy
+   * dy' = b*dx + d*dy
+   */
+  transformDistance(dx: number, dy: number): {
+    dx: number;
+    dy: number;
+  };
+  /**
+   * Get the horizontal scaling factor.
+   * This is sqrt(a² + b²).
+   */
+  getScaleX(): number;
+  /**
+   * Get the vertical scaling factor.
+   * This is sqrt(c² + d²).
+   */
+  getScaleY(): number;
+  /**
+   * Get the rotation angle in radians.
+   */
+  getRotation(): number;
+  /**
+   * Clone this matrix.
+   */
+  clone(): Matrix;
+  /**
+   * Check if this is approximately an identity matrix.
+   */
+  isIdentity(tolerance?: number): boolean;
+  /**
+   * Convert to array format [a, b, c, d, e, f].
+   */
+  toArray(): [number, number, number, number, number, number];
+  toString(): string;
+}
+declare namespace operators_d_exports {
+  export { beginMarkedContent, beginMarkedContentProps, beginText, clip, clipEvenOdd, closeAndStroke, closeFillAndStroke, closeFillAndStrokeEvenOdd, closePath, concatMatrix, curveTo, curveToFinal, curveToInitial, designateMarkedContentPoint, designateMarkedContentPointProps, drawXObject, endMarkedContent, endPath, endText, fill, fillAndStroke, fillAndStrokeEvenOdd, fillCompat, fillEvenOdd, lineTo, moveAndShowText, moveSetSpacingShowText, moveText, moveTextSetLeading, moveTo, nextLine, paintShading, paintXObject, popGraphicsState, pushGraphicsState, rectangle, setCharSpacing, setDashPattern, setFont, setGraphicsState, setHorizontalScale, setLeading, setLineCap, setLineJoin, setLineWidth, setMiterLimit, setNonStrokingCMYK, setNonStrokingColor, setNonStrokingColorN, setNonStrokingColorSpace, setNonStrokingGray, setNonStrokingRGB, setStrokingCMYK, setStrokingColor, setStrokingColorN, setStrokingColorSpace, setStrokingGray, setStrokingRGB, setTextMatrix, setTextRenderMode, setTextRise, setWordSpacing, showText, showTextArray, stroke };
+}
+/**
+ * Save the current graphics state on the stack (q operator).
+ *
+ * The graphics state includes:
+ * - Current transformation matrix (CTM)
+ * - Clipping path
+ * - Color and color space (stroke and fill)
+ * - Line width, cap, join, dash pattern
+ * - Text state parameters
+ * - Extended graphics state (opacity, blend mode)
+ *
+ * **Best Practice:** Always pair with popGraphicsState(). Use push/pop to:
+ * - Isolate transformations (rotation, scaling, translation)
+ * - Limit clipping regions to specific content
+ * - Apply temporary opacity or blend modes
+ *
+ * @example
+ * ```typescript
+ * page.drawOperators([
+ *   ops.pushGraphicsState(),
+ *   ops.concatMatrix(1, 0, 0, 1, 100, 200), // This transform...
+ *   ops.setNonStrokingRGB(1, 0, 0),          // ...and this color...
+ *   ops.rectangle(0, 0, 50, 50),
+ *   ops.fill(),
+ *   ops.popGraphicsState(),                  // ...are now restored
+ *   // Back to original state
+ * ]);
+ * ```
+ */
+declare const pushGraphicsState: () => Operator;
+/**
+ * Restore the graphics state from the stack (Q operator).
+ *
+ * Restores all graphics parameters to the values they had when
+ * pushGraphicsState() was last called. This includes CTM, colors,
+ * clipping path, and extended graphics state.
+ *
+ * @see pushGraphicsState
+ */
+declare const popGraphicsState: () => Operator;
+/**
+ * Concatenate a transformation matrix to the current transformation matrix.
+ *
+ * Accepts either a Matrix instance or 6 individual matrix components [a, b, c, d, e, f].
+ *
+ * @example
+ * ```typescript
+ * // Using Matrix instance
+ * const matrix = Matrix.identity().translate(100, 200).scale(2, 2);
+ * ops.concatMatrix(matrix)
+ *
+ * // Using individual components
+ * ops.concatMatrix(1, 0, 0, 1, 100, 200)  // translate
+ * ```
+ */
+declare function concatMatrix(matrix: Matrix): Operator;
+declare function concatMatrix(a: number, b: number, c: number, d: number, e: number, f: number): Operator;
+/**
+ * Set the line width for stroking operations.
+ *
+ * @param width - Line width in user space units (points)
+ */
+declare const setLineWidth: (width: number) => Operator;
+/**
+ * Set the line cap style for stroking operations.
+ *
+ * @param cap - Line cap style:
+ *   - 0: Butt cap (stroke ends at the endpoint)
+ *   - 1: Round cap (semicircle at endpoint)
+ *   - 2: Projecting square cap (extends half line width past endpoint)
+ */
+declare const setLineCap: (cap: 0 | 1 | 2) => Operator;
+/**
+ * Set the line join style for stroking operations.
+ *
+ * @param join - Line join style:
+ *   - 0: Miter join (extended outer edges meet at an angle)
+ *   - 1: Round join (circular arc at join)
+ *   - 2: Bevel join (triangle fills the gap)
+ */
+declare const setLineJoin: (join: 0 | 1 | 2) => Operator;
+/**
+ * Set the miter limit for line joins.
+ *
+ * When two line segments meet at a sharp angle and miter joins are specified,
+ * the miter may extend far beyond the join point. The miter limit imposes a
+ * maximum ratio of miter length to line width.
+ *
+ * @param limit - Miter limit ratio (minimum 1.0)
+ */
+declare const setMiterLimit: (limit: number) => Operator;
+/**
+ * Set the dash pattern for stroking operations.
+ *
+ * @param array - Array of dash and gap lengths (empty for solid line)
+ * @param phase - Offset into the dash pattern to start from
+ *
+ * @example
+ * ```typescript
+ * // Dashed line: 8pt dash, 4pt gap
+ * ops.setDashPattern(new PdfArray([PdfNumber.of(8), PdfNumber.of(4)]), 0)
+ *
+ * // Solid line (reset)
+ * ops.setDashPattern(new PdfArray([]), 0)
+ * ```
+ */
+declare const setDashPattern: (array: PdfArray, phase: number) => Operator;
+/**
+ * Set the extended graphics state from a named resource.
+ *
+ * Extended graphics state includes parameters like opacity, blend mode,
+ * and other advanced graphics settings not in the basic graphics state.
+ *
+ * @param name - Resource name (e.g., "GS0"); normalized to have leading slash
+ */
+declare const setGraphicsState: (name: string) => Operator;
+/**
+ * Begin a new subpath at the given point.
+ *
+ * Moves the current point without drawing. Subsequent lineTo/curveTo
+ * operations will start from this point.
+ *
+ * @param x - X coordinate in user space
+ * @param y - Y coordinate in user space
+ */
+declare const moveTo: (x: number, y: number) => Operator;
+/**
+ * Append a straight line segment to the current path.
+ *
+ * Draws a line from the current point to (x, y) and makes (x, y)
+ * the new current point.
+ *
+ * @param x - X coordinate of endpoint
+ * @param y - Y coordinate of endpoint
+ */
+declare const lineTo: (x: number, y: number) => Operator;
+/**
+ * Append a cubic Bezier curve to the current path.
+ *
+ * The curve extends from the current point to (x3, y3), using
+ * (x1, y1) and (x2, y2) as control points.
+ *
+ * @param x1 - X coordinate of first control point
+ * @param y1 - Y coordinate of first control point
+ * @param x2 - X coordinate of second control point
+ * @param y2 - Y coordinate of second control point
+ * @param x3 - X coordinate of endpoint
+ * @param y3 - Y coordinate of endpoint
+ */
+declare const curveTo: (x1: number, y1: number, x2: number, y2: number, x3: number, y3: number) => Operator;
+/**
+ * Append a cubic Bezier curve using current point as first control point.
+ *
+ * The curve extends from the current point to (x3, y3). The first control
+ * point is the current point; (x2, y2) is the second control point.
+ *
+ * @param x2 - X coordinate of second control point
+ * @param y2 - Y coordinate of second control point
+ * @param x3 - X coordinate of endpoint
+ * @param y3 - Y coordinate of endpoint
+ */
+declare const curveToInitial: (x2: number, y2: number, x3: number, y3: number) => Operator;
+/**
+ * Append a cubic Bezier curve using endpoint as second control point.
+ *
+ * The curve extends from the current point to (x3, y3). Uses (x1, y1)
+ * as first control point; the second control point coincides with (x3, y3).
+ *
+ * @param x1 - X coordinate of first control point
+ * @param y1 - Y coordinate of first control point
+ * @param x3 - X coordinate of endpoint
+ * @param y3 - Y coordinate of endpoint
+ */
+declare const curveToFinal: (x1: number, y1: number, x3: number, y3: number) => Operator;
+/**
+ * Close the current subpath by appending a straight line to the start point.
+ *
+ * Draws a line from the current point to the starting point of the current
+ * subpath (the point of the most recent moveTo).
+ */
+declare const closePath: () => Operator;
+/**
+ * Append a rectangle to the current path.
+ *
+ * Equivalent to: moveTo(x, y), lineTo(x+width, y), lineTo(x+width, y+height),
+ * lineTo(x, y+height), closePath().
+ *
+ * @param x - X coordinate of lower-left corner
+ * @param y - Y coordinate of lower-left corner
+ * @param width - Width of rectangle
+ * @param height - Height of rectangle
+ */
+declare const rectangle: (x: number, y: number, width: number, height: number) => Operator;
+/** Stroke the current path using the current stroking color and line settings. */
+declare const stroke: () => Operator;
+/** Close the current subpath and then stroke the path. */
+declare const closeAndStroke: () => Operator;
+/**
+ * Fill the current path using the non-zero winding number rule.
+ *
+ * Areas enclosed by the path are filled with the current non-stroking color.
+ */
+declare const fill: () => Operator;
+/**
+ * Fill the current path using the non-zero winding number rule.
+ *
+ * @deprecated Use fill() instead. This is the legacy 'F' operator which is
+ * equivalent to the 'f' operator.
+ */
+declare const fillCompat: () => Operator;
+/**
+ * Fill the current path using the even-odd rule.
+ *
+ * The even-odd rule determines whether a point is inside the path by
+ * counting path crossings. Points with an odd count are inside.
+ */
+declare const fillEvenOdd: () => Operator;
+/** Fill and then stroke the current path (non-zero winding fill rule). */
+declare const fillAndStroke: () => Operator;
+/** Fill (even-odd rule) and then stroke the current path. */
+declare const fillAndStrokeEvenOdd: () => Operator;
+/** Close, fill (non-zero winding), and stroke the current path. */
+declare const closeFillAndStroke: () => Operator;
+/** Close, fill (even-odd), and stroke the current path. */
+declare const closeFillAndStrokeEvenOdd: () => Operator;
+/**
+ * End the path without filling or stroking.
+ *
+ * Use this after clipping to discard the path used for the clipping region.
+ */
+declare const endPath: () => Operator;
+/**
+ * Intersect the current clipping path with the current path (non-zero winding rule).
+ *
+ * **Important:** The clip operator modifies the clipping path but does NOT consume
+ * the current path. You MUST follow clip() with a path-painting operator:
+ * - `endPath()` - Discard the path (most common for clipping)
+ * - `fill()` - Fill the path AND use it for clipping
+ * - `stroke()` - Stroke the path AND use it for clipping
+ *
+ * The clipping region persists until popGraphicsState() is called.
+ * Always wrap clipping operations in pushGraphicsState()/popGraphicsState().
+ *
+ * @example
+ * ```typescript
+ * // Clip subsequent drawing to a rectangle
+ * page.drawOperators([
+ *   ops.pushGraphicsState(),
+ *   ops.rectangle(50, 50, 100, 100),
+ *   ops.clip(),
+ *   ops.endPath(),  // REQUIRED - consumes the path
+ *   // Now draw content that will be clipped
+ *   ops.paintShading(gradientName),
+ *   ops.popGraphicsState(),  // Clipping region is restored
+ * ]);
+ * ```
+ *
+ * @see clipEvenOdd for the even-odd winding rule variant
+ * @see endPath to consume the path after clipping
+ */
+declare const clip: () => Operator;
+/**
+ * Intersect the current clipping path with the current path (even-odd rule).
+ *
+ * Like clip(), but uses the even-odd rule to determine what's inside the path.
+ * The even-odd rule counts path crossings - points with an odd count are inside.
+ *
+ * **Important:** Must be followed by a path-painting operator (fill, stroke, or endPath).
+ *
+ * @example
+ * ```typescript
+ * // Create a donut-shaped clipping region
+ * page.drawOperators([
+ *   ops.pushGraphicsState(),
+ *   // Outer circle
+ *   ops.moveTo(150, 100), // ... circle path ops
+ *   // Inner circle (drawn in same direction)
+ *   ops.moveTo(120, 100), // ... circle path ops
+ *   ops.clipEvenOdd(),
+ *   ops.endPath(),
+ *   // Content here is clipped to the donut shape
+ *   ops.popGraphicsState(),
+ * ]);
+ * ```
+ *
+ * @see clip for the non-zero winding rule variant
+ */
+declare const clipEvenOdd: () => Operator;
+/**
+ * Set the character spacing (extra space between characters).
+ *
+ * @param spacing - Additional space in text space units (default 0)
+ */
+declare const setCharSpacing: (spacing: number) => Operator;
+/**
+ * Set the word spacing (extra space between words).
+ *
+ * Word spacing is added to each ASCII space character (0x20).
+ *
+ * @param spacing - Additional space in text space units (default 0)
+ */
+declare const setWordSpacing: (spacing: number) => Operator;
+/**
+ * Set the horizontal scaling factor for text.
+ *
+ * @param scale - Percentage of normal width (100 = normal)
+ */
+declare const setHorizontalScale: (scale: number) => Operator;
+/**
+ * Set the text leading (line spacing).
+ *
+ * Used by nextLine() and moveTextSetLeading() to move to the next line.
+ *
+ * @param leading - Vertical distance between baselines (in text space units)
+ */
+declare const setLeading: (leading: number) => Operator;
+/**
+ * Set the font and size for text operations.
+ *
+ * @param name - Font resource name (e.g., "F0"); normalized to have leading slash
+ * @param size - Font size in text space units
+ */
+declare const setFont: (name: string, size: number) => Operator;
+/**
+ * Set the text rendering mode.
+ *
+ * @param mode - Rendering mode:
+ *   - 0: Fill text
+ *   - 1: Stroke text
+ *   - 2: Fill then stroke
+ *   - 3: Invisible (no fill or stroke)
+ *   - 4: Fill and add to clipping path
+ *   - 5: Stroke and add to clipping path
+ *   - 6: Fill, stroke, and add to clipping path
+ *   - 7: Add to clipping path (invisible)
+ */
+declare const setTextRenderMode: (mode: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7) => Operator;
+/**
+ * Set the text rise (baseline offset).
+ *
+ * Moves the baseline up (positive) or down (negative) relative to the
+ * current text line. Used for superscripts and subscripts.
+ *
+ * @param rise - Vertical offset in text space units
+ */
+declare const setTextRise: (rise: number) => Operator;
+/**
+ * Begin a text object.
+ *
+ * Text operations (showText, moveText, setFont, etc.) can only be used
+ * between beginText() and endText().
+ */
+declare const beginText: () => Operator;
+/** End the text object and restore the text state. */
+declare const endText: () => Operator;
+/**
+ * Move to the start of the next line, offset from the current line origin.
+ *
+ * @param tx - Horizontal offset in text space units
+ * @param ty - Vertical offset in text space units
+ */
+declare const moveText: (tx: number, ty: number) => Operator;
+/**
+ * Move to the next line and set the leading.
+ *
+ * Equivalent to: setLeading(-ty), moveText(tx, ty).
+ *
+ * @param tx - Horizontal offset in text space units
+ * @param ty - Vertical offset (negative of the leading)
+ */
+declare const moveTextSetLeading: (tx: number, ty: number) => Operator;
+/**
+ * Set the text matrix and text line matrix.
+ *
+ * Unlike concatMatrix, this replaces (not concatenates) the text matrix.
+ *
+ * @param a - Horizontal scaling
+ * @param b - Horizontal skewing
+ * @param c - Vertical skewing
+ * @param d - Vertical scaling
+ * @param e - Horizontal translation (text position X)
+ * @param f - Vertical translation (text position Y)
+ */
+declare const setTextMatrix: (a: number, b: number, c: number, d: number, e: number, f: number) => Operator;
+/**
+ * Move to the start of the next line.
+ *
+ * Equivalent to: moveText(0, -leading), where leading is the current text leading.
+ */
+declare const nextLine: () => Operator;
+/**
+ * Show a text string.
+ *
+ * Accepts either a plain string (auto-encoded) or a PdfString instance.
+ * Plain strings are encoded using PdfString.fromString() which picks
+ * the optimal encoding.
+ */
+declare const showText: (text: string | PdfString) => Operator;
+/**
+ * Show text strings with individual position adjustments.
+ *
+ * The array contains strings and numbers. Numbers are horizontal adjustments
+ * in thousandths of a text space unit (negative = move right).
+ *
+ * @param array - Array of strings and position adjustments
+ *
+ * @example
+ * ```typescript
+ * // Kern "AV" by moving V slightly left
+ * ops.showTextArray(new PdfArray([
+ *   PdfString.fromString("A"),
+ *   PdfNumber.of(-50),  // Move left 50/1000 of text space
+ *   PdfString.fromString("V"),
+ * ]))
+ * ```
+ */
+declare const showTextArray: (array: PdfArray) => Operator;
+/**
+ * Move to next line and show text.
+ *
+ * Accepts either a plain string (auto-encoded) or a PdfString instance.
+ */
+declare const moveAndShowText: (text: string | PdfString) => Operator;
+/**
+ * Move to next line, set word and character spacing, and show text.
+ *
+ * Accepts either a plain string (auto-encoded) or a PdfString instance.
+ */
+declare const moveSetSpacingShowText: (wordSpacing: number, charSpacing: number, text: string | PdfString) => Operator;
+/**
+ * Set the stroking color space.
+ *
+ * @param name - Color space name (e.g., "DeviceRGB", "Pattern"); normalized to have leading slash
+ */
+declare const setStrokingColorSpace: (name: string) => Operator;
+/**
+ * Set the non-stroking (fill) color space.
+ *
+ * @param name - Color space name (e.g., "DeviceRGB", "Pattern"); normalized to have leading slash
+ */
+declare const setNonStrokingColorSpace: (name: string) => Operator;
+/**
+ * Set the stroking color in the current color space.
+ *
+ * Number of components depends on the current stroking color space.
+ *
+ * @param components - Color component values (0-1 for most color spaces)
+ */
+declare const setStrokingColor: (...components: number[]) => Operator;
+/**
+ * Set stroking color with extended color space.
+ *
+ * String components (like pattern names) are normalized to have leading slashes.
+ */
+declare const setStrokingColorN: (...components: (number | string)[]) => Operator;
+/**
+ * Set the non-stroking (fill) color in the current color space.
+ *
+ * Number of components depends on the current non-stroking color space.
+ *
+ * @param components - Color component values (0-1 for most color spaces)
+ */
+declare const setNonStrokingColor: (...components: number[]) => Operator;
+/**
+ * Set non-stroking (fill) color with extended color space.
+ *
+ * String components (like pattern names) are normalized to have leading slashes.
+ */
+declare const setNonStrokingColorN: (...components: (number | string)[]) => Operator;
+/**
+ * Set the stroking color to a grayscale value.
+ *
+ * Equivalent to setStrokingColorSpace("DeviceGray"), setStrokingColor(gray).
+ *
+ * @param gray - Gray value (0 = black, 1 = white)
+ */
+declare const setStrokingGray: (gray: number) => Operator;
+/**
+ * Set the non-stroking (fill) color to a grayscale value.
+ *
+ * Equivalent to setNonStrokingColorSpace("DeviceGray"), setNonStrokingColor(gray).
+ *
+ * @param gray - Gray value (0 = black, 1 = white)
+ */
+declare const setNonStrokingGray: (gray: number) => Operator;
+/**
+ * Set the stroking color to an RGB value.
+ *
+ * Equivalent to setStrokingColorSpace("DeviceRGB"), setStrokingColor(r, g, b).
+ *
+ * @param r - Red component (0-1)
+ * @param g - Green component (0-1)
+ * @param b - Blue component (0-1)
+ */
+declare const setStrokingRGB: (r: number, g: number, b: number) => Operator;
+/**
+ * Set the non-stroking (fill) color to an RGB value.
+ *
+ * Equivalent to setNonStrokingColorSpace("DeviceRGB"), setNonStrokingColor(r, g, b).
+ *
+ * @param r - Red component (0-1)
+ * @param g - Green component (0-1)
+ * @param b - Blue component (0-1)
+ */
+declare const setNonStrokingRGB: (r: number, g: number, b: number) => Operator;
+/**
+ * Set the stroking color to a CMYK value.
+ *
+ * Equivalent to setStrokingColorSpace("DeviceCMYK"), setStrokingColor(c, m, y, k).
+ *
+ * @param c - Cyan component (0-1)
+ * @param m - Magenta component (0-1)
+ * @param y - Yellow component (0-1)
+ * @param k - Black component (0-1)
+ */
+declare const setStrokingCMYK: (c: number, m: number, y: number, k: number) => Operator;
+/**
+ * Set the non-stroking (fill) color to a CMYK value.
+ *
+ * Equivalent to setNonStrokingColorSpace("DeviceCMYK"), setNonStrokingColor(c, m, y, k).
+ *
+ * @param c - Cyan component (0-1)
+ * @param m - Magenta component (0-1)
+ * @param y - Yellow component (0-1)
+ * @param k - Black component (0-1)
+ */
+declare const setNonStrokingCMYK: (c: number, m: number, y: number, k: number) => Operator;
+/**
+ * @deprecated Use paintXObject instead. This alias exists for backwards compatibility.
+ */
+declare const drawXObject: (name: string) => Operator;
+/**
+ * Paint an XObject (image or Form XObject).
+ *
+ * XObjects are external objects that can be rendered in a content stream:
+ * - **Images**: Raster graphics (JPEG, PNG, etc.)
+ * - **Form XObjects**: Reusable vector content (stamps, watermarks, etc.)
+ *
+ * The XObject is painted at the current origin. Use concatMatrix to
+ * position, scale, and rotate before painting.
+ *
+ * @param name - XObject resource name (e.g., "Im0", "Fm0"); normalized to have leading slash
+ *
+ * @example
+ * ```typescript
+ * // Paint an image at 100x100 size at position (200, 500)
+ * page.drawOperators([
+ *   ops.pushGraphicsState(),
+ *   ops.concatMatrix(100, 0, 0, 100, 200, 500), // Scale and translate
+ *   ops.paintXObject(imageName),
+ *   ops.popGraphicsState(),
+ * ]);
+ *
+ * // Paint a form XObject (stamp) at original size
+ * page.drawOperators([
+ *   ops.pushGraphicsState(),
+ *   ops.concatMatrix(1, 0, 0, 1, 50, 700), // Just translate
+ *   ops.paintXObject(stampName),
+ *   ops.popGraphicsState(),
+ * ]);
+ * ```
+ */
+declare const paintXObject: (name: string) => Operator;
+/**
+ * Paint a shading (gradient) directly, filling the current clipping region.
+ *
+ * @param name - Shading resource name (e.g., "Sh0"); normalized to have leading slash
+ *
+ * @example
+ * ```typescript
+ * // Fill a rectangle with a gradient
+ * page.drawOperators([
+ *   ops.pushGraphicsState(),
+ *   ops.rectangle(50, 50, 100, 100),
+ *   ops.clip(),
+ *   ops.endPath(),
+ *   ops.paintShading(shadingName),
+ *   ops.popGraphicsState(),
+ * ]);
+ * ```
+ */
+declare const paintShading: (name: string) => Operator;
+/**
+ * Designate a marked content point (no content, just a tag).
+ *
+ * Used for structure and accessibility information.
+ *
+ * @param tag - Content tag name (e.g., "Artifact", "Figure")
+ */
+declare const designateMarkedContentPoint: (tag: string) => Operator;
+/**
+ * Designate a marked content point with properties.
+ *
+ * @param tag - Content tag name
+ * @param props - Property dictionary or property list name
+ */
+declare const designateMarkedContentPointProps: (tag: string, props: PdfDict | string) => Operator;
+/**
+ * Begin a marked content sequence.
+ *
+ * Content between beginMarkedContent() and endMarkedContent() is associated
+ * with the given tag for structure/accessibility purposes.
+ *
+ * @param tag - Content tag name (e.g., "P" for paragraph, "Span")
+ */
+declare const beginMarkedContent: (tag: string) => Operator;
+/**
+ * Begin a marked content sequence with properties.
+ *
+ * @param tag - Content tag name
+ * @param props - Property dictionary or property list name
+ */
+declare const beginMarkedContentProps: (tag: string, props: PdfDict | string) => Operator;
+/** End the current marked content sequence. */
+declare const endMarkedContent: () => Operator;
+//#endregion
+//#region src/helpers/colorspace.d.ts
+/**
+ * PDF color space constants for use with low-level drawing operators.
+ *
+ * These are the standard PDF color space names used with setStrokingColorSpace
+ * and setNonStrokingColorSpace operators.
+ */
+declare const ColorSpace: {
+  /** Device Gray color space (single component: 0-1) */
+  readonly DeviceGray: "DeviceGray";
+  /** Device RGB color space (three components: 0-1 each) */
+  readonly DeviceRGB: "DeviceRGB";
+  /** Device CMYK color space (four components: 0-1 each) */
+  readonly DeviceCMYK: "DeviceCMYK";
+  /** Pattern color space (for tiling patterns) */
+  readonly Pattern: "Pattern";
+};
+type ColorSpace = (typeof ColorSpace)[keyof typeof ColorSpace];
+//#endregion
 //#region src/helpers/pem.d.ts
 /**
  * PEM encoding/decoding utilities.
@@ -9428,5 +11433,5 @@ declare function isWidgetAnnotation(dict: PdfDict, registry?: ObjectRegistry): b
  */
 declare function isPopupAnnotation(dict: PdfDict, registry?: ObjectRegistry): boolean;
 //#endregion
-export { AnnotationFlags, type AnnotationSubtype, type AuthenticationResult, type BorderStyle, type BorderStyleType, type ButtonField, type CMYK, type CaretAnnotationOptions, type CaretSymbol, CertificateChainError, type CheckboxField, type CheckboxOptions, type CheckboxSymbol, type CircleAnnotationOptions, type Color, type CopyPagesOptions, CryptoKeySigner, type Degrees, type DestinationType, type DigestAlgorithm, type DocumentMetadata, type DrawCircleOptions, type DrawEllipseOptions, type DrawFieldOptions, type DrawImageOptions, type DrawLineOptions, type DrawPageOptions, type DrawRectangleOptions, type DrawSvgPathOptions, type DrawTextOptions, type DropdownField, type DropdownOptions, type EmbedFontOptions, type EmbeddedFont, type EncryptionAlgorithmOption, type ExtractPagesOptions, type FieldOptions, type FieldType, type FieldValue, type FileAttachmentIcon, type FlattenAllOptions, type FlattenAllResult, type FlattenAnnotationsOptions, type FlattenLayersResult, type FlattenOptions, type FontInput, type FormField, type FormProperties, type FreeTextAnnotationOptions, type FreeTextJustification, GoogleKmsSigner, type Grayscale, type HighlightMode, HttpTimestampAuthority, type HttpTimestampAuthorityOptions, type InkAnnotationOptions, type KeyType, KmsSignerError, type LayerInfo, type LayoutResult, type LineAnnotationOptions, type LineCap, type LineEndingStyle, type LineJoin, type LinkAction, type LinkAnnotationOptions, type LinkDestination, type ListBoxField, type ListboxOptions, type LoadOptions, type MergeOptions, P12Signer, type PAdESLevel, PDF, PDFAnnotation, PDFCaretAnnotation, PDFCircleAnnotation, PDFEmbeddedPage, PDFFileAttachmentAnnotation, PDFForm, PDFFreeTextAnnotation, PDFHighlightAnnotation, PDFImage, PDFInkAnnotation, PDFLineAnnotation, PDFLinkAnnotation, PDFMarkupAnnotation, PDFPage, PDFPolygonAnnotation, PDFPolylineAnnotation, PDFPopupAnnotation, PDFSquareAnnotation, PDFSquigglyAnnotation, PDFStampAnnotation, PDFStrikeOutAnnotation, PDFTextAnnotation, PDFTextMarkupAnnotation, PDFUnderlineAnnotation, PDFUnknownAnnotation, PathBuilder, type PathOptions, PdfArray, PdfBool, PdfDict, PdfName, PdfNull, PdfNumber, type PdfObject, PdfRef, PdfStream, PdfString, type PemBlock, PermissionDeniedError, type PermissionOptions, type Permissions, PlaceholderError, type Point, type PolygonAnnotationOptions, type PolylineAnnotationOptions, type PopupOptions, type PositionedWord, type ProtectionOptions, type RGB, type RadioField, type RadioGroupOptions, type RadioSymbol, type Rect, type Rectangle, type RemoveAnnotationsOptions, RevocationError, type RevocationProvider, type Rotation, type RotationOrigin, type RotationOriginName, STANDARD_STAMPS, type SaveOptions, SecurityError, type SecurityInfo, type SetTitleOptions, type SignOptions, type SignResult, type SignWarning, type SignatureAlgorithm, SignatureError, type SignatureField, type SignatureFieldOptions, type Signer, SignerError, type SquareAnnotationOptions, type StampAnnotationOptions, type StampName, Standard14Font, type Standard14FontName, StandardFonts, type SubFilter, type TextAlignment, type TextAnnotationIcon, type TextAnnotationOptions, type TextAnnotationState, type TextAnnotationStateModel, type TextField, type TextFieldOptions, type TextLine, type TextMarkupAnnotationOptions, type TimestampAuthority, TimestampError, type TrappedStatus, black, blue, cmyk, createAnnotation, degrees, grayscale, green, isPopupAnnotation, isWidgetAnnotation, layoutJustifiedLine, layoutText, lineCapToNumber, lineJoinToNumber, measureText, parsePem, rectToQuadPoints, rectsToQuadPoints, red, rgb, version, white };
+export { AnnotationFlags, type AnnotationSubtype, type AuthenticationResult, type AxialCoords, type AxialShadingOptions, type BBox, type BlendMode, type BorderStyle, type BorderStyleType, type ButtonField, type CMYK, type CaretAnnotationOptions, type CaretSymbol, CertificateChainError, type CheckboxField, type CheckboxOptions, type CheckboxSymbol, type CircleAnnotationOptions, type Color, ColorSpace, type ColorStop, type CopyPagesOptions, CryptoKeySigner, type Degrees, type DestinationType, type DigestAlgorithm, type DocumentMetadata, type DrawCircleOptions, type DrawEllipseOptions, type DrawFieldOptions, type DrawImageOptions, type DrawLineOptions, type DrawPageOptions, type DrawRectangleOptions, type DrawSvgPathOptions, type DrawTextOptions, type DropdownField, type DropdownOptions, type EmbedFontOptions, type EmbeddedFont, type EncryptionAlgorithmOption, type ExtGStateOptions, type ExtractPagesOptions, type FieldOptions, type FieldType, type FieldValue, type FileAttachmentIcon, type FlattenAllOptions, type FlattenAllResult, type FlattenAnnotationsOptions, type FlattenLayersResult, type FlattenOptions, type FontInput, type FormField, type FormProperties, type FormXObjectOptions, type FreeTextAnnotationOptions, type FreeTextJustification, GoogleKmsSigner, type Grayscale, type HighlightMode, HttpTimestampAuthority, type HttpTimestampAuthorityOptions, type ImagePatternOptions, type InkAnnotationOptions, type KeyType, KmsSignerError, type LayerInfo, type LayoutResult, type LineAnnotationOptions, type LineCap, type LineEndingStyle, type LineJoin, type LinearGradientOptions, type LinkAction, type LinkAnnotationOptions, type LinkDestination, type ListBoxField, type ListboxOptions, type LoadOptions, Matrix, type MergeOptions, P12Signer, type PAdESLevel, PDF, PDFAnnotation, PDFCaretAnnotation, PDFCircleAnnotation, PDFEmbeddedPage, type PDFExtGState, PDFFileAttachmentAnnotation, PDFForm, type PDFFormXObject, PDFFreeTextAnnotation, PDFHighlightAnnotation, PDFImage, PDFInkAnnotation, PDFLineAnnotation, PDFLinkAnnotation, PDFMarkupAnnotation, PDFPage, type PDFPattern, PDFPolygonAnnotation, PDFPolylineAnnotation, PDFPopupAnnotation, type PDFShading, type PDFShadingPattern, PDFSquareAnnotation, PDFSquigglyAnnotation, PDFStampAnnotation, PDFStrikeOutAnnotation, PDFTextAnnotation, PDFTextMarkupAnnotation, type PDFTilingPattern, PDFUnderlineAnnotation, PDFUnknownAnnotation, PathBuilder, type PathOptions, type PatternMatrix, PdfArray, PdfBool, PdfDict, PdfName, PdfNull, PdfNumber, type PdfObject, PdfRef, PdfStream, PdfString, type PemBlock, PermissionDeniedError, type PermissionOptions, type Permissions, PlaceholderError, type Point, type PolygonAnnotationOptions, type PolylineAnnotationOptions, type PopupOptions, type PositionedWord, type ProtectionOptions, type RGB, type RadialCoords, type RadialShadingOptions, type RadioField, type RadioGroupOptions, type RadioSymbol, type Rect, type Rectangle, type RemoveAnnotationsOptions, RevocationError, type RevocationProvider, type Rotation, type RotationOrigin, type RotationOriginName, STANDARD_STAMPS, type SaveOptions, SecurityError, type SecurityInfo, type SetTitleOptions, type ShadingPatternOptions, type SignOptions, type SignResult, type SignWarning, type SignatureAlgorithm, SignatureError, type SignatureField, type SignatureFieldOptions, type Signer, SignerError, type SquareAnnotationOptions, type StampAnnotationOptions, type StampName, Standard14Font, type Standard14FontName, StandardFonts, type SubFilter, type TextAlignment, type TextAnnotationIcon, type TextAnnotationOptions, type TextAnnotationState, type TextAnnotationStateModel, type TextField, type TextFieldOptions, type TextLine, type TextMarkupAnnotationOptions, type TilingPatternOptions, type TimestampAuthority, TimestampError, type TrappedStatus, black, blue, cmyk, createAnnotation, degrees, grayscale, green, isPopupAnnotation, isWidgetAnnotation, layoutJustifiedLine, layoutText, lineCapToNumber, lineJoinToNumber, measureText, operators_d_exports as ops, parsePem, rectToQuadPoints, rectsToQuadPoints, red, rgb, version, white };
 //# sourceMappingURL=index.d.mts.map