@cj-tech-master/excelts 8.0.0 → 8.1.0

package/dist/browser/modules/pdf/reader/font-decoder.d.ts

@@ -0,0 +1,58 @@
+/**
+ * PDF font decoder for text extraction.
+ *
+ * Handles the mapping from character codes in content streams to Unicode
+ * strings. Supports all major PDF font types:
+ *
+ * - Type 1 fonts (standard 14 + custom with /Encoding)
+ * - TrueType fonts (with /Encoding and /ToUnicode)
+ * - Type 0 (CID) composite fonts (with /ToUnicode CMap)
+ * - Type 3 fonts (with /Encoding and /ToUnicode)
+ *
+ * @see PDF Reference 1.7, Chapter 5 - Text
+ * @see PDF Reference 1.7, §5.5 - Character Encoding
+ */
+import type { CMap } from "./cmap-parser.js";
+import type { PdfDocument } from "./pdf-document.js";
+import type { PdfDictValue } from "./pdf-parser.js";
+/**
+ * A resolved font used for text extraction.
+ */
+export interface ResolvedFont {
+    /** Font name */
+    name: string;
+    /** Font subtype: Type1, TrueType, Type0, Type3, CIDFontType0, CIDFontType2, MMType1 */
+    subtype: string;
+    /** ToUnicode CMap (if available) */
+    toUnicode: CMap | null;
+    /** Encoding lookup: char code → unicode string */
+    encoding: Map<number, string>;
+    /** Number of bytes per character code (1 for simple fonts, 1-2 for CID fonts) */
+    bytesPerCode: number;
+    /** Base font name */
+    baseFontName: string;
+    /** Whether this is a symbolic font */
+    isSymbolic: boolean;
+    /** Character widths (code → width in thousandths of text space units) */
+    widths: Map<number, number>;
+    /** Default width */
+    defaultWidth: number;
+    /** Missing width for characters not in widths table */
+    missingWidth: number;
+    /** Whether the font uses Identity-H or Identity-V encoding (codes are Unicode code points) */
+    isIdentityEncoding: boolean;
+    /** Writing mode: 0 = horizontal, 1 = vertical */
+    wmode: number;
+}
+/**
+ * Resolve a PDF font dictionary into a ResolvedFont for text extraction.
+ */
+export declare function resolveFont(fontDict: PdfDictValue, doc: PdfDocument): ResolvedFont;
+/**
+ * Decode character codes to Unicode text using a resolved font.
+ */
+export declare function decodeText(codes: Uint8Array, font: ResolvedFont): string;
+/**
+ * Get the character width for a given code.
+ */
+export declare function getCharWidth(code: number, font: ResolvedFont): number;