hazo_pdf 1.6.1 → 1.6.4

package/README.md

@@ -879,6 +879,7 @@ You can override any or all of these on a per-highlight basis.
 |------|------|---------|-------------|
 | `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. |
+| `fit_to_width` | `boolean` | `false` | If `true`, automatically scales the PDF to fit the container width. Manual zoom buttons override auto-scaling. Container must have explicit dimensions. |
 | `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., `"config/hazo_pdf_config.ini"`). If not provided, uses default configuration. |
 | `logger` | `Logger` | `undefined` | Logger instance from hazo_logs or custom logger matching the Logger interface. If not provided, falls back to console-based logging. Useful for debugging and monitoring PDF operations. |
@@ -1033,6 +1034,7 @@ Props to control toolbar button visibility. These override config file values.
 | `show_download_button` | `boolean` | `false` | Show Download button. Downloads the PDF with annotations baked in. |
 | `show_extract_button` | `boolean` | `false` | Show Extract button for data extraction. Requires extraction props to be configured. |
 | `download_filename` | `string` | `undefined` | Custom filename for the downloaded PDF. Defaults to the original filename or `"document.pdf"`. |
+| `display_filename` | `string` | `undefined` | Override the displayed filename in the file info sidepanel. Useful when `url` is an API endpoint that produces a non-human-readable path. |
 | `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:**
@@ -1318,6 +1320,28 @@ The PDF viewer includes a toolbar at the top with the following controls:
 - Click "Reset" to return to default zoom
 - Zoom affects the PDF page size but maintains aspect ratio
 
+### Fit-to-Width Mode
+
+Enable automatic width-based scaling with the `fit_to_width` prop:
+
+```tsx
+<PdfViewer
+  url="/document.pdf"
+  fit_to_width={true}
+/>
+```
+
+**Behavior:**
+- When enabled, the PDF automatically scales to fit the container width on initial load and after window resize
+- User can manually zoom in/out with zoom buttons, which disables auto-scaling for that session
+- Changing the `fit_to_width` prop value re-enables auto-scaling behavior
+- Use case: Viewing documents where full-width display is preferred (e.g., forms, contracts)
+
+**Technical Notes:**
+- Does not conflict with the `scale` prop (scale is the initial value, fit_to_width can override it after render)
+- Manual zoom buttons override fit-to-width mode, allowing users to adjust as needed
+- Container must have explicit width and height (see [Container Requirements](#container-requirements))
+
 ### Annotation Tools
 
 - **Square button**: Activates square/rectangle annotation tool

package/dist/{chunk-YEHKU7NV.js → chunk-EPV2C5AQ.js}

@@ -657,7 +657,7 @@ var AnnotationOverlay = ({
           e.stopPropagation();
           e.nativeEvent.stopImmediatePropagation();
           log_annotation_click(annotation, "svg_hit_test", point);
-          on_annotation_click(annotation, point.x, point.y);
+          on_annotation_click(annotation, point.x, point.y, e.clientX, e.clientY);
           return;
         }
       }
@@ -673,7 +673,7 @@ var AnnotationOverlay = ({
       e.preventDefault();
       e.stopPropagation();
       if (on_freetext_click) {
-        on_freetext_click(point.x, point.y);
+        on_freetext_click(point.x, point.y, e.clientX, e.clientY);
       }
       return;
     }
@@ -906,7 +906,7 @@ var AnnotationOverlay = ({
                 const click_x = e.clientX - rect.left;
                 const click_y = e.clientY - rect.top;
                 log_annotation_click(annotation, "freetext_rect", { x: click_x, y: click_y });
-                on_annotation_click(annotation, click_x, click_y);
+                on_annotation_click(annotation, click_x, click_y, e.clientX, e.clientY);
               }
             },
             onClick: (e) => {
@@ -1020,7 +1020,7 @@ var AnnotationOverlay = ({
               const click_x = e.clientX - rect.left;
               const click_y = e.clientY - rect.top;
               log_annotation_click(annotation, "rect_overlay", { x: click_x, y: click_y });
-              on_annotation_click(annotation, click_x, click_y);
+              on_annotation_click(annotation, click_x, click_y, e.clientX, e.clientY);
             }
           },
           onClick: (e) => {
@@ -1349,14 +1349,14 @@ var PdfViewerLayout = ({
                       on_context_menu(e, index, screen_x, screen_y, mapper_data.mapper);
                     }
                   },
-                  on_annotation_click: (annotation, screen_x, screen_y) => {
+                  on_annotation_click: (annotation, screen_x, screen_y, viewport_x, viewport_y) => {
                     if (on_annotation_click && mapper_data.mapper) {
-                      on_annotation_click(annotation, screen_x, screen_y, mapper_data.mapper);
+                      on_annotation_click(annotation, screen_x, screen_y, mapper_data.mapper, viewport_x, viewport_y);
                     }
                   },
-                  on_freetext_click: (screen_x, screen_y) => {
+                  on_freetext_click: (screen_x, screen_y, viewport_x, viewport_y) => {
                     if (on_freetext_click && mapper_data.mapper) {
-                      on_freetext_click(index, screen_x, screen_y, mapper_data.mapper);
+                      on_freetext_click(index, screen_x, screen_y, mapper_data.mapper, viewport_x, viewport_y);
                     }
                   }
                 }
@@ -4543,6 +4543,7 @@ var PdfViewer = forwardRef(({
   on_files_change,
   // file_manager_display_mode is reserved for future use (dialog/standalone modes)
   download_filename,
+  display_filename,
   on_download,
   enable_popout = false,
   popout_route = "/pdf-viewer",
@@ -4610,6 +4611,7 @@ var PdfViewer = forwardRef(({
   }, []);
   const content_container_ref = useRef11(null);
   const [first_page_width, setFirstPageWidth] = useState13(null);
+  const [fit_to_width_active, setFitToWidthActive] = useState13(fit_to_width);
   useEffect10(() => {
     if (files && files.length > 0) {
       if (!current_file || !files.find((f) => f.id === current_file.id)) {
@@ -4993,7 +4995,10 @@ ${suffix_line}`;
     });
   }, [pdf_document]);
   useEffect10(() => {
-    if (!fit_to_width || !first_page_width || !content_container_ref.current) {
+    setFitToWidthActive(fit_to_width);
+  }, [fit_to_width]);
+  useEffect10(() => {
+    if (!fit_to_width_active || !first_page_width || !content_container_ref.current) {
       return;
     }
     const calculate_fit_scale = () => {
@@ -5002,9 +5007,7 @@ ${suffix_line}`;
       const padding = 40;
       const available_width = container_width - padding;
       const new_scale = Math.max(0.1, Math.min(3, available_width / first_page_width));
-      if (Math.abs(new_scale - scale) > 0.01) {
-        setScale(new_scale);
-      }
+      setScale(new_scale);
     };
     calculate_fit_scale();
     const resize_observer = new ResizeObserver(() => {
@@ -5014,7 +5017,7 @@ ${suffix_line}`;
     return () => {
       resize_observer.disconnect();
     };
-  }, [fit_to_width, first_page_width, scale]);
+  }, [fit_to_width_active, first_page_width]);
   const save_to_history = (new_annotations) => {
     if (history_ref.current.saving) {
       return;
@@ -5160,13 +5163,19 @@ ${suffix_line}`;
     };
   }, [handle_undo, handle_redo]);
   const handle_zoom_in = () => {
+    setFitToWidthActive(false);
     setScale((prev) => Math.min(prev + 0.25, 3));
   };
   const handle_zoom_out = () => {
+    setFitToWidthActive(false);
     setScale((prev) => Math.max(prev - 0.25, 0.5));
   };
   const handle_zoom_reset = () => {
-    setScale(1);
+    if (fit_to_width) {
+      setFitToWidthActive(true);
+    } else {
+      setScale(1);
+    }
   };
   const normalize_rotation = (rotation) => {
     let normalized = rotation % 360;
@@ -5447,7 +5456,7 @@ ${suffix_line}`;
     setExtractError(null);
     try {
       const logger2 = get_logger();
-      const current_filename = is_multi_file_mode ? current_file?.name : url ? url.split("/").pop() || "unknown" : "unknown";
+      const current_filename = is_multi_file_mode ? current_file?.name : display_filename || (url ? url.split("/").pop() || "unknown" : "unknown");
       logger2.info("[PdfViewer] Starting data extraction", { filename: current_filename });
       const bytes = new Uint8Array(cached_pdf_data);
       let binary = "";
@@ -6014,18 +6023,17 @@ ${suffix_line}`;
                 page_rotations,
                 on_visible_page_change: handle_visible_page_change,
                 on_annotation_create: handle_annotation_create,
-                on_annotation_click: (annotation, screen_x, screen_y, mapper) => {
+                on_annotation_click: (annotation, screen_x, screen_y, mapper, viewport_x, viewport_y) => {
                   console.log(
                     `\u{1F7E0} [AnnotationClick] opening editor id=${annotation.id}, page=${annotation.page_index}, screen=(${screen_x.toFixed(
                       1
                     )}, ${screen_y.toFixed(1)})`
                   );
-                  const dialog_x = window.innerWidth / 2;
-                  const dialog_y = Math.max(50, screen_y);
+                  const dialog_y = Math.max(50, viewport_y);
                   setTextDialog({
                     open: true,
                     page_index: annotation.page_index,
-                    x: dialog_x,
+                    x: viewport_x,
                     y: dialog_y,
                     screen_x,
                     screen_y,
@@ -6046,12 +6054,12 @@ ${suffix_line}`;
                     mapper
                   });
                 },
