@libpdf/core 0.0.1-beta.12 → 0.0.1-beta.14

package/dist/index.d.mts

@@ -2696,6 +2696,40 @@ declare class EmbeddedFont extends PdfFont {
    * type any character at runtime).
    */
   canSubset(): boolean;
+  /**
+   * Get width of text in points at a given font size.
+   *
+   * Alias for getTextWidth() to match Standard14Font API.
+   *
+   * @param text - The text to measure
+   * @param size - Font size in points
+   * @returns Width in points
+   */
+  widthOfTextAtSize(text: string, size: number): number;
+  /**
+   * Get the height of the font at a given size.
+   *
+   * This returns the full height from descender to ascender.
+   *
+   * @param size - Font size in points
+   * @returns Height in points
+   */
+  heightAtSize(size: number): number;
+  /**
+   * Calculate font size needed to achieve a specific text height.
+   *
+   * @param height - Desired height in points
+   * @returns Font size in points
+   */
+  sizeAtHeight(height: number): number;
+  /**
+   * Calculate font size needed for text to fit a specific width.
+   *
+   * @param text - The text to measure
+   * @param width - Desired width in points
+   * @returns Font size in points
+   */
+  sizeAtWidth(text: string, width: number): number;
   /**
    * Build a FontDescriptor from the font program.
    */
@@ -3753,17 +3787,30 @@ type LineCap = "butt" | "round" | "square";
  * - "bevel": Beveled corner (2)
  */
 type LineJoin = "miter" | "round" | "bevel";
+/**
+ * Named rotation origin positions.
+ * These are relative to the bounding box of the object being rotated.
+ */
+type RotationOriginName = "top-left" | "top-center" | "top-right" | "center-left" | "center" | "center-right" | "bottom-left" | "bottom-center" | "bottom-right";
+/**
+ * Rotation origin - either explicit coordinates or a named position.
+ */
+type RotationOrigin = {
+  x: number;
+  y: number;
+} | RotationOriginName;
 /**
  * Rotation specification.
  */
 interface Rotation {
   /** Rotation angle in degrees (counter-clockwise) */
   angle: number;
-  /** Rotation center point (default: object center) */
-  origin?: {
-    x: number;
-    y: number;
-  };
+  /**
+   * Rotation center point.
+   * Can be explicit coordinates `{ x, y }` or a named position like "center", "top-left", etc.
+   * Default varies by object type (usually center for shapes, bottom-left for text).
+   */
+  origin?: RotationOrigin;
 }
 /**
  * Font type - either a Standard 14 font name or an embedded font.
@@ -5848,6 +5895,16 @@ interface RemoveAnnotationsOptions {
 interface FlattenAnnotationsOptions {
   /** Annotation types to exclude from flattening */
   exclude?: AnnotationSubtype[];
+  /**
+   * Remove Link annotations instead of keeping them.
+   *
+   * Link annotations contain URI or other actions that Adobe considers
+   * "hidden behavior" which can cause signature validation warnings.
+   * Enable this option when preparing documents for signing.
+   *
+   * @default false
+   */
+  removeLinks?: boolean;
 }
 //#endregion
 //#region src/attachments/types.d.ts
