@lexmata/micropdf 0.4.0

package/native/include/mupdf_minimal.h

@@ -0,0 +1,381 @@
+/**
+ * Minimal MuPDF C Header
+ *
+ * Clean C-compatible declarations for only the functions we need.
+ * This bypasses the auto-generated headers that contain Rust syntax.
+ */
+
+#ifndef MUPDF_MINIMAL_H
+#define MUPDF_MINIMAL_H
+
+#include "micropdf/types.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// ============================================================================
+// Geometry Types
+// ============================================================================
+
+typedef struct {
+    float x, y;
+} fz_point;
+
+typedef struct {
+    float x0, y0, x1, y1;
+} fz_rect;
+
+typedef struct {
+    int x0, y0, x1, y1;
+} fz_irect;
+
+typedef struct {
+    float a, b, c, d, e, f;
+} fz_matrix;
+
+typedef struct {
+    fz_point ul, ur, ll, lr;
+} fz_quad;
+
+// ============================================================================
+// Opaque Handle Types (all represented as int32_t in FFI)
+// ============================================================================
+
+typedef int32_t fz_context;
+typedef int32_t fz_document;
+typedef int32_t fz_page;
+// fz_pixmap is defined later with specific functions
+typedef int32_t fz_buffer;
+typedef int32_t fz_stext_page;
+typedef int32_t fz_link;
+typedef int32_t fz_archive;
+
+// Forward declarations for types defined later with specific functions
+typedef uint64_t fz_colorspace;
+typedef uint64_t fz_device;
+typedef uint64_t fz_font;
+typedef uint64_t fz_stream;
+typedef uint64_t fz_output;
+
+// ============================================================================
+// Context Functions
+// ============================================================================
+
+#define FZ_STORE_DEFAULT 256 * 1024 * 1024  // 256 MB
+
+fz_context fz_new_context(const void* alloc, const void* locks, size_t max_store);
+void fz_drop_context(fz_context ctx);
+fz_context fz_clone_context(fz_context ctx);
+
+// ============================================================================
+// Document Functions
+// ============================================================================
+
+fz_document fz_open_document(fz_context ctx, const char* filename);
+fz_document fz_open_document_with_buffer(fz_context ctx, const char* magic, const unsigned char* data, size_t len);
+void fz_drop_document(fz_context ctx, fz_document doc);
+int fz_count_pages(fz_context ctx, fz_document doc);
+int fz_needs_password(fz_context ctx, fz_document doc);
+int fz_authenticate_password(fz_context ctx, fz_document doc, const char* password);
+int fz_has_permission(fz_context ctx, fz_document doc, int permission);
+int fz_lookup_metadata(fz_context ctx, fz_document doc, const char* key, char* buf, int size);
+
+// PDF-specific document functions
+void pdf_save_document(fz_context ctx, fz_document doc, const char* filename, const void* opts);
+int pdf_lookup_named_dest(fz_context ctx, fz_document doc, const char* name);
+
+// ============================================================================
+// Page Functions
+// ============================================================================
+
+fz_page fz_load_page(fz_context ctx, fz_document doc, int number);
+void fz_drop_page(fz_context ctx, fz_page page);
+fz_rect fz_bound_page(fz_context ctx, fz_page page);
+
+// ============================================================================
+// Matrix Functions
+// ============================================================================
+
+fz_matrix fz_identity();
+fz_matrix fz_scale(float sx, float sy);
+fz_matrix fz_translate(float tx, float ty);
+fz_matrix fz_rotate(float degrees);
+fz_matrix fz_concat(fz_matrix a, fz_matrix b);
+
+// ============================================================================
+// Buffer Functions
+// ============================================================================
+
+// fz_new_buffer_from_pixmap_as_png is declared after fz_pixmap typedef
+void fz_drop_buffer(fz_context ctx, fz_buffer buf);
+size_t fz_buffer_storage(fz_context ctx, fz_buffer buf, const unsigned char** data);
+const unsigned char* fz_buffer_data(fz_context ctx, fz_buffer buf, size_t* len);
+
+// ============================================================================
+// Text Extraction Functions
+// ============================================================================
+
+fz_stext_page fz_new_stext_page_from_page(fz_context ctx, fz_page page, const void* options);
+void fz_drop_stext_page(fz_context ctx, fz_stext_page stext);
+fz_buffer fz_new_buffer_from_stext_page(fz_context ctx, fz_stext_page stext);
+fz_rect fz_bound_stext_page(fz_context ctx, fz_stext_page stext);
+
+// ============================================================================
+// Search Functions
+// ============================================================================
+
+int fz_search_stext_page(fz_context ctx, fz_stext_page stext, const char* needle, int* mark, fz_quad* hit_bbox, int hit_max);
+
+// ============================================================================
+// Archive Functions
+// ============================================================================
+
+fz_archive fz_open_archive(fz_context ctx, const char* path);
+fz_archive fz_open_archive_with_buffer(fz_context ctx, fz_buffer buffer);
+void fz_drop_archive(fz_context ctx, fz_archive arch);
+
+// ============================================================================
+// Annotation Functions
+// ============================================================================
+
+typedef int32_t pdf_annot;
+
+pdf_annot pdf_create_annot(fz_context ctx, fz_page page, int type);
+void pdf_delete_annot(fz_context ctx, fz_page page, pdf_annot annot);
+void pdf_drop_annot(fz_context ctx, pdf_annot annot);
+
+int pdf_annot_type(fz_context ctx, pdf_annot annot);
+fz_rect pdf_annot_rect(fz_context ctx, pdf_annot annot);
+void pdf_set_annot_rect(fz_context ctx, pdf_annot annot, fz_rect rect);
+
+unsigned int pdf_annot_flags(fz_context ctx, pdf_annot annot);
+void pdf_set_annot_flags(fz_context ctx, pdf_annot annot, unsigned int flags);
+
+void pdf_annot_contents(fz_context ctx, pdf_annot annot, char* buf, int size);
+void pdf_set_annot_contents(fz_context ctx, pdf_annot annot, const char* text);
+
+void pdf_annot_author(fz_context ctx, pdf_annot annot, char* buf, int size);
+void pdf_set_annot_author(fz_context ctx, pdf_annot annot, const char* author);
+
+float pdf_annot_opacity(fz_context ctx, pdf_annot annot);
+void pdf_set_annot_opacity(fz_context ctx, pdf_annot annot, float opacity);
+
+int pdf_annot_has_dirty(fz_context ctx, pdf_annot annot);
+void pdf_annot_clear_dirty(fz_context ctx, pdf_annot annot);
+int pdf_update_annot(fz_context ctx, pdf_annot annot);
+
+pdf_annot pdf_clone_annot(fz_context ctx, pdf_annot annot);
+int pdf_annot_is_valid(fz_context ctx, pdf_annot annot);
+
+// ============================================================================
+// Display List Functions
+// ============================================================================
+
+typedef uint64_t fz_display_list_handle;
+
+fz_display_list_handle fz_new_display_list(fz_context ctx, fz_rect rect);
+void fz_drop_display_list(fz_context ctx, fz_display_list_handle list);
+fz_rect fz_bound_display_list(fz_context ctx, fz_display_list_handle list);
+void fz_run_display_list(fz_context ctx, fz_display_list_handle list, fz_device device, fz_matrix matrix, fz_rect rect);
+fz_display_list_handle fz_new_display_list_from_page(fz_context ctx, fz_page page);
+
+// ============================================================================
+// Colorspace Functions
+// ============================================================================
+
+typedef uint64_t fz_colorspace_handle;
+
+uint64_t fz_device_gray(fz_context ctx);
+uint64_t fz_device_rgb(fz_context ctx);
+uint64_t fz_device_bgr(fz_context ctx);
+uint64_t fz_device_cmyk(fz_context ctx);
+int fz_colorspace_n(fz_context ctx, fz_colorspace_handle cs);
+const char* fz_colorspace_name(fz_context ctx, fz_colorspace_handle cs);
+
+// ============================================================================
+// Font Functions
+// ============================================================================
+
+typedef uint64_t fz_font;
+
+fz_font fz_new_font(fz_context ctx, const char* name, int is_bold, int is_italic, uint64_t font_file);
+fz_font fz_new_font_from_file(fz_context ctx, const char* name, const char* path, int index, int use_glyph_bbox);
+fz_font fz_new_font_from_memory(fz_context ctx, const char* name, const unsigned char* data, int len, int index, int use_glyph_bbox);
+void fz_drop_font(fz_context ctx, fz_font font);
+void fz_font_name(fz_context ctx, fz_font font, char* buf, int size);
+int fz_font_is_bold(fz_context ctx, fz_font font);
+int fz_font_is_italic(fz_context ctx, fz_font font);
+int fz_encode_character(fz_context ctx, fz_font font, int unicode);
+float fz_advance_glyph(fz_context ctx, fz_font font, int glyph, int wmode);
+
+// ============================================================================
+// Stream Functions
+// ============================================================================
+
+fz_stream fz_open_file(fz_context ctx, const char* filename);
+fz_stream fz_open_memory(fz_context ctx, const unsigned char* data, size_t len);
+void fz_drop_stream(fz_context ctx, fz_stream stm);
+size_t fz_read(fz_context ctx, fz_stream stm, unsigned char* data, size_t len);
+int fz_read_byte(fz_context ctx, fz_stream stm);
+int fz_is_eof(fz_context ctx, fz_stream stm);
+void fz_seek(fz_context ctx, fz_stream stm, int64_t offset, int whence);
+int64_t fz_tell(fz_context ctx, fz_stream stm);
+
+// ============================================================================
+// Output Functions
+// ============================================================================
+
+fz_output fz_new_output_with_path(fz_context ctx, const char* filename, int append);
+fz_output fz_new_output_with_buffer(fz_context ctx, uint64_t buf);
+void fz_drop_output(fz_context ctx, fz_output out);
+void fz_write_data(fz_context ctx, fz_output out, const void* data, size_t size);
+void fz_write_string(fz_context ctx, fz_output out, const char* s);
+void fz_write_byte(fz_context ctx, fz_output out, unsigned char byte);
+void fz_close_output(fz_context ctx, fz_output out);
+int64_t fz_tell_output(fz_context ctx, fz_output out);
+
+// ============================================================================
+// Image Functions
+// ============================================================================
+
+typedef uint64_t fz_image;
+
+fz_image fz_new_image_from_file(fz_context ctx, const char* filename);
+fz_image fz_new_image_from_buffer_data(fz_context ctx, const uint8_t* data, size_t len);
+void fz_drop_image(fz_context ctx, fz_image image);
+int fz_image_width(fz_context ctx, fz_image image);
+int fz_image_height(fz_context ctx, fz_image image);
+uint64_t fz_image_colorspace(fz_context ctx, fz_image image);
+// fz_get_pixmap_from_image is declared after fz_pixmap typedef
+
+// ============================================================================
+// Pixmap Functions
+// ============================================================================
+
+typedef uint64_t fz_pixmap;
+
+// Legacy page-to-pixmap function (compatibility)
+fz_pixmap fz_new_pixmap_from_page(fz_context ctx, fz_page page, fz_matrix ctm, fz_colorspace cs, int alpha);
+
+// Core pixmap functions
+fz_pixmap fz_new_pixmap(fz_context ctx, uint64_t colorspace, int w, int h, int alpha);
+void fz_drop_pixmap(fz_context ctx, fz_pixmap pixmap);
+int fz_pixmap_width(fz_context ctx, fz_pixmap pixmap);
+int fz_pixmap_height(fz_context ctx, fz_pixmap pixmap);
+void fz_pixmap_samples(fz_context ctx, fz_pixmap pixmap, uint8_t** data, size_t* size);
+unsigned char* fz_pixmap_samples_old(fz_context ctx, fz_pixmap pix);
+size_t fz_pixmap_stride(fz_context ctx, fz_pixmap pixmap);
+int fz_pixmap_components(fz_context ctx, fz_pixmap pixmap);
+void fz_clear_pixmap(fz_context ctx, fz_pixmap pixmap, int value);
+
+// Pixmap-to-buffer conversion
+fz_buffer fz_new_buffer_from_pixmap_as_png(fz_context ctx, fz_pixmap pix, int color_params);
+
+// Image-to-pixmap conversion (needs fz_image and fz_pixmap defined)
+fz_pixmap fz_get_pixmap_from_image(fz_context ctx, fz_image image, const fz_irect* subarea, fz_matrix* ctm, int* w, int* h);
+
+// ============================================================================
+// Path Functions
+// ============================================================================
+
+typedef uint64_t fz_path_handle;
+typedef uint64_t fz_stroke_handle;
+
+fz_path_handle fz_new_path(fz_context ctx);
+void fz_drop_path(fz_context ctx, fz_path_handle path);
+void fz_moveto(fz_context ctx, fz_path_handle path, float x, float y);
+void fz_lineto(fz_context ctx, fz_path_handle path, float x, float y);
+void fz_curveto(fz_context ctx, fz_path_handle path, float x1, float y1, float x2, float y2, float x3, float y3);
+void fz_closepath(fz_context ctx, fz_path_handle path);
+void fz_rectto(fz_context ctx, fz_path_handle path, float x, float y, float w, float h);
+fz_rect fz_bound_path(fz_context ctx, fz_path_handle path, fz_stroke_handle stroke);
+
+// ============================================================================
+// Device Functions
+// ============================================================================
+
+typedef uint64_t fz_device_handle;
+
+fz_device_handle fz_new_draw_device(fz_context ctx, fz_pixmap pixmap);
+fz_device_handle fz_new_list_device(fz_context ctx, fz_display_list_handle list);
+void fz_drop_device(fz_context ctx, fz_device_handle device);
+void fz_close_device(fz_context ctx, fz_device_handle device);
+void fz_begin_page(fz_context ctx, fz_device_handle device, fz_rect rect);
+void fz_end_page(fz_context ctx, fz_device_handle device);
+
+// ============================================================================
+// Cookie Functions
+// ============================================================================
+
+typedef uint64_t fz_cookie_handle;
+
+fz_cookie_handle fz_new_cookie(fz_context ctx);
+void fz_drop_cookie(fz_context ctx, fz_cookie_handle cookie);
+void fz_abort_cookie(fz_context ctx, fz_cookie_handle cookie);
+void fz_cookie_progress(fz_context ctx, fz_cookie_handle cookie, int* progress, int* progress_max, int* errors);
+int fz_cookie_is_aborted(fz_context ctx, fz_cookie_handle cookie);
+void fz_reset_cookie(fz_context ctx, fz_cookie_handle cookie);
+
+// ============================================================================
+// Link Functions
+// ============================================================================
+
+typedef uint64_t fz_link_handle;
+
+fz_link_handle fz_load_links(fz_context ctx, fz_page page);
+fz_link_handle fz_next_link(fz_context ctx, fz_link_handle link);
+void fz_drop_link(fz_context ctx, fz_link_handle link);
+fz_rect fz_link_rect(fz_context ctx, fz_link_handle link);
+void fz_link_uri(fz_context ctx, fz_link_handle link, char* buf, int size);
+int fz_link_is_external(fz_context ctx, fz_link_handle link);
+int fz_resolve_link_page(fz_context ctx, fz_document doc, fz_link_handle link);
+int fz_link_is_valid(fz_context ctx, fz_link_handle link);
+
+// ============================================================================
+// Form Widget Functions
+// ============================================================================
+
+typedef uint64_t pdf_widget;
+
+// Widget navigation
+pdf_widget pdf_first_widget(fz_context ctx, fz_page page);
+pdf_widget pdf_next_widget(fz_context ctx, pdf_widget widget);
+void pdf_drop_widget(fz_context ctx, pdf_widget widget);
+
+// Widget properties
+int pdf_widget_type(fz_context ctx, pdf_widget widget);
+void pdf_widget_name(fz_context ctx, pdf_widget widget, char* buf, int size);
+fz_rect pdf_widget_rect(fz_context ctx, pdf_widget widget);
+
+// Widget values
+void pdf_widget_value(fz_context ctx, pdf_widget widget, char* buf, int size);
+int pdf_set_widget_value(fz_context ctx, pdf_widget widget, const char* value);
+
+// Widget state
+int pdf_widget_is_readonly(fz_context ctx, pdf_widget widget);
+int pdf_widget_is_required(fz_context ctx, pdf_widget widget);
+int pdf_widget_is_valid(fz_context ctx, pdf_widget widget);
+
+// Text field specific
+int pdf_widget_text_format(fz_context ctx, pdf_widget widget);
+int pdf_widget_max_len(fz_context ctx, pdf_widget widget);
+int pdf_widget_is_multiline(fz_context ctx, pdf_widget widget);
+
+// Checkbox/radio specific
+int pdf_widget_is_checked(fz_context ctx, pdf_widget widget);
+void pdf_set_widget_checked(fz_context ctx, pdf_widget widget, int checked);
+
+// Choice field specific
+int pdf_widget_option_count(fz_context ctx, pdf_widget widget);
+void pdf_widget_option(fz_context ctx, pdf_widget widget, int index, char* buf, int size);
+
+// Widget updates
+int pdf_update_widget(fz_context ctx, pdf_widget widget);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* MUPDF_MINIMAL_H */
+

