🤖 Merge PR DefinitelyTyped#72030 added pdf2docx typescript definitions by @manuzcheruz

Author: manuzcheruz

types/pdf2docx/.npmignore

@@ -0,0 +1,5 @@
+*
+!**/*.d.ts
+!**/*.d.cts
+!**/*.d.mts
+!**/*.d.*.ts

types/pdf2docx/index.d.ts

@@ -0,0 +1,98 @@
+// Project: https://www.npmjs.com/package/pdf2docx
+// Definitions by: manuzcheruz <https://github.com/manuzcheruz>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+/// <reference types="node" />
+
+export class Parser {
+  /**
+   * Creates an instance of Parser for PDF processing
+   * @param pdf_file Path to the PDF file or Buffer containing PDF data
+   * @param password Optional password for encrypted PDF
+   */
+  constructor(pdf_file: string | Buffer, password?: string);
+
+  /**
+   * Parse and convert PDF to DOCX
+   * @param docx_file Output DOCX file path
+   * @param options Conversion options
+   * @returns Promise resolving to parsing status
+   */
+  parse(docx_file: string, options?: ConversionOptions): Promise<ParsingStatus>;
+
+  /**
+   * Convert a specific range of pages
+   * @param docx_file Output DOCX file path
+   * @param start_page Starting page number (1-based)
+   * @param end_page Ending page number (1-based)
+   * @param options Conversion options
+   * @returns Promise resolving to parsing status
+   */
+  parsePages(
+      docx_file: string,
+      start_page: number,
+      end_page: number,
+      options?: ConversionOptions
+  ): Promise<ParsingStatus>;
+}
+
+export interface ConversionOptions {
+  start?: number;
+  end?: number;
+  pages?: number[];
+  password?: string;
+  tables?: TableOptions;
+  images?: ImageOptions;
+  font_settings?: FontSettings;
+  page_margin?: MarginSettings;
+}
+
+export interface TableOptions {
+  extract_tables?: boolean;
+  cell_border_width?: number;
+  cell_margin?: number;
+}
+
+export interface ImageOptions {
+  extract_images?: boolean;
+  max_width?: number;
+  max_height?: number;
+}
+
+export interface FontSettings {
+  default_font_size?: number;
+  default_font_family?: string;
+  text_direction?: 'horizontal' | 'vertical';
+}
+
+export interface MarginSettings {
+  top?: number;
+  bottom?: number;
+  left?: number;
+  right?: number;
+}
+
+export interface ParsingStatus {
+  pages_processed: number;
+  status: string;
+  errors?: ParseError[];
+}
+
+export interface ParseError {
+  message: string;
+  page?: number;
+  code?: string;
+}
+
+/**
+* Convert PDF to DOCX
+* @param pdf_file Input PDF file path or Buffer
+* @param docx_file Output DOCX file path
+* @param options Conversion options
+* @returns Promise resolving to parsing status
+*/
+export function convert(
+  pdf_file: string | Buffer,
+  docx_file: string,
+  options?: ConversionOptions
+): Promise<ParsingStatus>;

types/pdf2docx/package.json

@@ -0,0 +1,20 @@
+{
+  "private": true,
+  "name": "@types/pdf2docx",
+  "version": "0.0.9999",
+  "projects": [
+      "https://www.npmjs.com/package/pdf2docx"
+  ],
+  "dependencies": {
+      "@types/node": "*"
+  },
+  "devDependencies": {
+      "@types/pdf2docx": "workspace:."
+  },
+  "owners": [
+      {
+          "name": "manuz cheruz",
+          "githubUsername": "manuzcheruz"
+      }
+  ]
+}

types/pdf2docx/pdf2docx-tests.ts

@@ -0,0 +1,25 @@
+import { Parser, convert } from 'pdf2docx';
+
+// Test the Parser class
+const parser = new Parser('test.pdf');
+parser.parse('output.docx', {
+    start: 1,
+    end: 5,
+    tables: {
+        extract_tables: true,
+        cell_border_width: 1
+    }
+}).then(status => {
+    console.log(`Processed ${status.pages_processed} pages`);
+});
+
+// Test the convert function
+convert('input.pdf', 'output.docx', {
+    pages: [1, 2, 3],
+    images: {
+        extract_images: true,
+        max_width: 800
+    }
+}).then(status => {
+    console.log(status.status);
+});

types/pdf2docx/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+      "module": "commonjs",
+      "lib": [
+          "es6"
+      ],
+      "strictFunctionTypes": true,
+      "noImplicitAny": true,
+      "noImplicitThis": true,
+      "strictNullChecks": true,
+      "types": [],
+      "noEmit": true,
+      "forceConsistentCasingInFileNames": true
+  },
+  "files": [
+      "index.d.ts",
+      "pdf2docx-tests.ts"
+  ]
+}