@build-qube/papyra-native-wasm32-wasi 0.1.0 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@build-qube/papyra-native-wasm32-wasi",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "main": "papyra.wasi.cjs",
   "files": [
     "papyra.wasm32-wasi.wasm",

package/papyra.wasi.d.cts

@@ -33,6 +33,8 @@ export declare class PdfDocument {
   /** Load an encrypted PDF. */
   static loadWithPassword(data: Uint8Array, password: string): PdfDocument
   get pageCount(): number
+  /** The PDF specification version the file declares, e.g. `"1.7"`. */
+  get pdfVersion(): string | null
   pageSize(index: number): PageDimensions
   /** Render one page on the calling thread. Blocks; prefer `renderPageAsync`. */
   renderPage(index: number, dpi?: number | undefined | null): RenderedPage
@@ -40,6 +42,13 @@ export declare class PdfDocument {
   renderPageAsync(index: number, dpi?: number | undefined | null): Promise<RenderedPage>
   /** Render one page and keep it in Rust, for encoding. The pixels never reach JS. */
   renderPageImageAsync(index: number, dpi?: number | undefined | null, signal?: AbortSignal | undefined | null): Promise<PageImage>
+  /**
+   * Convert one page to a standalone SVG document, off the JS thread.
+   *
+   * There is no DPI: an SVG carries the page's own point dimensions and rasterises at
+   * whatever size it is drawn.
+   */
+  renderPageSvgAsync(index: number, whiteBackground?: boolean | undefined | null, signal?: AbortSignal | undefined | null): Promise<string>
   /** Extract the text of one page, off the JS thread. */
   pageTextAsync(index: number): Promise<PageText>
   /** Extract `[start, end)` in one async task, parallelised internally with rayon. */
@@ -51,6 +60,24 @@ export declare class PdfDocument {
    * common case.
    */
   outline(): Promise<Array<OutlineEntry>>
+  /**
+   * Read the document information dictionary.
+   *
+   * Synchronous: hayro parses it while loading, so this only decodes eight strings.
+   */
+  info(): DocumentInfo
+  /**
+   * Read the links on one page.
+   *
+   * Resolves to an empty array for a page with no links, which is most pages.
+   */
+  pageLinks(index: number): Promise<Array<PageLink>>
+  /**
+   * Read the label printed on each page, one entry per page.
+   *
+   * Resolves to an empty array when the document defines no `/PageLabels`.
+   */
+  pageLabels(): Promise<Array<string>>
   /** Render `[start, end)` in one async task, parallelised internally with rayon. */
   renderPagesAsync(start: number, end: number, dpi?: number | undefined | null): Promise<Array<RenderedPage>>
 }
@@ -67,6 +94,21 @@ export declare function backendName(): string
  */
 export declare function configureThreadPool(threads: number, stackSizeMb?: number | undefined | null): number
 
+/** The document information dictionary. Every field is independently optional. */
+export interface DocumentInfo {
+  title?: string
+  author?: string
+  subject?: string
+  keywords?: string
+  /** The application that authored the original document, e.g. `AutoCAD`. */
+  creator?: string
+  /** The application that wrote the PDF itself, e.g. `Ghostscript`. */
+  producer?: string
+  /** ISO 8601, converted from the PDF's own date form. */
+  created?: string
+  modified?: string
+}
+
 /** Encode a raw RGBA8 buffer off the JS thread. */
 export declare function encodeBitmap(data: Uint8Array, width: number, height: number, stride: number, format: ImageFormat, quality?: number | undefined | null, signal?: AbortSignal | undefined | null): Promise<Uint8Array>
 
@@ -123,6 +165,26 @@ export interface PageDimensions {
   height: number
 }
 
+/**
+ * One link annotation.
+ *
+ * The rectangle is in the page-as-rendered space — pixels from the top-left at
+ * 72 DPI, rotation and crop box applied — so it is the same space as `PageText` and
+ * scales to any render with one multiply.
+ */
+export interface PageLink {
+  x0: number
+  y0: number
+  x1: number
+  y1: number
+  /** Set when the link points into this document; `uri` is then absent. */
+  dest?: OutlineDestination
+  /** Set when the link points at a URI; `dest` is then absent. */
+  uri?: string
+  /** The annotation's `/Contents` — its tooltip. Usually absent. */
+  alt?: string
+}
+
 /**
  * The text of one page.
  *