hazo_pdf 1.1.0 → 1.2.1

package/README.md

@@ -19,6 +19,47 @@ A React component library for viewing and annotating PDF documents with support
 npm install hazo_pdf
 ```
 
+## CSS Import Options
+
+The library provides two CSS files to choose from:
+
+### For apps with existing styles (Recommended)
+
+Use `styles.css` - this does NOT include Tailwind preflight/base resets, so it won't interfere with your existing styles:
+
+```tsx
+import 'hazo_pdf/styles.css';
+```
+
+### For standalone apps
+
+Use `styles-full.css` - includes Tailwind preflight/base styles for apps without existing CSS resets:
+
+```tsx
+import 'hazo_pdf/styles-full.css';
+```
+
+## Container Requirements
+
+The PDF viewer requires its parent container to have explicit dimensions:
+
+```tsx
+// Good - explicit dimensions
+<div style={{ width: '100%', height: '600px' }}>
+  <PdfViewer url="/document.pdf" />
+</div>
+
+// Bad - no explicit height
+<div>
+  <PdfViewer url="/document.pdf" />
+</div>
+```
+
+**Requirements:**
+- Parent must have explicit `width` and `height` (CSS or inline style)
+- Recommended minimum size: 400x400px
+- Parent should NOT have `overflow: hidden` (the viewer handles its own scrolling)
+
 ## Quick Start
 
 ```tsx