package/native/link.cc

@@ -0,0 +1,234 @@
+/**
+ * MicroPDF Link Bindings
+ *
+ * N-API bindings for PDF link/hyperlink operations.
+ * Links provide navigation within and between PDF documents.
+ */
+
+#include <napi.h>
+#include "include/mupdf_minimal.h"
+
+/**
+ * Get first link on page
+ *
+ * @param ctx - Context handle
+ * @param page - Page handle
+ * @returns Link handle (or 0 if none)
+ */
+Napi::BigInt LoadPageLinks(const Napi::CallbackInfo& info) {
+    Napi::Env env = info.Env();
+
+    if (info.Length() < 2) {
+        Napi::TypeError::New(env, "Expected 2 arguments: ctx, page")
+            .ThrowAsJavaScriptException();
+        return Napi::BigInt::New(env, static_cast<uint64_t>(0));
+    }
+
+    bool lossless;
+    uint64_t ctx_handle = info[0].As<Napi::BigInt>().Uint64Value(&lossless);
+    uint64_t page_handle = info[1].As<Napi::BigInt>().Uint64Value(&lossless);
+
+    uint64_t link_handle = fz_load_links(ctx_handle, page_handle);
+
+    return Napi::BigInt::New(env, link_handle);
+}
+
+/**
+ * Get next link in list
+ *
+ * @param ctx - Context handle
+ * @param link - Current link handle
+ * @returns Next link handle (or 0 if none)
+ */
+Napi::BigInt GetNextLink(const Napi::CallbackInfo& info) {
+    Napi::Env env = info.Env();
+
+    if (info.Length() < 2) {
+        Napi::TypeError::New(env, "Expected 2 arguments: ctx, link")
+            .ThrowAsJavaScriptException();
+        return Napi::BigInt::New(env, static_cast<uint64_t>(0));
+    }
+
+    bool lossless;
+    uint64_t ctx_handle = info[0].As<Napi::BigInt>().Uint64Value(&lossless);
+    uint64_t link_handle = info[1].As<Napi::BigInt>().Uint64Value(&lossless);
+
+    uint64_t next_handle = fz_next_link(ctx_handle, link_handle);
+
+    return Napi::BigInt::New(env, next_handle);
+}
+
+/**
+ * Drop link handle
+ *
+ * @param ctx - Context handle
+ * @param link - Link handle
+ */
+Napi::Value DropLink(const Napi::CallbackInfo& info) {
+    Napi::Env env = info.Env();
+
+    if (info.Length() < 2) {
+        Napi::TypeError::New(env, "Expected 2 arguments: ctx, link")
+            .ThrowAsJavaScriptException();
+        return env.Undefined();
+    }
+
+    bool lossless;
+    uint64_t ctx_handle = info[0].As<Napi::BigInt>().Uint64Value(&lossless);
+    uint64_t link_handle = info[1].As<Napi::BigInt>().Uint64Value(&lossless);
+
+    fz_drop_link(ctx_handle, link_handle);
+
+    return env.Undefined();
+}
+
+/**
+ * Get link rectangle
+ *
+ * @param ctx - Context handle
+ * @param link - Link handle
+ * @returns Rectangle {x0, y0, x1, y1}
+ */
+Napi::Object GetLinkRect(const Napi::CallbackInfo& info) {
+    Napi::Env env = info.Env();
+    Napi::Object rect = Napi::Object::New(env);
+
+    if (info.Length() < 2) {
+        Napi::TypeError::New(env, "Expected 2 arguments: ctx, link")
+            .ThrowAsJavaScriptException();
+        return rect;
+    }
+
+    bool lossless;
+    uint64_t ctx_handle = info[0].As<Napi::BigInt>().Uint64Value(&lossless);
+    uint64_t link_handle = info[1].As<Napi::BigInt>().Uint64Value(&lossless);
+
+    fz_rect link_rect = fz_link_rect(ctx_handle, link_handle);
+
+    rect.Set("x0", Napi::Number::New(env, link_rect.x0));
+    rect.Set("y0", Napi::Number::New(env, link_rect.y0));
+    rect.Set("x1", Napi::Number::New(env, link_rect.x1));
+    rect.Set("y1", Napi::Number::New(env, link_rect.y1));
+
+    return rect;
+}
+
+/**
+ * Get link URI
+ *
+ * @param ctx - Context handle
+ * @param link - Link handle
+ * @returns URI string (or empty if internal)
+ */
+Napi::String GetLinkURI(const Napi::CallbackInfo& info) {
+    Napi::Env env = info.Env();
+
+    if (info.Length() < 2) {
+        Napi::TypeError::New(env, "Expected 2 arguments: ctx, link")
+            .ThrowAsJavaScriptException();
+        return Napi::String::New(env, "");
+    }
+
+    bool lossless;
+    uint64_t ctx_handle = info[0].As<Napi::BigInt>().Uint64Value(&lossless);
+    uint64_t link_handle = info[1].As<Napi::BigInt>().Uint64Value(&lossless);
+
+    char buffer[2048];
+    fz_link_uri(ctx_handle, link_handle, buffer, sizeof(buffer));
+
+    return Napi::String::New(env, buffer);
+}
+
+/**
+ * Check if link is external
+ *
+ * @param ctx - Context handle
+ * @param link - Link handle
+ * @returns Boolean
+ */
+Napi::Boolean IsLinkExternal(const Napi::CallbackInfo& info) {
+    Napi::Env env = info.Env();
+
+    if (info.Length() < 2) {
+        Napi::TypeError::New(env, "Expected 2 arguments: ctx, link")
+            .ThrowAsJavaScriptException();
+        return Napi::Boolean::New(env, false);
+    }
+
+    bool lossless;
+    uint64_t ctx_handle = info[0].As<Napi::BigInt>().Uint64Value(&lossless);
+    uint64_t link_handle = info[1].As<Napi::BigInt>().Uint64Value(&lossless);
+
+    int32_t is_external = fz_link_is_external(ctx_handle, link_handle);
+
+    return Napi::Boolean::New(env, is_external != 0);
+}
+
+/**
+ * Resolve link destination page
+ *
+ * @param ctx - Context handle
+ * @param doc - Document handle
+ * @param link - Link handle
+ * @returns Page number (-1 if external)
+ */
+Napi::Number ResolveLinkPage(const Napi::CallbackInfo& info) {
+    Napi::Env env = info.Env();
+
+    if (info.Length() < 3) {
+        Napi::TypeError::New(env, "Expected 3 arguments: ctx, doc, link")
+            .ThrowAsJavaScriptException();
+        return Napi::Number::New(env, -1);
+    }
+
+    bool lossless;
+    uint64_t ctx_handle = info[0].As<Napi::BigInt>().Uint64Value(&lossless);
+    uint64_t doc_handle = info[1].As<Napi::BigInt>().Uint64Value(&lossless);
+    uint64_t link_handle = info[2].As<Napi::BigInt>().Uint64Value(&lossless);
+
+    int32_t page_num = fz_resolve_link_page(ctx_handle, doc_handle, link_handle);
+
+    return Napi::Number::New(env, page_num);
+}
+
+/**
+ * Check if link is valid
+ *
+ * @param ctx - Context handle
+ * @param link - Link handle
+ * @returns Boolean
+ */
+Napi::Boolean IsLinkValid(const Napi::CallbackInfo& info) {
+    Napi::Env env = info.Env();
+
+    if (info.Length() < 2) {
+        Napi::TypeError::New(env, "Expected 2 arguments: ctx, link")
+            .ThrowAsJavaScriptException();
+        return Napi::Boolean::New(env, false);
+    }
+
+    bool lossless;
+    uint64_t ctx_handle = info[0].As<Napi::BigInt>().Uint64Value(&lossless);
+    uint64_t link_handle = info[1].As<Napi::BigInt>().Uint64Value(&lossless);
+
+    int32_t is_valid = fz_link_is_valid(ctx_handle, link_handle);
+
+    return Napi::Boolean::New(env, is_valid != 0);
+}
+
+/**
+ * Initialize Link module exports
+ */
+Napi::Object InitLink(Napi::Env env, Napi::Object exports) {
+    exports.Set("loadPageLinks", Napi::Function::New(env, LoadPageLinks));
+    exports.Set("getNextLink", Napi::Function::New(env, GetNextLink));
+    exports.Set("dropLink", Napi::Function::New(env, DropLink));
+    exports.Set("getLinkRect", Napi::Function::New(env, GetLinkRect));
+    exports.Set("getLinkURI", Napi::Function::New(env, GetLinkURI));
+    exports.Set("isLinkExternal", Napi::Function::New(env, IsLinkExternal));
+    exports.Set("resolveLinkPage", Napi::Function::New(env, ResolveLinkPage));
+    exports.Set("isLinkValid", Napi::Function::New(env, IsLinkValid));
+
+    return exports;
+}
+