@@ -7637,6 +7694,24 @@ declare class PDF {
   static merge(sources: Uint8Array[], options?: MergeOptions): Promise<PDF>;
   /** PDF version string (e.g., "1.7", "2.0") */
   get version(): string;
+  /**
+   * Upgrade the PDF version.
+   *
+   * Sets the /Version entry in the catalog dictionary. This is the standard
+   * way to upgrade PDF version in incremental updates since the header
+   * cannot be modified.
+   *
+   * The version will only be upgraded if the new version is higher than
+   * the current version.
+   *
+   * @param version - Target version (e.g., "1.7", "2.0")
+   *
+   * @example
+   * ```typescript
+   * pdf.upgradeVersion("1.7");
+   * ```
+   */
+  upgradeVersion(version: string): void;
   /** Whether the document is encrypted */
   get isEncrypted(): boolean;
   /** Whether authentication succeeded (for encrypted docs) */
@@ -8572,12 +8647,6 @@ declare class PDF {
    * Used by signing to chain incremental updates.
    */
   private saveInternal;
-  /**
-   * Ensure all reachable objects are loaded into the registry.
-   *
-   * Walks from the catalog to load all referenced objects.
-   */
-  private ensureObjectsLoaded;
 }
 //#endregion
 //#region src/signatures/signers/crypto-key.d.ts
@@ -8727,35 +8796,50 @@ declare class GoogleKmsSigner implements Signer {
    */
   static create(options: GoogleKmsSignerOptions): Promise<GoogleKmsSigner>;
   /**
-   * Load a certificate from Google Secret Manager.
+   * Loads a signing certificate from Google Secret Manager for use with KMS-based signing.
    *
-   * The secret must contain a DER-encoded certificate. PEM format is NOT supported -
-   * convert to DER before storing in Secret Manager.
+   * This helper retrieves certificate material securely stored in Secret Manager, supporting
+   * both PEM and DER formats:
+   *   - If the secret contains PEM-encoded data, all certificates will be parsed.
+   *     The first is used as the signing cert (`cert`), and the remainder returned as
+   *     the optional `chain` (intermediates).
+   *   - If the secret contains raw DER data, it is returned as the signing cert (`cert`).
    *
-   * Supports cross-project access: the secret can be in a different GCP project
-   * than the KMS key.
+   * Supports cross-project use: the secret may be in a different GCP project than the KMS key.
    *
-   * @param secretVersionName - Full resource name, e.g.
-   *   "projects/my-project/secrets/my-cert/versions/latest"
-   * @param options - Optional client configuration
-   * @throws {KmsSignerError} if @google-cloud/secret-manager is not installed
+   * - The secret should contain the certificate in binary DER (recommended) or PEM format.
+   * - Private keys must never be stored in Secret Manager.
+   *
+   * @param secretVersionName Full resource name for the secret version,
+   *   e.g. "projects/my-project/secrets/my-cert/versions/latest"
+   * @param options Optional client configuration, including a SecretManagerServiceClient instance.
+   * @returns An object with `cert` (main certificate bytes) and optional `chain` (intermediates).
+   * @throws {KmsSignerError} if @google-cloud/secret-manager is not installed or retrieval fails.
    *
    * @example
-   * ```typescript
-   * // From same project
-   * const cert = await GoogleKmsSigner.getCertificateFromSecretManager(
+   * // Load a certificate from the same project
+   * const { cert } = await GoogleKmsSigner.getCertificateFromSecretManager(
    *   "projects/my-project/secrets/signing-cert/versions/latest"
    * );
    *
-   * // From different project (cross-project access)
-   * const cert = await GoogleKmsSigner.getCertificateFromSecretManager(
-   *   "projects/shared-certs-project/secrets/signing-cert/versions/1"
+   * // Load from a different project (cross-project access)
+   * const { cert, chain } = await GoogleKmsSigner.getCertificateFromSecretManager(
+   *   "projects/shared-certs-project/secrets/org-ca-cert/versions/1"
    * );
-   * ```
+   *
+   * // Use the result with KMS-based signing
+   * const signer = await GoogleKmsSigner.create({
+   *   keyVersionName: "...",
+   *   certificate: cert,
+   *   chain,
+   * });
    */
   static getCertificateFromSecretManager(secretVersionName: string, options?: {
     client?: SecretManagerServiceClient;
-  }): Promise<Uint8Array>;
+  }): Promise<{
+    cert: Uint8Array;
+    chain?: Uint8Array[];
+  }>;
   /**
    * Sign data using the KMS key.
    *
@@ -8968,6 +9052,67 @@ declare class HttpTimestampAuthority implements TimestampAuthority {
   private parseTimestampResponse;
 }
 //#endregion
+//#region src/fonts/standard-14-font.d.ts
+/**
+ * A wrapper class for Standard 14 fonts that provides measurement methods.
+ *
+ * Standard 14 fonts don't need to be embedded - they're built into PDF readers.
+ * This class provides the same measurement API as EmbeddedFont.
+ */
+declare class Standard14Font {
+  /** The Standard 14 font name */
+  readonly name: Standard14FontName;
+  /** Cached metrics */
+  private readonly metrics;
+  private constructor();
+  /**
+   * Create a Standard14Font instance.
+   *
+   * @param name - The Standard 14 font name (e.g., "Helvetica", "Times-Bold")
+   * @returns Standard14Font instance
+   * @throws {Error} if name is not a valid Standard 14 font
+   *
+   * @example
+   * ```typescript
+   * const helvetica = Standard14Font.of("Helvetica");
+   * const timesBold = Standard14Font.of("Times-Bold");
+   * ```
+   */
+  static of(name: Standard14FontName): Standard14Font;
+  /**
+   * Get width of text in points at a given font size.
+   *
+   * @param text - The text to measure
+   * @param size - Font size in points
+   * @returns Width in points
+   */
+  widthOfTextAtSize(text: string, size: number): number;
+  /**
+   * Get the height of the font at a given size.
+   *
+   * This returns the full height from descender to ascender.
+   *
+   * @param size - Font size in points
+   * @returns Height in points
+   */
+  heightAtSize(size: number): number;
+  /**
+   * Calculate font size needed to achieve a specific text height.
+   *
+   * @param height - Desired height in points
+   * @returns Font size in points
+   */
+  sizeAtHeight(height: number): number;
+  /**
+   * Calculate font size needed for text to fit a specific width.
+   *
+   * @param text - The text to measure
+   * @param width - Desired width in points
+   * @returns Font size in points
+   */
+  sizeAtWidth(text: string, width: number): number;
+}
+//#endregion
 //#region src/api/drawing/text-layout.d.ts
 /**
  * A single line of laid out text.
@@ -9095,5 +9240,5 @@ declare function isWidgetAnnotation(dict: PdfDict): boolean;
  */
 declare function isPopupAnnotation(dict: PdfDict): 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 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, 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, type Standard14FontName, StandardFonts, type SubFilter, 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 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 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, 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 };
 //# sourceMappingURL=index.d.mts.map