@lexmata/micropdf 0.4.0

package/dist/font.js

@@ -0,0 +1,381 @@
+/**
+ * Font - PDF font handling
+ *
+ * This module provides 100% API compatibility with MuPDF's font operations.
+ * Handles font loading, glyph encoding, metrics, and rendering.
+ */
+import { getDefaultContext } from './context.js';
+import { Rect } from './geometry.js';
+import { native } from './native.js';
+/**
+ * Font flags
+ */
+export var FontFlags;
+(function (FontFlags) {
+    FontFlags[FontFlags["Bold"] = 1] = "Bold";
+    FontFlags[FontFlags["Italic"] = 2] = "Italic";
+    FontFlags[FontFlags["Serif"] = 4] = "Serif";
+    FontFlags[FontFlags["Monospaced"] = 8] = "Monospaced";
+    FontFlags[FontFlags["Embedded"] = 16] = "Embedded";
+})(FontFlags || (FontFlags = {}));
+/**
+ * A PDF font
+ */
+export class Font {
+    _ctx;
+    _font;
+    _name;
+    _flags = 0;
+    _bbox = Rect.EMPTY;
+    _ascender = 1000;
+    _descender = -200;
+    _refCount = 1;
+    _glyphs = new Map();
+    _encoding = new Map(); // unicode -> glyph
+    constructor(name, flags) {
+        this._name = name;
+        if (flags !== undefined) {
+            this._flags = flags;
+        }
+    }
+    /**
+     * @internal Check if FFI bindings are available
+     */
+    get hasNativeHandle() {
+        return this._ctx !== undefined && this._font !== undefined;
+    }
+    /**
+     * Create a new font
+     */
+    static create(name, flags) {
+        return new Font(name, flags);
+    }
+    /**
+     * Create font from memory buffer using FFI
+     * @throws Error when native bindings are not available
+     */
+    static createFromMemory(name, data) {
+        const ctx = getDefaultContext()?._nativeCtx;
+        if (!ctx) {
+            throw new Error('Font creation from memory requires native FFI bindings (fz_new_font_from_memory)');
+        }
+        const font = new Font(name);
+        font._ctx = ctx;
+        font._font = native.loadFontFromMemory(ctx, Buffer.from(data), 0);
+        return font;
+    }
+    /**
+     * Create font from file using FFI
+     * @throws Error when native bindings are not available
+     */
+    static createFromFile(path) {
+        const ctx = getDefaultContext()?._nativeCtx;
+        if (!ctx) {
+            throw new Error('Font loading from file requires native FFI bindings (fz_new_font_from_file)');
+        }
+        const name = path
+            .split('/')
+            .pop()
+            ?.replace(/\.[^.]+$/, '') || 'Unknown';
+        const font = new Font(name);
+        font._ctx = ctx;
+        font._font = native.loadFontFromFile(ctx, path, 0);
+        return font;
+    }
+    // ============================================================================
+    // Reference Counting
+    // ============================================================================
+    keep() {
+        this._refCount++;
+        return this;
+    }
+    drop() {
+        if (this._refCount > 0) {
+            this._refCount--;
+        }
+    }
+    /**
+     * Clone this font
+     */
+    clone() {
+        const cloned = new Font(this._name, this._flags);
+        cloned._bbox = this._bbox;
+        cloned._ascender = this._ascender;
+        cloned._descender = this._descender;
+        cloned._glyphs = new Map(this._glyphs);
+        cloned._encoding = new Map(this._encoding);
+        return cloned;
+    }
+    // ============================================================================
+    // Properties
+    // ============================================================================
+    get name() {
+        return this._name;
+    }
+    /**
+     * Check if font is bold
+     */
+    isBold() {
+        return (this._flags & FontFlags.Bold) !== 0;
+    }
+    /**
+     * Check if font is italic
+     */
+    isItalic() {
+        return (this._flags & FontFlags.Italic) !== 0;
+    }
+    /**
+     * Check if font is serif
+     */
+    isSerif() {
+        return (this._flags & FontFlags.Serif) !== 0;
+    }
+    /**
+     * Check if font is monospaced
+     */
+    isMonospaced() {
+        return (this._flags & FontFlags.Monospaced) !== 0;
+    }
+    /**
+     * Check if font is embedded
+     */
+    isEmbedded() {
+        return (this._flags & FontFlags.Embedded) !== 0;
+    }
+    /**
+     * Get font flags
+     */
+    get flags() {
+        return this._flags;
+    }
+    // ============================================================================
+    // Metrics
+    // ============================================================================
+    /**
+     * Get font bounding box
+     */
+    getBBox() {
+        return this._bbox;
+    }
+    /**
+     * Set font bounding box
+     */
+    setBBox(bbox) {
+        this._bbox = Rect.from(bbox);
+    }
+    /**
+     * Get font ascender (distance above baseline)
+     */
+    getAscender() {
+        return this._ascender;
+    }
+    /**
+     * Set font ascender
+     */
+    setAscender(ascender) {
+        this._ascender = ascender;
+    }
+    /**
+     * Get font descender (distance below baseline)
+     */
+    getDescender() {
+        return this._descender;
+    }
+    /**
+     * Set font descender
+     */
+    setDescender(descender) {
+        this._descender = descender;
+    }
+    // ============================================================================
+    // Character Encoding
+    // ============================================================================
+    /**
+     * Encode a Unicode character to a glyph ID
+     */
+    encodeCharacter(unicode) {
+        return this._encoding.get(unicode) || 0;
+    }
+    /**
+     * Encode character with fallback
+     */
+    encodeCharacterWithFallback(unicode, fallback = 0) {
+        return this._encoding.get(unicode) || fallback;
+    }
+    /**
+     * Set character encoding
+     */
+    setEncoding(unicode, glyph) {
+        this._encoding.set(unicode, glyph);
+    }
+    // ============================================================================
+    // Glyph Operations
+    // ============================================================================
+    /**
+     * Get glyph advance width
+     */
+    advanceGlyph(glyph, wmode = 0) {
+        const info = this._glyphs.get(glyph);
+        if (info) {
+            return wmode === 0 ? info.advanceX : info.advanceY;
+        }
+        // Default advance for unknown glyphs
+        return 500;
+    }
+    /**
+     * Get glyph bounding box
+     */
+    boundGlyph(glyph) {
+        const info = this._glyphs.get(glyph);
+        return info?.bbox || Rect.EMPTY;
+    }
+    /**
+     * Get glyph outline as a path
+     */
+    outlineGlyph(glyph) {
+        const info = this._glyphs.get(glyph);
+        return info?.outline || null;
+    }
+    /**
+     * Get glyph name
+     */
+    glyphName(glyph) {
+        const info = this._glyphs.get(glyph);
+        return info?.name || `.notdef`;
+    }
+    /**
+     * Add glyph info
+     */
+    addGlyph(glyph, info) {
+        this._glyphs.set(glyph, info);
+    }
+    /**
+     * Get glyph info
+     */
+    getGlyphInfo(glyph) {
+        return this._glyphs.get(glyph);
+    }
+    // ============================================================================
+    // Validation
+    // ============================================================================
+    /**
+     * Check if font is valid
+     */
+    isValid() {
+        return this._name.length > 0;
+    }
+    // ============================================================================
+    // Text Measurement
+    // ============================================================================
+    /**
+     * Measure text width
+     */
+    measureText(text, size = 12) {
+        let width = 0;
+        for (let i = 0; i < text.length; i++) {
+            const unicode = text.charCodeAt(i);
+            const glyph = this.encodeCharacter(unicode);
+            const advance = this.advanceGlyph(glyph);
+            width += advance;
+        }
+        return (width * size) / 1000; // Scale from font units to points
+    }
+    /**
+     * Get text bounding box
+     */
+    measureTextBounds(text, size = 12) {
+        let width = 0;
+        let minY = 0;
+        let maxY = 0;
+        for (let i = 0; i < text.length; i++) {
+            const unicode = text.charCodeAt(i);
+            const glyph = this.encodeCharacter(unicode);
+            const advance = this.advanceGlyph(glyph);
+            const bbox = this.boundGlyph(glyph);
+            minY = Math.min(minY, bbox.y0);
+            maxY = Math.max(maxY, bbox.y1);
+            width += advance;
+        }
+        const scale = size / 1000;
+        return new Rect(0, minY * scale, width * scale, maxY * scale);
+    }
+}
+/**
+ * Font manager for loading and caching fonts
+ */
+export class FontManager {
+    _fonts = new Map();
+    _defaultFont = null;
+    constructor() {
+        // Create default font
+        this._defaultFont = Font.create('Helvetica');
+        this._fonts.set('Helvetica', this._defaultFont);
+    }
+    /**
+     * Get the singleton instance
+     */
+    static _instance = null;
+    static getInstance() {
+        if (!FontManager._instance) {
+            FontManager._instance = new FontManager();
+        }
+        return FontManager._instance;
+    }
+    /**
+     * Load a font by name
+     */
+    loadFont(name) {
+        return this._fonts.get(name) || null;
+    }
+    /**
+     * Register a font
+     */
+    registerFont(name, font) {
+        this._fonts.set(name, font);
+    }
+    /**
+     * Get default font
+     */
+    getDefaultFont() {
+        return this._defaultFont;
+    }
+    /**
+     * Set default font
+     */
+    setDefaultFont(font) {
+        this._defaultFont = font;
+    }
+    /**
+     * Get all registered font names
+     */
+    getFontNames() {
+        return [...this._fonts.keys()];
+    }
+    /**
+     * Clear all fonts
+     */
+    clear() {
+        this._fonts.clear();
+        this._defaultFont = null;
+    }
+}
+/**
+ * Standard PDF font names
+ */
+export const StandardFonts = {
+    TimesRoman: 'Times-Roman',
+    TimesBold: 'Times-Bold',
+    TimesItalic: 'Times-Italic',
+    TimesBoldItalic: 'Times-BoldItalic',
+    Helvetica: 'Helvetica',
+    HelveticaBold: 'Helvetica-Bold',
+    HelveticaOblique: 'Helvetica-Oblique',
+    HelveticaBoldOblique: 'Helvetica-BoldOblique',
+    Courier: 'Courier',
+    CourierBold: 'Courier-Bold',
+    CourierOblique: 'Courier-Oblique',
+    CourierBoldOblique: 'Courier-BoldOblique',
+    Symbol: 'Symbol',
+    ZapfDingbats: 'ZapfDingbats'
+};
+//# sourceMappingURL=font.js.map