package/native/micropdf.cc

@@ -0,0 +1,71 @@
+/**
+ * MicroPDF Node.js Native Addon
+ *
+ * Main entry point for the native addon that binds the MicroPDF Rust library
+ * to Node.js via N-API.
+ */
+
+#include <napi.h>
+#include "include/mupdf_minimal.h"
+
+// Forward declarations from other source files
+Napi::Object InitContext(Napi::Env env, Napi::Object exports);
+Napi::Object InitDocument(Napi::Env env, Napi::Object exports);
+Napi::Object InitPage(Napi::Env env, Napi::Object exports);
+Napi::Object InitSText(Napi::Env env, Napi::Object exports);
+Napi::Object InitAnnotation(Napi::Env env, Napi::Object exports);
+Napi::Object InitForm(Napi::Env env, Napi::Object exports);
+Napi::Object InitDisplayList(Napi::Env env, Napi::Object exports);
+Napi::Object InitLink(Napi::Env env, Napi::Object exports);
+Napi::Object InitCookie(Napi::Env env, Napi::Object exports);
+Napi::Object InitDevice(Napi::Env env, Napi::Object exports);
+Napi::Object InitPath(Napi::Env env, Napi::Object exports);
+Napi::Object InitPixmap(Napi::Env env, Napi::Object exports);
+Napi::Object InitImage(Napi::Env env, Napi::Object exports);
+Napi::Object InitColorspace(Napi::Env env, Napi::Object exports);
+Napi::Object InitFont(Napi::Env env, Napi::Object exports);
+Napi::Object InitStream(Napi::Env env, Napi::Object exports);
+Napi::Object InitOutput(Napi::Env env, Napi::Object exports);
+Napi::Object InitEnhanced(Napi::Env env, Napi::Object exports);
+
+/**
+ * Get the MicroPDF library version
+ */
+Napi::String GetVersion(const Napi::CallbackInfo& info) {
+    Napi::Env env = info.Env();
+    // Return version from package.json
+    return Napi::String::New(env, "0.1.0");
+}
+
+/**
+ * Initialize the native addon
+ */
+Napi::Object Init(Napi::Env env, Napi::Object exports) {
+    // Add version function
+    exports.Set("getVersion", Napi::Function::New(env, GetVersion));
+
+    // Initialize sub-modules
+    InitContext(env, exports);
+    InitDocument(env, exports);
+    InitPage(env, exports);
+    InitSText(env, exports);
+    InitAnnotation(env, exports);
+    InitForm(env, exports);
+    InitDisplayList(env, exports);
+    InitLink(env, exports);
+    InitCookie(env, exports);
+    InitDevice(env, exports);
+    InitPath(env, exports);
+    InitPixmap(env, exports);
+    InitImage(env, exports);
+    InitColorspace(env, exports);
+    InitFont(env, exports);
+    InitStream(env, exports);
+    InitOutput(env, exports);
+    InitEnhanced(env, exports);
+
+    return exports;
+}
+
+NODE_API_MODULE(micropdf, Init)
+