🤖 Merge PR DefinitelyTyped#72040 added type definitions for pdf2html by @manuzcheruz

Author: manuzcheruz

types/pdf2html/.npmignore

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

types/pdf2html/index.d.ts

@@ -0,0 +1,64 @@
+// Project: https://github.com/shebinleo/pdf2html
+// Definitions by: manuzcheruz <https://github.com/manuzcheruz>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+/// <reference types="node" />
+
+import { Stream } from "stream";
+
+/**
+ * Configuration options for PDF to HTML conversion
+ */
+interface PDF2HTMLOptions {
+    binary?: string; // Path to the pdftohtml binary
+    first_page?: number; // First page to convert
+    last_page?: number; // Last page to convert
+    complex?: boolean; // Generate complex output
+    single_page?: boolean; // Generate a single HTML file
+    no_background?: boolean; // No background images
+    no_frames?: boolean; // No frames in HTML
+    zoom?: number; // Zoom factor
+}
+
+/**
+ * Error type for PDF2HTML conversion errors
+ */
+interface PDF2HTMLError extends Error {
+    code?: string;
+    path?: string;
+    syscall?: string;
+}
+
+/**
+ * Callback function type for async operations
+ */
+type PDF2HTMLCallback = (error: PDF2HTMLError | null, html?: string) => void;
+
+/**
+ * Convert PDF file to HTML synchronously
+ * @param source - Path to PDF file or readable stream
+ * @param options - Conversion options
+ * @returns HTML string
+ */
+declare function pdf2htmlSync(source: string | Stream, options?: PDF2HTMLOptions): string;
+
+/**
+ * Convert PDF file to HTML asynchronously
+ * @param source - Path to PDF file or readable stream
+ * @param options - Conversion options
+ * @param callback - Callback function
+ */
+declare function pdf2html(source: string | Stream, options: PDF2HTMLOptions, callback: PDF2HTMLCallback): void;
+
+/**
+ * Convert PDF file to HTML asynchronously (overload without options)
+ * @param source - Path to PDF file or readable stream
+ * @param callback - Callback function
+ */
+declare function pdf2html(source: string | Stream, callback: PDF2HTMLCallback): void;
+
+declare namespace pdf2html {
+    export { pdf2htmlSync };
+}
+
+export = pdf2html;

types/pdf2html/package.json

@@ -0,0 +1,20 @@
+{
+  "private": true,
+  "name": "@types/pdf2html",
+  "version": "3.1.9999",
+  "projects": [
+      "https://github.com/shebinleo/pdf2html#readme"
+  ],
+  "dependencies": {
+      "@types/node": "*"
+  },
+  "devDependencies": {
+      "@types/pdf2html": "workspace:."
+  },
+  "owners": [
+      {
+          "name": "manuz cheruz",
+          "githubUsername": "manuzcheruz"
+      }
+  ]
+}

types/pdf2html/pdf2html-tests.ts

@@ -0,0 +1,55 @@
+import pdf2html = require('pdf2html');
+import { Readable } from 'stream';
+
+// Test async conversion with callback
+pdf2html('test.pdf', (error, html) => {
+    if (error) {
+        console.error(error);
+        return;
+    }
+    console.log(html);
+});
+
+// Test async conversion with options
+const options = {
+    binary: '/usr/local/bin/pdftohtml',
+    first_page: 1,
+    last_page: 10,
+    complex: true,
+    single_page: false,
+    no_background: true,
+    no_frames: true,
+    zoom: 1.5
+};
+
+pdf2html('test.pdf', options, (error, html) => {
+    if (error) {
+        console.error(error);
+        return;
+    }
+    console.log(html);
+});
+
+// Test sync conversion
+const htmlSync = pdf2html.pdf2htmlSync('test.pdf');
+console.log(htmlSync);
+
+// Test with stream input
+const stream = new Readable();
+stream.push('PDF content');
+stream.push(null);
+
+pdf2html(stream, (error, html) => {
+    if (error) {
+        console.error(error);
+        return;
+    }
+    console.log(html);
+});
+
+// Test sync conversion with stream and options
+const htmlStreamSync = pdf2html.pdf2htmlSync(stream, {
+    complex: true,
+    zoom: 2.0
+});
+console.log(htmlStreamSync);

types/pdf2html/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",
+      "pdf2html-tests.ts"
+  ]
+}