@@ -307,7 +348,7 @@ function ProductionViewer() {
       <div style={{ flex: 1, overflow: 'hidden' }}>
         <PdfViewer 
           url="/api/documents/contract.pdf"
-          config_file="hazo_pdf_config.ini"
+          config_file="config/hazo_pdf_config.ini"
           className="h-full w-full"
           scale={initialScale}
           annotations={annotations}
@@ -327,7 +368,7 @@ function ProductionViewer() {
 ```
 
 **Features demonstrated:**
-- Configuration file integration (`hazo_pdf_config.ini`)
+- Configuration file integration (`config/hazo_pdf_config.ini`)
 - Custom stamps with styling
 - Timestamp and fixed text suffixes
 - Responsive scaling based on screen size
@@ -340,7 +381,7 @@ function ProductionViewer() {
 
 ## Configuration File
 
-The PDF viewer can be configured via an INI file (default: `hazo_pdf_config.ini`). This allows you to customize styling, colors, fonts, and behavior without modifying code.
+The PDF viewer can be configured via an INI file (default: `config/hazo_pdf_config.ini`). This allows you to customize styling, colors, fonts, and behavior without modifying code.
 
 **Basic setup:**
 
@@ -357,11 +398,18 @@ freetext_background_opacity = 0.1
 freetext_border_color = #003366
 freetext_border_width = 1
 
+[toolbar]
+toolbar_background_color = rgb(240, 248, 255)
+toolbar_font_color = rgb(30, 58, 138)
+toolbar_button_background_color = rgb(219, 234, 254)
+toolbar_button_text_color = rgb(30, 64, 175)
+toolbar_button_save_background_color = rgb(34, 197, 94)
+
 [context_menu]
 right_click_custom_stamps = [{"name":"Verified","text":"✅","order":1,"time_stamp_suffix_enabled":true,"fixed_text_suffix_enabled":true}]
 ```
 
-See `hazo_pdf_config.ini` in the project root for all available configuration options.
+See `config/hazo_pdf_config.ini` in the project root for all available configuration options.
 
 ---
 
@@ -384,7 +432,7 @@ See `hazo_pdf_config.ini` in the project root for all available configuration op
 | `className` | `string` | `""` | Additional CSS classes to apply to the viewer container. |
 | `scale` | `number` | `1.0` | Initial zoom level. Values > 1.0 zoom in, < 1.0 zoom out. |
 | `background_color` | `string` | `"#2d2d2d"` | Background color for areas outside PDF pages (hex format: `#RRGGBB`). Overrides config file value. |
-| `config_file` | `string` | `undefined` | Path to configuration INI file (e.g., `"hazo_pdf_config.ini"`). If not provided, uses default configuration. |
+| `config_file` | `string` | `undefined` | Path to configuration INI file (e.g., `"config/hazo_pdf_config.ini"`). If not provided, uses default configuration. |
 
 ##### Event Callbacks
 
@@ -462,12 +510,50 @@ const stamps = JSON.stringify([
   }
 ]);
 
-<PdfViewer 
+<PdfViewer
   url="/document.pdf"
   right_click_custom_stamps={stamps}
 />
 ```
 
+##### Toolbar Visibility
+
+Props to control toolbar button visibility. These override config file values.
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `toolbar_enabled` | `boolean` | `true` | Master toggle to show/hide the entire toolbar. |
+| `show_zoom_controls` | `boolean` | `true` | Show zoom in/out/reset buttons. |
+| `show_square_button` | `boolean` | `true` | Show square annotation button. |
+| `show_undo_button` | `boolean` | `true` | Show undo button. |
+| `show_redo_button` | `boolean` | `true` | Show redo button. |
+| `show_save_button` | `boolean` | `true` | Show save button. |
+| `show_metadata_button` | `boolean` | `true` | Show metadata panel button (only visible when `sidepanel_metadata_enabled` is true). |
+| `on_close` | `() => void` | `undefined` | Callback when close button is clicked. When provided, shows a close button (X) in the toolbar. Useful for modal/dialog usage. |
+
+**Example - Minimal toolbar:**
+
+```tsx
+<PdfViewer
+  url="/document.pdf"
+  toolbar_enabled={true}
+  show_zoom_controls={true}
+  show_square_button={false}
+  show_undo_button={false}
+  show_redo_button={false}
+  show_save_button={false}
+/>
+```
+
+**Example - Dialog with close button:**
+
+```tsx
+<PdfViewer
+  url="/document.pdf"
+  on_close={() => setDialogOpen(false)}
+/>
+```
+
 ### PdfAnnotation Interface
 
 Represents a PDF annotation in the standard PDF coordinate space.
@@ -497,6 +583,72 @@ Type from `pdfjs-dist`. Contains PDF metadata and page proxies.
 
 ---
 
+## Toolbar Configuration
+
+The toolbar can be fully customized via the `[toolbar]` section in the configuration file. You can configure:
+
+- **Colors**: Background, border, font, and button colors (background, hover, active, save)
+- **Fonts**: Font family and size for toolbar text
+- **Visibility**: Show/hide individual button groups (zoom, square, undo, redo, save)
+- **Labels**: Customize all button labels and text
+
+**All toolbar settings with defaults:**
+
+| Setting | Type | Default | Description |
+|---------|------|---------|-------------|
+| `toolbar_background_color` | Color | `#f9fafb` | Toolbar background color |
+| `toolbar_border_color` | Color | `#e5e7eb` | Toolbar border color |
+| `toolbar_font_family` | String | `system-ui, -apple-system, sans-serif` | Font family for toolbar |
+| `toolbar_font_size` | Number | `14` | Font size in pixels |
+| `toolbar_font_color` | Color | `#111827` | Text color for toolbar |
+| `toolbar_button_background_color` | Color | `#ffffff` | Regular button background |
+| `toolbar_button_background_color_hover` | Color | `#f3f4f6` | Button hover background |
+| `toolbar_button_text_color` | Color | `#374151` | Button text color |
+| `toolbar_button_active_background_color` | Color | `#3b82f6` | Active button background |
+| `toolbar_button_active_text_color` | Color | `#ffffff` | Active button text color |
+| `toolbar_button_save_background_color` | Color | `#10b981` | Save button background |
+| `toolbar_button_save_background_color_hover` | Color | `#059669` | Save button hover background |
+| `toolbar_button_save_text_color` | Color | `#ffffff` | Save button text color |
+| `toolbar_button_disabled_opacity` | Number | `0.5` | Opacity for disabled buttons (0.0-1.0) |
+| `toolbar_show_zoom_controls` | Boolean | `true` | Show zoom controls |
+| `toolbar_show_square_button` | Boolean | `true` | Show square annotation button |
+| `toolbar_show_undo_button` | Boolean | `true` | Show undo button |
+| `toolbar_show_redo_button` | Boolean | `true` | Show redo button |
+| `toolbar_show_save_button` | Boolean | `true` | Show save button |
+| `toolbar_show_metadata_button` | Boolean | `true` | Show metadata panel button (only shown when sidepanel is enabled) |
+| `toolbar_zoom_out_label` | String | `"−"` | Zoom out button label |
+| `toolbar_zoom_in_label` | String | `"+"` | Zoom in button label |
+| `toolbar_zoom_reset_label` | String | `"Reset"` | Reset zoom button label |
+| `toolbar_square_label` | String | `"Square"` | Square button label |
+| `toolbar_undo_label` | String | `"Undo"` | Undo button label |
+| `toolbar_redo_label` | String | `"Redo"` | Redo button label |
+| `toolbar_save_label` | String | `"Save"` | Save button label |
+| `toolbar_saving_label` | String | `"Saving..."` | Saving button label |
+| `toolbar_metadata_label` | String | `"Metadata"` | Metadata panel button label |
+
+**Example configuration:**
+
+```ini
+[toolbar]
+# Customize colors
+toolbar_background_color = rgb(240, 248, 255)
+toolbar_border_color = rgb(59, 130, 246)
+toolbar_font_color = rgb(30, 58, 138)
+toolbar_button_background_color = rgb(219, 234, 254)
+toolbar_button_text_color = rgb(30, 64, 175)
+toolbar_button_active_background_color = rgb(37, 99, 235)
+toolbar_button_save_background_color = rgb(34, 197, 94)
+
+# Hide some controls
+toolbar_show_redo_button = false
+toolbar_show_square_button = false
+toolbar_show_metadata_button = false
+
+# Customize labels
+toolbar_save_label = Save PDF
+toolbar_undo_label = ← Undo
+```
+
 ## Toolbar Controls
 
 The PDF viewer includes a toolbar at the top with the following controls:

package/dist/{chunk-2POHPGR3.js → chunk-S3AJUZ7D.js}

@@ -73,6 +73,38 @@ var default_config = {
     dialog_button_cancel_color: "#6b7280",
     dialog_button_cancel_color_hover: "#4b5563",
     dialog_button_disabled_opacity: 0.4
+  },
+  toolbar: {
+    toolbar_background_color: "#f9fafb",
+    toolbar_border_color: "#e5e7eb",
+    toolbar_font_family: "system-ui, -apple-system, sans-serif",
+    toolbar_font_size: 14,
+    toolbar_font_color: "#111827",
+    toolbar_button_background_color: "#ffffff",
+    toolbar_button_background_color_hover: "#f3f4f6",
+    toolbar_button_text_color: "#374151",
+    toolbar_button_active_background_color: "#3b82f6",
+    toolbar_button_active_text_color: "#ffffff",
+    toolbar_button_save_background_color: "#10b981",
+    toolbar_button_save_background_color_hover: "#059669",
+    toolbar_button_save_text_color: "#ffffff",
+    toolbar_button_disabled_opacity: 0.5,
+    toolbar_show_zoom_controls: true,
+    toolbar_show_square_button: true,
+    toolbar_show_undo_button: true,
+    toolbar_show_redo_button: true,
+    toolbar_show_save_button: true,
+    toolbar_show_metadata_button: true,
+    toolbar_show_annotate_button: true,
+    toolbar_zoom_out_label: "\u2212",
+    toolbar_zoom_in_label: "+",
+    toolbar_zoom_reset_label: "Reset",
+    toolbar_square_label: "Square",
+    toolbar_undo_label: "Undo",
+    toolbar_redo_label: "Redo",
+    toolbar_save_label: "Save",
+    toolbar_saving_label: "Saving...",
+    toolbar_metadata_label: "Metadata"
   }
 };
 
