react-vector-pdf 0.3.8 → 0.5.0

package/README.md

@@ -188,18 +188,15 @@ Embed images (JPEG/PNG).
 <PdfImage src="https://example.com/logo.png" h={20} align="center" />
 ```
 
-### 4. `PdfView` & `PdfBox`
+### 4. `PdfView`
 
-Containers for grouping content, adding borders, backgrounds, or margins/padding.
+A container component for grouping content, adding borders, backgrounds, or margins/padding. It is the primary container for both flow and absolute layouts.
 
-`PdfView` is akin to a block-level `div`, and `PdfBox` is similar but allows explicit positioning.
-
-**Styling Support:**
+**Props:**
 
-- `margin` / `padding`: Shorthand (number or object `{top, right...}`).
-- **Granular Props**: `marginTop`, `marginBottom`, `paddingLeft`, `paddingRight`, etc.
-- `borderWidth`, `borderColor`: Draw borders.
-- `fillColor`: Background color.
+- `style`: Object with `margin`, `padding` (granular: `marginTop`, `paddingLeft` etc.), `borderWidth`, `borderColor`, `fillColor`, `radius`.
+- `x`, `y`, `w`, `h`: Optional props for **absolute positioning**. If provided, the view will be placed at exactly these coordinates.
+- `children`: Nested components to render inside the view.
 
 ```tsx
 <PdfView

package/dist/index.d.ts

@@ -47,16 +47,6 @@ export declare interface PageNumberOptions {
 
 export declare type PageNumberPreset = "page-slash-total" | "slash" | "page-of-total";
 
-export declare const PdfBox: default_2.FC<PdfBoxProps>;
-
-declare interface PdfBoxProps extends BoxStyle {
-    x?: number;
-    y?: number;
-    w?: number;
-    h?: number;
-    children?: default_2.ReactNode;
-}
-
 export declare const PdfDocument: default_2.FC<PdfDocumentProps>;
 
 declare interface PdfDocumentProps {
@@ -89,7 +79,11 @@ declare interface PdfImageProps {
     h?: number;
     mime?: "PNG" | "JPEG";
     flow?: boolean;
+    layout?: "fixed" | "flow";
+    sizing?: "fit" | "fill" | "auto";
     align?: "left" | "center" | "right";
+    showInAllPages?: boolean;
+    scope?: "all" | "first-only" | "except-first" | number[];
 }
 
 export declare const PdfList: default_2.FC<PdfListProps>;
@@ -150,6 +144,7 @@ export declare class PdfRenderer {
     private pendingTasks;
     private opQueue;
     private generation;
+    private recurringItems;
     constructor(opts?: PDFOptions);
     get instance(): jsPDF;
     get width(): number;
@@ -201,6 +196,12 @@ export declare class PdfRenderer {
         y: number;
     };
     getPageCount(): number;
+    registerRecurringItem(item: {
+        draw: () => void;
+        scope: any;
+        y: number;
+        height: number;
+    }): void;
     applyHeaderFooter(): void;
     measureText(text: string, style?: TextStyle, maxWidth?: number): {
         width: number;
@@ -234,6 +235,8 @@ declare interface PdfTableProps {
     rowStyle?: TextStyle & BoxStyle;
     alternateRowStyle?: TextStyle & BoxStyle;
     headerHeight?: number;
+    repeatHeader?: boolean;
+    striped?: boolean;
 }
 
 export declare const PdfText: default_2.FC<PdfTextProps>;
@@ -252,6 +255,10 @@ declare interface PdfViewProps {
     style?: ViewStyle;
     children?: default_2.ReactNode;
     debug?: boolean;
+    x?: number;
+    y?: number;
+    w?: number;
+    h?: number;
 }
 
 declare interface TableColumn {
@@ -269,6 +276,8 @@ export declare interface TextStyle {
     align?: Align;
     verticalAlign?: "top" | "middle" | "bottom";
     lineHeight?: number;
+    showInAllPages?: boolean;
+    scope?: "all" | "first-only" | "except-first" | number[];
 }
 
 export declare interface ViewStyle extends BoxStyle {
@@ -284,6 +293,8 @@ export declare interface ViewStyle extends BoxStyle {
     marginLeft?: number;
     width?: number | string;
     height?: number;
+    showInAllPages?: boolean;
+    scope?: "all" | "first-only" | "except-first" | number[];
 }
 
 export { }