package/dist/font.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"font.js","sourceRoot":"","sources":["../src/font.ts"],"names":[],"mappings":"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"}

package/dist/form.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Form - PDF form/AcroForm handling
+ *
+ * This module provides 100% API compatibility with MuPDF's form operations.
+ * Supports text fields, checkboxes, radio buttons, combo boxes, and signatures.
+ */
+import { Rect, type RectLike } from './geometry.js';
+/**
+ * PDF form field types
+ */
+export declare enum FieldType {
+    Unknown = 0,
+    PushButton = 1,
+    CheckBox = 2,
+    RadioButton = 3,
+    Text = 4,
+    Choice = 5,
+    Signature = 6
+}
+/**
+ * Field alignment values
+ */
+export declare enum FieldAlignment {
+    Left = 0,
+    Center = 1,
+    Right = 2
+}
+/**
+ * Field flags (bit flags)
+ */
+export declare enum FieldFlags {
+    ReadOnly = 1,
+    Required = 2,
+    NoExport = 4,
+    Multiline = 4096,
+    Password = 8192,
+    NoToggleToOff = 16384,
+    Radio = 32768,
+    Pushbutton = 65536,
+    Combo = 131072,
+    Edit = 262144,
+    Sort = 524288,
+    FileSelect = 1048576,
+    MultiSelect = 2097152,
+    DoNotSpellCheck = 4194304,
+    DoNotScroll = 8388608,
+    Comb = 16777216,
+    RadiosInUnison = 33554432,
+    CommitOnSelChange = 67108864
+}
+/**
+ * Choice option for combo box or list box
+ */
+export interface ChoiceOption {
+    label: string;
+    value: string;
+}
+/**
+ * A form field (widget annotation)
+ */
+export declare class FormField {
+    private _name;
+    private _type;
+    private _value;
+    private _defaultValue;
+    private _rect;
+    private _flags;
+    private _maxLen;
+    private _choices;
+    private _selectedIndex;
+    private _borderWidth;
+    private _borderColor;
+    private _bgColor;
+    private _fontSize;
+    private _alignment;
+    private _refCount;
+    private _valid;
+    constructor(name: string, type: FieldType, rect: RectLike);
+    keep(): this;
+    drop(): void;
+    /**
+     * Clone this field
+     */
+    clone(): FormField;
+    get name(): string;
+    get type(): FieldType;
+    get rect(): Rect;
+    set rect(r: RectLike);
+    get value(): string;
+    set value(val: string);
+    get defaultValue(): string;
+    set defaultValue(val: string);
+    get flags(): number;
+    set flags(f: number);
+    hasFlag(flag: FieldFlags): boolean;
+    setFlag(flag: FieldFlags, value: boolean): void;
+    get isReadOnly(): boolean;
+    set isReadOnly(value: boolean);
+    get isRequired(): boolean;
+    set isRequired(value: boolean);
+    get isMultiline(): boolean;
+    set isMultiline(value: boolean);
+    get isPassword(): boolean;
+    set isPassword(value: boolean);
+    get maxLength(): number;
+    set maxLength(len: number);
+    get textFormat(): string;
+    get isChecked(): boolean;
+    set isChecked(checked: boolean);
+    get isCombo(): boolean;
+    get isEdit(): boolean;
+    get isMultiSelect(): boolean;
+    get choiceCount(): number;
+    getChoiceLabel(index: number): string;
+    getChoiceValue(index: number): string;
+    addChoice(label: string, value?: string): void;
+    removeChoice(index: number): void;
+    get selectedIndex(): number;
+    set selectedIndex(index: number);
+    clearSelection(): void;
+    get isSigned(): boolean;
+    get borderWidth(): number;
+    set borderWidth(width: number);
+    get borderColor(): number[];
+    set borderColor(color: number[]);
+    get backgroundColor(): number[];
+    set backgroundColor(color: number[]);
+    get fontSize(): number;
+    set fontSize(size: number);
+    get alignment(): FieldAlignment;
+    set alignment(align: FieldAlignment);
+    isValid(): boolean;
+    validate(): boolean;
+}
+/**
+ * PDF interactive form (AcroForm)
+ */
+export declare class Form {
+    private _fields;
+    private _fieldMap;
+    private _refCount;
+    constructor();
+    /**
+     * Create a form from a PDF document
+     */
+    static create(): Form;
+    keep(): this;
+    drop(): void;
+    /**
+     * Create a text field
+     */
+    createTextField(name: string, rect: RectLike): FormField;
+    /**
+     * Create a checkbox
+     */
+    createCheckBox(name: string, rect: RectLike): FormField;
+    /**
+     * Create a push button
+     */
+    createPushButton(name: string, rect: RectLike): FormField;
+    /**
+     * Create a combo box
+     */
+    createComboBox(name: string, rect: RectLike): FormField;
+    /**
+     * Create a signature field
+     */
+    createSignatureField(name: string, rect: RectLike): FormField;
+    /**
+     * Add a field to the form
+     */
+    private addField;
+    /**
+     * Get field count
+     */
+    get fieldCount(): number;
+    /**
+     * Look up a field by name
+     */
+    lookupField(name: string): FormField | undefined;
+    /**
+     * Get field by index
+     */
+    getField(index: number): FormField | undefined;
+    /**
+     * Get first widget (field)
+     */
+    firstWidget(): FormField | undefined;
+    /**
+     * Get next widget after a given field
+     */
+    nextWidget(current: FormField): FormField | undefined;
+    /**
+     * Delete a field
+     */
+    deleteField(nameOrField: string | FormField): boolean;
+    /**
+     * Reset all fields to their default values
+     */
+    reset(): void;
+    /**
+     * Validate all fields
+     */
+    validate(): boolean;
+    /**
+     * Get all fields
+     */
+    getAllFields(): FormField[];
+    /**
+     * Iterate over all fields
+     */
+    [Symbol.iterator](): Generator<FormField>;
+}
+//# sourceMappingURL=form.d.ts.map

package/dist/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../src/form.ts"],"names":[],"mappings":"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"}