@@ -280,4 +312,4 @@ export {
   download_pdf,
   save_and_download_pdf
 };
-//# sourceMappingURL=chunk-2POHPGR3.js.map
+//# sourceMappingURL=chunk-S3AJUZ7D.js.map

package/dist/chunk-S3AJUZ7D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/default_config.ts","../src/utils/pdf_saver.ts"],"sourcesContent":["/**\n * Default configuration values for hazo_pdf\n * All styling defaults organized by category\n */\n\nimport type { PdfViewerConfig } from '../types/config';\n\n/**\n * Default PDF Viewer Configuration\n * These values are used when no config file is provided or when values are missing\n */\nexport const default_config: PdfViewerConfig = {\n  fonts: {\n    freetext_font_family: 'Arial, sans-serif',\n    freetext_font_size_min: 12,\n    freetext_font_size_max: 24,\n    freetext_font_size_default: 14,\n    font_foreground_color: '#000000', // Black by default\n  },\n\n  highlight_annotation: {\n    highlight_fill_color: '#FFFF00',\n    highlight_fill_opacity: 0.3,\n    highlight_border_color: '#FFD700',\n    highlight_border_color_hover: '#FFD700',\n    highlight_fill_opacity_hover: 0.4,\n  },\n\n  square_annotation: {\n    square_fill_color: '#FF0000',\n    square_fill_opacity: 0.2,\n    square_border_color: '#FF0000',\n    square_border_color_hover: '#CC0000',\n    square_fill_opacity_hover: 0.3,\n  },\n\n  freetext_annotation: {\n    freetext_text_color: '#000000',\n    freetext_text_color_hover: '#000000',\n    freetext_border_color: '#003366',\n    freetext_border_width: 1,\n    freetext_background_color: '#E6F3FF',\n    freetext_background_opacity: 0.1,\n    freetext_font_weight: 'normal',\n    freetext_font_style: 'normal',\n    freetext_text_decoration: 'none',\n    freetext_padding_horizontal: 4,\n    freetext_padding_vertical: 2,\n  },\n\n  page_styling: {\n    page_border_color: '#999999',\n    page_box_shadow: '0 2px 8px rgba(0, 0, 0, 0.3)',\n    page_background_color: '#ffffff',\n  },\n\n  viewer: {\n    viewer_background_color: '#2d2d2d',\n    append_timestamp_to_text_edits: false,\n    annotation_text_suffix_fixed_text: '',\n    add_enclosing_brackets_to_suffixes: true,\n    suffix_enclosing_brackets: '[]',\n    suffix_text_position: 'below_multi_line',\n  },\n\n  context_menu: {\n    context_menu_background_color: '#ffffff',\n    context_menu_border_color: '#d1d5db',\n    context_menu_item_hover_background: '#f3f4f6',\n    context_menu_item_disabled_opacity: 0.5,\n    right_click_custom_stamps: '', // Empty string means no custom stamps\n  },\n\n  dialog: {\n    dialog_backdrop_opacity: 0.2,\n    dialog_background_color: '#ffffff',\n    dialog_border_color: '#d1d5db',\n    dialog_button_submit_color: '#16a34a',\n    dialog_button_submit_color_hover: '#15803d',\n    dialog_button_cancel_color: '#6b7280',\n    dialog_button_cancel_color_hover: '#4b5563',\n    dialog_button_disabled_opacity: 0.4,\n  },\n\n  toolbar: {\n    toolbar_background_color: '#f9fafb',\n    toolbar_border_color: '#e5e7eb',\n    toolbar_font_family: 'system-ui, -apple-system, sans-serif',\n    toolbar_font_size: 14,\n    toolbar_font_color: '#111827',\n    toolbar_button_background_color: '#ffffff',\n    toolbar_button_background_color_hover: '#f3f4f6',\n    toolbar_button_text_color: '#374151',\n    toolbar_button_active_background_color: '#3b82f6',\n    toolbar_button_active_text_color: '#ffffff',\n    toolbar_button_save_background_color: '#10b981',\n    toolbar_button_save_background_color_hover: '#059669',\n    toolbar_button_save_text_color: '#ffffff',\n    toolbar_button_disabled_opacity: 0.5,\n    toolbar_show_zoom_controls: true,\n    toolbar_show_square_button: true,\n    toolbar_show_undo_button: true,\n    toolbar_show_redo_button: true,\n    toolbar_show_save_button: true,\n    toolbar_show_metadata_button: true,\n    toolbar_show_annotate_button: true,\n    toolbar_zoom_out_label: '−',\n    toolbar_zoom_in_label: '+',\n    toolbar_zoom_reset_label: 'Reset',\n    toolbar_square_label: 'Square',\n    toolbar_undo_label: 'Undo',\n    toolbar_redo_label: 'Redo',\n    toolbar_save_label: 'Save',\n    toolbar_saving_label: 'Saving...',\n    toolbar_metadata_label: 'Metadata',\n  },\n};\n","/**\n * PDF Saver Utility\n * Saves annotations directly into PDF documents using pdf-lib\n * This allows annotations to be embedded in the PDF file itself\n */\n\nimport type { PdfAnnotation, PdfViewerConfig } from '../types';\nimport { default_config } from '../config/default_config';\n\n/**\n * Save annotations into a PDF document\n * This function fetches the PDF, adds annotations, and downloads the modified PDF\n * @param pdf_url - URL of the PDF file\n * @param annotations - Array of annotations to save\n * @param output_filename - Name for the saved PDF file (default: original filename with '_annotated' suffix)\n * @param config - Optional configuration for styling values\n * @returns Promise that resolves when the PDF is saved\n */\nexport async function save_annotations_to_pdf(\n  pdf_url: string,\n  annotations: PdfAnnotation[],\n  _output_filename?: string, // Currently unused, kept for API compatibility\n  config?: PdfViewerConfig | null\n): Promise<Uint8Array> {\n  try {\n    // Dynamically import pdf-lib\n    const { PDFDocument, rgb } = await import('pdf-lib');\n    \n    // Fetch the original PDF\n    console.log('[PDF Saver] Fetching PDF from:', pdf_url);\n    const pdf_response = await fetch(pdf_url);\n    if (!pdf_response.ok) {\n      throw new Error(`Failed to fetch PDF: ${pdf_response.status} ${pdf_response.statusText}`);\n    }\n    \n    const pdf_bytes = await pdf_response.arrayBuffer();\n    console.log('[PDF Saver] PDF fetched, size:', pdf_bytes.byteLength, 'bytes');\n    \n    // Load the PDF document\n    const pdf_doc = await PDFDocument.load(pdf_bytes);\n    console.log('[PDF Saver] PDF loaded, pages:', pdf_doc.getPageCount());\n    \n    // Get config values or use defaults\n    const fonts_config = config?.fonts || default_config.fonts;\n    const highlight_config = config?.highlight_annotation || default_config.highlight_annotation;\n    const square_config = config?.square_annotation || default_config.square_annotation;\n    const freetext_config = config?.freetext_annotation || default_config.freetext_annotation;\n    \n    // Add annotations to each page\n    for (const annotation of annotations) {\n      if (annotation.page_index >= pdf_doc.getPageCount()) {\n        console.warn(`[PDF Saver] Annotation ${annotation.id} references page ${annotation.page_index}, but PDF only has ${pdf_doc.getPageCount()} pages. Skipping.`);\n        continue;\n      }\n      \n      const page = pdf_doc.getPage(annotation.page_index);\n      const [x1, y1, x2, y2] = annotation.rect;\n      \n      // PDF coordinate system: bottom-left is origin (pdfjs-dist)\n      // pdf-lib uses bottom-left as origin too, so coordinates should be fine\n      // But we need to ensure rect is normalized\n      const rect_x = Math.min(x1, x2);\n      const rect_y = Math.min(y1, y2);\n      const rect_width = Math.abs(x2 - x1);\n      const rect_height = Math.abs(y2 - y1);\n      \n      // Parse color (hex or rgb to RGB for pdf-lib)\n      // Supports both hex (#RRGGBB) and rgb(r, g, b) formats\n      let color = rgb(0, 0, 0); // Default black\n      if (annotation.color) {\n        const color_str = annotation.color.trim();\n        \n        // Handle rgb(r, g, b) format\n        const rgb_pattern = /^rgb\\s*\\(\\s*(\\d+)\\s*,\\s*(\\d+)\\s*,\\s*(\\d+)\\s*\\)$/i;\n        const rgb_match = color_str.match(rgb_pattern);\n        if (rgb_match) {\n          const r = parseInt(rgb_match[1], 10);\n          const g = parseInt(rgb_match[2], 10);\n          const b = parseInt(rgb_match[3], 10);\n          // Validate RGB values (0-255) and convert to 0-1 range for pdf-lib\n          if (r >= 0 && r <= 255 && g >= 0 && g <= 255 && b >= 0 && b <= 255) {\n            color = rgb(r / 255, g / 255, b / 255);\n          } else {\n            console.warn(`[PDF Saver] Invalid RGB values for annotation ${annotation.id}: r=${r}, g=${g}, b=${b}`);\n          }\n        } else if (color_str.startsWith('#')) {\n          // Handle hex format (#RRGGBB)\n          const hex = color_str.slice(1).trim();\n          if (hex.length === 6 && /^[0-9A-Fa-f]{6}$/.test(hex)) {\n            const r = parseInt(hex.substring(0, 2), 16) / 255;\n            const g = parseInt(hex.substring(2, 4), 16) / 255;\n            const b = parseInt(hex.substring(4, 6), 16) / 255;\n            color = rgb(r, g, b);\n          } else {\n            console.warn(`[PDF Saver] Invalid hex color format for annotation ${annotation.id}: ${color_str}`);\n          }\n        } else {\n          console.warn(`[PDF Saver] Unrecognized color format for annotation ${annotation.id}: ${color_str}`);\n        }\n      }\n      \n      // Create annotation based on type using pdf-lib's annotation methods\n      try {\n        switch (annotation.type) {\n          case 'Square': {\n            // Create a rectangle/square annotation\n            page.drawRectangle({\n              x: rect_x,\n              y: rect_y,\n              width: rect_width,\n              height: rect_height,\n              borderColor: color,\n              borderWidth: 2,\n              borderOpacity: 0.8,\n            });\n            \n            // Add text comment if present\n            if (annotation.contents) {\n              const comment_color_str = (annotation.color || square_config.square_border_color).trim();\n              let comment_r = 0, comment_g = 0, comment_b = 0;\n              \n              // Parse color (hex or rgb format)\n              const rgb_pattern = /^rgb\\s*\\(\\s*(\\d+)\\s*,\\s*(\\d+)\\s*,\\s*(\\d+)\\s*\\)$/i;\n              const rgb_match = comment_color_str.match(rgb_pattern);\n              if (rgb_match) {\n                comment_r = parseInt(rgb_match[1], 10) / 255;\n                comment_g = parseInt(rgb_match[2], 10) / 255;\n                comment_b = parseInt(rgb_match[3], 10) / 255;\n              } else if (comment_color_str.startsWith('#')) {\n                const hex = comment_color_str.slice(1).trim();\n                if (hex.length === 6 && /^[0-9A-Fa-f]{6}$/.test(hex)) {\n                  comment_r = parseInt(hex.substring(0, 2), 16) / 255;\n                  comment_g = parseInt(hex.substring(2, 4), 16) / 255;\n                  comment_b = parseInt(hex.substring(4, 6), 16) / 255;\n                }\n              }\n              \n              page.drawText(annotation.contents, {\n                x: rect_x,\n                y: rect_y + rect_height + 5,\n                size: fonts_config.freetext_font_size_default,\n                color: rgb(comment_r, comment_g, comment_b),\n              });\n            }\n            break;\n          }\n          \n          case 'Highlight': {\n            // Create a highlight annotation (semi-transparent rectangle)\n            const highlight_color_str = (annotation.color || highlight_config.highlight_fill_color).trim();\n            let highlight_r = 255 / 255, highlight_g = 255 / 255, highlight_b = 0 / 255; // Default yellow\n            \n            // Parse color (hex or rgb format)\n            const rgb_pattern = /^rgb\\s*\\(\\s*(\\d+)\\s*,\\s*(\\d+)\\s*,\\s*(\\d+)\\s*\\)$/i;\n            const rgb_match = highlight_color_str.match(rgb_pattern);\n            if (rgb_match) {\n              highlight_r = parseInt(rgb_match[1], 10) / 255;\n              highlight_g = parseInt(rgb_match[2], 10) / 255;\n              highlight_b = parseInt(rgb_match[3], 10) / 255;\n            } else if (highlight_color_str.startsWith('#')) {\n              const hex = highlight_color_str.slice(1).trim();\n              if (hex.length === 6 && /^[0-9A-Fa-f]{6}$/.test(hex)) {\n                highlight_r = parseInt(hex.substring(0, 2), 16) / 255;\n                highlight_g = parseInt(hex.substring(2, 4), 16) / 255;\n                highlight_b = parseInt(hex.substring(4, 6), 16) / 255;\n              }\n            }\n            const highlight_color = rgb(highlight_r, highlight_g, highlight_b);\n            \n            page.drawRectangle({\n              x: rect_x,\n              y: rect_y,\n              width: rect_width,\n              height: rect_height,\n              color: highlight_color,\n              opacity: highlight_config.highlight_fill_opacity,\n            });\n            \n            // Add text comment if present\n            if (annotation.contents) {\n              page.drawText(annotation.contents, {\n                x: rect_x,\n                y: rect_y + rect_height + 5,\n                size: fonts_config.freetext_font_size_default,\n                color: rgb(0, 0, 0),\n              });\n            }\n            break;\n          }\n          \n          case 'FreeText': {\n            // Create a free text annotation\n            if (annotation.contents) {\n              // Text color priority: annotation.color > freetext_text_color > font_foreground_color > default black\n              const text_color_str = (annotation.color || \n                                    freetext_config.freetext_text_color || \n                                    fonts_config.font_foreground_color || \n                                    '#000000').trim();\n              let text_r = 0, text_g = 0, text_b = 0;\n              \n              // Parse color (hex or rgb format)\n              const rgb_pattern = /^rgb\\s*\\(\\s*(\\d+)\\s*,\\s*(\\d+)\\s*,\\s*(\\d+)\\s*\\)$/i;\n              const rgb_match = text_color_str.match(rgb_pattern);\n              if (rgb_match) {\n                text_r = parseInt(rgb_match[1], 10) / 255;\n                text_g = parseInt(rgb_match[2], 10) / 255;\n                text_b = parseInt(rgb_match[3], 10) / 255;\n              } else if (text_color_str.startsWith('#')) {\n                const hex = text_color_str.slice(1).trim();\n                if (hex.length === 6 && /^[0-9A-Fa-f]{6}$/.test(hex)) {\n                  text_r = parseInt(hex.substring(0, 2), 16) / 255;\n                  text_g = parseInt(hex.substring(2, 4), 16) / 255;\n                  text_b = parseInt(hex.substring(4, 6), 16) / 255;\n                }\n              }\n              \n              page.drawText(annotation.contents, {\n                x: rect_x,\n                y: rect_y,\n                size: fonts_config.freetext_font_size_default,\n                color: rgb(text_r, text_g, text_b),\n                maxWidth: rect_width,\n              });\n            }\n            break;\n          }\n          \n          default:\n            console.warn(`[PDF Saver] Unsupported annotation type: ${annotation.type}`);\n        }\n      } catch (annotation_error) {\n        console.error(`[PDF Saver] Error adding annotation ${annotation.id}:`, annotation_error);\n        // Continue with other annotations\n      }\n    }\n    \n    // Save the PDF\n    const modified_pdf_bytes = await pdf_doc.save();\n    console.log('[PDF Saver] PDF modified, size:', modified_pdf_bytes.length, 'bytes');\n    \n    return modified_pdf_bytes;\n  } catch (error) {\n    if (error && typeof error === 'object' && 'message' in error && \n        typeof error.message === 'string' && error.message.includes('pdf-lib')) {\n      throw new Error('pdf-lib is required to save annotations to PDF. Please install it: npm install pdf-lib');\n    }\n    console.error('[PDF Saver] Error saving PDF:', error);\n    throw error;\n  }\n}\n\n/**\n * Download PDF bytes as a file\n * @param pdf_bytes - PDF file bytes\n * @param filename - Name for the downloaded file\n */\nexport function download_pdf(pdf_bytes: Uint8Array, filename: string): void {\n  // Create a new ArrayBuffer view to ensure compatibility with Blob constructor\n  // Uint8Array.buffer can be SharedArrayBuffer, which Blob doesn't accept directly\n  const buffer = new Uint8Array(pdf_bytes).buffer;\n  const blob = new Blob([buffer], { type: 'application/pdf' });\n  const url = URL.createObjectURL(blob);\n  const link = document.createElement('a');\n  link.href = url;\n  link.download = filename;\n  document.body.appendChild(link);\n  link.click();\n  document.body.removeChild(link);\n  URL.revokeObjectURL(url);\n}\n\n/**\n * Save annotations to PDF and download\n * @param pdf_url - URL of the PDF file\n * @param annotations - Array of annotations to save\n * @param output_filename - Name for the saved PDF file (default: original filename with '_annotated' suffix)\n * @param config - Optional configuration for styling values\n */\nexport async function save_and_download_pdf(\n  pdf_url: string,\n  annotations: PdfAnnotation[],\n  output_filename?: string,\n  config?: PdfViewerConfig | null\n): Promise<void> {\n  const pdf_bytes = await save_annotations_to_pdf(pdf_url, annotations, output_filename, config);\n  \n  // Generate output filename\n  const original_filename = pdf_url.split('/').pop() || 'document.pdf';\n  const filename_without_ext = original_filename.replace(/\\.pdf$/i, '');\n  const final_filename = output_filename || `${filename_without_ext}_annotated.pdf`;\n  \n  // Download the modified PDF\n  download_pdf(pdf_bytes, final_filename);\n  console.log('[PDF Saver] PDF saved as:', final_filename);\n}\n\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -127,6 +127,68 @@ interface PdfViewerConfig {
         /** Opacity for disabled dialog buttons (0.0 to 1.0) */
         dialog_button_disabled_opacity: number;
     };
+    toolbar: {
+        /** Background color for toolbar (hex format: #RRGGBB or rgb(r, g, b)) */
+        toolbar_background_color: string;
+        /** Border color for toolbar (hex format: #RRGGBB or rgb(r, g, b)) */
+        toolbar_border_color: string;
+        /** Font family for toolbar text */
+        toolbar_font_family: string;
+        /** Font size for toolbar text (pixels) */
+        toolbar_font_size: number;
+        /** Font color for toolbar text (hex format: #RRGGBB or rgb(r, g, b)) */
+        toolbar_font_color: string;
+        /** Button background color (hex format: #RRGGBB or rgb(r, g, b)) */
+        toolbar_button_background_color: string;
+        /** Button background color on hover (hex format: #RRGGBB or rgb(r, g, b)) */
+        toolbar_button_background_color_hover: string;
+        /** Button text color (hex format: #RRGGBB or rgb(r, g, b)) */
+        toolbar_button_text_color: string;
+        /** Active button background color (hex format: #RRGGBB or rgb(r, g, b)) */
+        toolbar_button_active_background_color: string;
+        /** Active button text color (hex format: #RRGGBB or rgb(r, g, b)) */
+        toolbar_button_active_text_color: string;
+        /** Save button background color (hex format: #RRGGBB or rgb(r, g, b)) */
+        toolbar_button_save_background_color: string;
+        /** Save button background color on hover (hex format: #RRGGBB or rgb(r, g, b)) */
+        toolbar_button_save_background_color_hover: string;
+        /** Save button text color (hex format: #RRGGBB or rgb(r, g, b)) */
+        toolbar_button_save_text_color: string;
+        /** Disabled button opacity (0.0 to 1.0) */
+        toolbar_button_disabled_opacity: number;
+        /** Whether to show zoom controls (true/false) */
+        toolbar_show_zoom_controls: boolean;
+        /** Whether to show square annotation button (true/false) */
+        toolbar_show_square_button: boolean;
+        /** Whether to show undo button (true/false) */
+        toolbar_show_undo_button: boolean;
+        /** Whether to show redo button (true/false) */
+        toolbar_show_redo_button: boolean;
+        /** Whether to show save button (true/false) */
+        toolbar_show_save_button: boolean;
+        /** Whether to show metadata panel button (true/false) */
+        toolbar_show_metadata_button: boolean;
+        /** Whether to show annotate (FreeText) button (true/false) */
+        toolbar_show_annotate_button: boolean;
+        /** Label for zoom out button (default: "−") */
+        toolbar_zoom_out_label: string;
+        /** Label for zoom in button (default: "+") */
+        toolbar_zoom_in_label: string;
+        /** Label for reset zoom button (default: "Reset") */
+        toolbar_zoom_reset_label: string;
+        /** Label for square annotation button (default: "Square") */
+        toolbar_square_label: string;
+        /** Label for undo button (default: "Undo") */
+        toolbar_undo_label: string;
+        /** Label for redo button (default: "Redo") */
+        toolbar_redo_label: string;
+        /** Label for save button (default: "Save") */
+        toolbar_save_label: string;
+        /** Label for saving button (default: "Saving...") */
+        toolbar_saving_label: string;
+        /** Label for metadata panel button (default: "Metadata") */
+        toolbar_metadata_label: string;
+    };
 }
 
 /**
@@ -160,7 +222,7 @@ interface PdfViewerProps {
     on_save?: (pdf_bytes: Uint8Array, filename: string) => void;
     /** Background color for areas outside PDF pages (default: dark grey) */
     background_color?: string;