-                on_freetext_click: (page_index, screen_x, screen_y, mapper) => {
+                on_freetext_click: (page_index, screen_x, screen_y, mapper, viewport_x, viewport_y) => {
                   setTextDialog({
                     open: true,
                     page_index,
-                    x: screen_x,
-                    y: screen_y,
+                    x: viewport_x,
+                    y: viewport_y,
                     screen_x,
                     screen_y,
                     mapper
@@ -6079,7 +6087,7 @@ ${suffix_line}`;
             is_open: file_info_sidepanel_open,
             on_toggle: handle_file_info_sidepanel_toggle,
             item: (() => {
-              const filename = current_file?.name || (url ? url.split("/").pop() || "" : "");
+              const filename = current_file?.name || display_filename || (url ? url.split("/").pop() || "" : "");
               const filepath = effective_url || "";
               if (!filename) return null;
               return {
@@ -6093,7 +6101,7 @@ ${suffix_line}`;
             width: file_info_sidepanel_width,
             on_width_change: handle_file_info_sidepanel_width_change,
             file_metadata,
-            current_filename: current_file?.name || (url ? url.split("/").pop() || "" : ""),
+            current_filename: current_file?.name || display_filename || (url ? url.split("/").pop() || "" : ""),
             doc_data,
             highlight_fields_info
           }
@@ -6307,4 +6315,4 @@ export {
   PdfViewer,
   pdf_viewer_default
 };
-//# sourceMappingURL=chunk-YEHKU7NV.js.map
+//# sourceMappingURL=chunk-EPV2C5AQ.js.map