-    /** Optional path to configuration INI file (e.g., "hazo_pdf_config.ini") */
+    /** Optional path to configuration INI file (e.g., "config/hazo_pdf_config.ini") */
     config_file?: string;
     /** Whether to append timestamp to annotated text edits (default: false) */
     append_timestamp_to_text_edits?: boolean;
@@ -181,6 +243,24 @@ interface PdfViewerProps {
         updatedRow: MetadataDataItem;
         allData: MetadataInput;
     };
+    /** Whether to show the toolbar at all (default: true) */
+    toolbar_enabled?: boolean;
+    /** Whether to show zoom controls (default: true) */
+    show_zoom_controls?: boolean;
+    /** Whether to show square annotation button (default: true) */
+    show_square_button?: boolean;
+    /** Whether to show undo button (default: true) */
+    show_undo_button?: boolean;
+    /** Whether to show redo button (default: true) */
+    show_redo_button?: boolean;
+    /** Whether to show save button (default: true) */
+    show_save_button?: boolean;
+    /** Whether to show metadata panel button (default: true, only visible when sidepanel_metadata_enabled) */
+    show_metadata_button?: boolean;
+    /** Whether to show annotate (FreeText) button (default: true) */
+    show_annotate_button?: boolean;
+    /** Callback when close button is clicked (shows close button in toolbar when provided) */
+    on_close?: () => void;
 }
 /**
  * PDF Annotation interface matching PDF standard
@@ -353,6 +433,7 @@ interface PdfViewerLayoutProps {
     on_annotation_create: (annotation: PdfAnnotation) => void;
     on_context_menu: (e: React.MouseEvent, page_index: number, screen_x: number, screen_y: number, mapper: CoordinateMapper) => void;
     on_annotation_click: (annotation: PdfAnnotation, screen_x: number, screen_y: number, mapper: CoordinateMapper) => void;
+    on_freetext_click?: (page_index: number, screen_x: number, screen_y: number, mapper: CoordinateMapper) => void;
     background_color?: string;
     config: PdfViewerConfig | null;
     className?: string;
@@ -419,6 +500,8 @@ interface AnnotationOverlayProps {
     on_context_menu?: (event: React.MouseEvent, screen_x: number, screen_y: number) => void;
     /** Callback when annotation is clicked */
     on_annotation_click?: (annotation: PdfAnnotation, screen_x: number, screen_y: number) => void;
+    /** Callback when FreeText tool is active and user clicks on empty area */
+    on_freetext_click?: (screen_x: number, screen_y: number) => void;
     /** Configuration object for styling */
     config?: PdfViewerConfig | null;
     /** Optional class name */