pols-pdf 1.0.0

package/README.md

@@ -0,0 +1,216 @@
+# Pols-Pdf
+
+Clase en TypeScript/JavaScript que encapsula [`pdfkit`](https://pdfkit.org/) para agregar
+primitivas de maquetado que `pdfkit` no ofrece de forma nativa: rectángulos con bordes y esquinas
+redondeadas independientes por lado, tablas con paginación automática, celdas con texto
+carácter-por-carácter (wrap, alineación, espaciado, fuentes mixtas) e imágenes con ajuste
+`proportional`/`cover`/`stretch`.
+
+## Instalación
+
+```bash
+npm install pols-pdf
+```
+
+---
+
+## Inicio rápido
+
+```typescript
+import fs from 'fs'
+import { PPdf } from 'pols-pdf'
+
+const pdf = new PPdf({ title: 'Reporte' })
+
+pdf.cell({ text: 'Hola mundo', height: 20 })
+
+pdf.build().pipe(fs.createWriteStream('output.pdf'))
+```
+
+`build()` cierra el documento y devuelve el `PDFDocument` de `pdfkit` (que ya es un
+`stream.Readable`), listo para ser canalizado (`pipe`) a un archivo, a la respuesta HTTP, etc.
+
+---
+
+## Constructor
+
+```typescript
+new PPdf(params?: {
+	title?: string
+	page?: Partial<PPage>
+	template?: () => void
+	addFirstPage?: boolean
+})
+```
+
+- `title`: título del documento (metadato PDF). También accesible/editable luego vía `pdf.title`.
+- `page`: configuración de página por defecto (`size`, `layout`, `margins`), ver [`PPage`](#ppage).
+- `template`: función que se ejecuta automáticamente cada vez que se agrega una página
+  (`addPage`), útil para dibujar encabezados/pies de página repetidos.
+- `addFirstPage`: si es `false`, no agrega la primera página automáticamente (por defecto `true`).
+
+---
+
+## El cursor
+
+`PPdf` mantiene internamente un cursor `{ left, top }` que la mayoría de los métodos de dibujo
+leen como posición por defecto y actualizan después de dibujar. Se puede leer y mover manualmente:
+
+```typescript
+pdf.getCursorLeftPosition()
+pdf.getCursorTopPosition()
+pdf.getBottomSpaceQuantity()   // espacio restante hasta el borde inferior de la página
+pdf.getPageWidth()
+
+pdf.setCursorLeftPosition('left')  // vuelve al margen izquierdo
+pdf.setCursorLeftPosition(50)
+pdf.moveCursorLeft(20)
+
+pdf.setCursorTopPosition('top')    // vuelve al margen superior
+pdf.setCursorTopPosition(100)
+pdf.moveCursorTop(20)              // si autoJump (por defecto true) y se pasa del margen inferior, agrega una página nueva
+```
+
+---
+
+## Páginas
+
+```typescript
+pdf.addPage({ size: 'LETTER', layout: 'landscape', margins: 30 })
+```
+
+`margins` (como todos los parámetros de tipo `*BoundParams` en esta librería) acepta un único
+número para los cuatro lados, o un objeto parcial `{ top?, right?, bottom?, left? }`.
+
+---
+
+## Rectángulos
+
+```typescript
+pdf.rectangle({
+	left: 20,
+	top: 20,
+	width: 200,
+	height: 80,
+	fillColor: '#eeeeee',
+	border: true,                 // o { left, right, top, bottom } individuales
+	radius: 8,                    // o { leftTop, rightTop, rightBottom, leftBottom }
+	stroke: { width: 1, color: '#333333' }
+})
+```
+
+`rectangleTo(params)` dibuja un rectángulo desde la posición actual del cursor hasta el punto
+`{ left, top }` indicado (ancho/alto se calculan como la diferencia con el cursor).
+
+---
+
+## Celdas de texto (`cell`)
+
+```typescript
+pdf.cell({
+	text: 'Texto de la celda',
+	width: 200,
+	height: 40,                 // o autojump: true si no se conoce el alto de antemano
+	padding: 6,
+	hAlign: 'center',
+	vAlign: 'center',
+	font: { size: 12, bold: true, color: '#111111' },
+	border: true,
+	fillColor: '#f5f5f5'
+})
+```
+
+- `text` acepta `string`, `number`, `null`/`undefined`, un objeto `{ chars, font? }`, o un arreglo
+  de estos últimos para mezclar fuentes/estilos dentro de una misma celda.
+- Una celda necesita **o bien** `height` (alto fijo) **o bien** `autojump: true` (el alto se
+  calcula según el contenido y, si no entra en la página actual, el texto restante continúa
+  automáticamente en una página nueva).
+- Si el contenido no entra en la página, `cell()` agrega una página nueva y continúa dibujando el
+  resto automáticamente.
+
+---
+
+## Filas y tablas (`row` / `table`)
+
+```typescript
+pdf.table({
+	width: 'full',              // 'full' | 'auto' | número
+	border: true,
+	padding: 4,
+	rows: [
+		{
+			fillColor: '#dddddd',
+			cells: [
+				{ text: 'Nombre', weight: 2 },
+				{ text: 'Edad', weight: 1 },
+			]
+		},
+		{
+			cells: [
+				{ text: 'Ana', weight: 2 },
+				{ text: '30', weight: 1 },
+			]
+		}
+	]
+})
+```
+
+- Cada celda de una fila define su ancho con `width` (número fijo) **o** `weight` (proporción del
+  ancho disponible restante), nunca ambos.
+- `table()` va maquetando fila por fila; en cuanto una fila no entra en la página actual, dibuja
+  el buffer acumulado, agrega una página nueva y continúa con el resto — una tabla puede así
+  abarcar varias páginas sin que el llamador tenga que ocuparse de la paginación.
+- `row()` expone el mismo mecanismo para dibujar una única fila suelta (fuera de una tabla).
+
+---
+
+## Imágenes
+
+```typescript
+pdf.image({ filePath: 'logo.png', left: 20, top: 20, width: 120 })
+
+pdf.image({
+	filePath: 'foto.jpg',
+	left: 20,
+	top: 20,
+	width: 200,
+	height: 120,
+	fill: 'cover',           // 'stretch' | 'proportional' | 'cover'
+	hAlign: 'center',
+	vAlign: 'center'
+})
+```
+
+---
+
+## Fuentes
+
+```typescript
+pdf.setFont({ name: 'Helvetica', bold: true, size: 14, color: '#000000' })
+```
+
+Cambia la fuente activa del documento; los métodos de texto (`cell`, `row`, `table`) también
+aceptan `font` por llamada (y por fragmento de texto individual dentro de `text`), sin necesidad
+de llamar a `setFont` explícitamente.
+
+---
+
+## Tipos con forma abreviada (`*Params`)
+
+Los parámetros de borde, radio y márgenes/padding aceptan una forma abreviada además del objeto
+completo:
+
+| Tipo | Forma corta | Forma completa |
+|---|---|---|
+| `PBoundParams` (`padding`, `margins`) | `number` (aplica a los 4 lados) | `{ top?, right?, bottom?, left? }` |
+| `PRadiusParams` (`radius`) | `number` | `{ leftTop?, rightTop?, rightBottom?, leftBottom? }` |
+| `PBorderParams` (`border`) | `boolean` | `{ leftTop?, top?, rightTop?, right?, rightBottom?, bottom?, leftBottom?, left? }` |
+| `PBorderColorParams` (`stroke.color`) | `string` (color aplicado a los 4/8 lados) | `{ top?, rightTop?, right?, rightBottom?, bottom?, leftBottom?, left?, leftTop? }` |
+
+---
+
+## Convención de nombres
+
+Todas las clases y tipos exportados llevan el prefijo `P` (`PPdf`, `PCell`, `PRowParams`, etc.),
+siguiendo la convención usada en los paquetes hermanos de este ecosistema: `pols-date` (`PDate`)
+y `pols-utils` (`PRecord`, `PUtilsNumber`).

package/dist/index.d.ts

@@ -0,0 +1,287 @@
+export type PBoundParams = number | {
+    top?: number;
+    bottom?: number;
+    left?: number;
+    right?: number;
+};
+export type PBound = {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+};
+export type PRadiusParams = number | {
+    leftTop?: number;
+    rightTop?: number;
+    rightBottom?: number;
+    leftBottom?: number;
+};
+export type PRadius = {
+    leftTop: number;
+    rightTop: number;
+    rightBottom: number;
+    leftBottom: number;
+};
+export type PBorderParams = boolean | {
+    leftTop?: boolean;
+    top?: boolean;
+    rightTop?: boolean;
+    right?: boolean;
+    rightBottom?: boolean;
+    bottom?: boolean;
+    leftBottom?: boolean;
+    left?: boolean;
+};
+export type PBorder = {
+    leftTop: boolean;
+    top: boolean;
+    rightTop: boolean;
+    right: boolean;
+    rightBottom: boolean;
+    bottom: boolean;
+    leftBottom: boolean;
+    left: boolean;
+};
+export type PBorderColorParams = string | {
+    top?: string;
+    rightTop?: string;
+    right?: string;
+    rightBottom?: string;
+    bottom?: string;
+    leftBottom?: string;
+    left?: string;
+    leftTop?: string;
+};
+export type PBorderColor = {
+    top: string;
+    rightTop: string;
+    right: string;
+    rightBottom: string;
+    bottom: string;
+    leftBottom: string;
+    left: string;
+    leftTop: string;
+};
+export type PPage = {
+    size: 'A4' | 'LETTER';
+    layout: 'portrait' | 'landscape';
+    margins: PBoundParams;
+};
+export type PFont = {
+    name: string;
+    bold: boolean;
+    oblique: boolean;
+    size: number;
+    color: string;
+};
+export type PImage = {
+    filePath: string | Buffer;
+    left?: number;
+    top?: number;
+} & ({
+    width?: number;
+} | {
+    height?: number;
+} | {
+    width?: number;
+    height?: number;
+    fill?: 'stretch';
+} | {
+    width?: number;
+    height?: number;
+    fill?: 'proportional' | 'cover';
+    hAlign?: 'left' | 'center' | 'right';
+    vAlign?: 'top' | 'center' | 'bottom';
+});
+export type PRectangle = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    stroke?: {
+        width?: number;
+        color?: PBorderColorParams;
+    };
+    fillColor?: string;
+    border?: boolean | {
+        left?: boolean;
+        right?: boolean;
+        top?: boolean;
+        bottom?: boolean;
+    };
+    radius?: PRadiusParams;
+};
+export type PTextParams = {
+    chars: string;
+    font?: Partial<PFont>;
+};
+type PLetter = {
+    char: string;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    font: PFont;
+};
+export type PCell = {
+    letters: PLetter[];
+    left: number;
+    top: number;
+    height: number;
+    width: number;
+    padding: PBound;
+    border: PBorder;
+    radius: PRadius;
+    stroke?: {
+        width?: number;
+        color?: PBorderColorParams;
+    };
+    fillColor?: string;
+    hAlign?: 'left' | 'center' | 'right';
+    vAlign?: 'top' | 'center' | 'bottom';
+};
+export type PCellParams = {
+    text: null | undefined | number | string | PTextParams | PTextParams[];
+    left?: number;
+    top?: number;
+    width?: 'auto' | number;
+    font?: Partial<PFont>;
+    fillColor?: string;
+    padding?: PBoundParams;
+    border?: PBorderParams;
+    radius?: PRadiusParams;
+    stroke?: {
+        width?: number;
+        color?: PBorderColorParams;
+    };
+    hAlign?: 'left' | 'center' | 'right';
+    vAlign?: 'top' | 'center' | 'bottom';
+    spacing?: number;
+    complete?: boolean;
+} & ({
+    height: number;
+} | {
+    autojump: true | undefined;
+});
+export type PRow = {
+    cells: Omit<PCell, 'autojump'>[];
+    gap?: number;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    padding: PBound;
+    border: PBorder;
+    radius: PRadius;
+    stroke?: {
+        width?: number;
+        color?: PBorderColorParams;
+    };
+    fillColor?: string;
+};
+export type PRowParams = {
+    cells: (Omit<PCellParams, 'width' | 'left' | 'top' | 'height' | 'autojump'> & ({
+        width: number;
+    } | {
+        weight: number;
+    }))[];
+    gap?: number;
+    left?: number;
+    top?: number;
+    padding?: PBoundParams;
+    border?: PBorderParams;
+    radius?: PRadiusParams;
+    font?: Partial<PFont>;
+    stroke?: {
+        width?: number;
+        color?: PBorderColorParams;
+    };
+    fillColor?: string;
+    width?: 'full' | 'auto' | number;
+    autojump?: boolean;
+    complete?: boolean;
+};
+export type PTableParams = {
+    rows: Omit<PRowParams, 'left' | 'top' | 'width' | 'autojump'>[];
+    gap?: number;
+    left?: number;
+    top?: number;
+    padding?: PBoundParams;
+    border?: PBorderParams;
+    radius?: PRadiusParams;
+    font?: Partial<PFont>;
+    stroke?: {
+        width?: number;
+        color?: PBorderColorParams;
+    };
+    fillColor?: string;
+    width?: 'full' | 'auto' | number;
+    autojump?: boolean;
+};
+export type PTable = {
+    rows: PRow[];
+    gap?: number;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    padding: PBound;
+    border: PBorder;
+    radius: PRadius;
+    stroke?: {
+        width?: number;
+        color?: PBorderColorParams;
+    };
+    fillColor?: string;
+};
+export declare class PPdf {
+    private cursor;
+    private configPage;
+    private engine;
+    template?: () => void;
+    private currentFont;
+    get title(): string;
+    set title(value: string);
+    get page(): {
+        readonly height: number;
+        readonly width: number;
+    };
+    private capturedFont?;
+    private captureFont;
+    private restoreFont;
+    setFont(font: Partial<PFont>): void;
+    constructor(params?: {
+        title?: string;
+        page?: Partial<PPage>;
+        template?: () => void;
+        addFirstPage?: boolean;
+    });
+    addPage(config?: Partial<PPage>): void;
+    rectangleTo(params: Omit<PRectangle, 'width' | 'height'>): void;
+    rectangle(params: PRectangle): void;
+    build(): PDFKit.PDFDocument;
+    table(params: PTableParams): void;
+    private drawTable;
+    private prepareRow;
+    private drawRow;
+    row(params: PRowParams): void;
+    setCursorLeftPosition(value: number | 'left'): this;
+    moveCursorLeft(value: number): this;
+    setCursorTopPosition(value: number | 'top'): this;
+    moveCursorTop(value: number, autoJump?: boolean): this;
+    getCursorLeftPosition(): number;
+    getCursorTopPosition(): number;
+    getBottomSpaceQuantity(): number;
+    getPageWidth(): number;
+    private verticalAlign;
+    private prepareCell;
+    private drawCell;
+    cell(params: PCellParams): void;
+    image(params: PImage): void;
+    private prepareBoundValues;
+    private prepareRadiusValues;
+    private prepareBorderValues;
+    private prepareBorderColorValues;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,811 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PPdf = void 0;
+const pdfkit_1 = __importDefault(require("pdfkit"));
+const pols_utils_1 = require("pols-utils");
+class PPdf {
+    cursor = {
+        left: 0,
+        top: 0
+    };
+    configPage;
+    engine;
+    template;
+    currentFont = {
+        name: 'Helvetica',
+        bold: false,
+        oblique: false,
+        size: 10,
+        color: '#000000'
+    };
+    get title() {
+        return this.engine.info.Title ?? '';
+    }
+    set title(value) {
+        this.engine.info.Title = value;
+    }
+    get page() {
+        return {
+            height: this.engine.page.height,
+            width: this.engine.page.width
+        };
+    }
+    capturedFont;
+    captureFont() {
+        this.capturedFont = this.currentFont;
+    }
+    restoreFont() {
+        if (this.capturedFont)
+            this.currentFont = this.capturedFont;
+    }
+    /* Establece en el engine la fuente especificada en currentFont */
+    setFont(font) {
+        const finalFont = {
+            name: font.name ?? this.currentFont.name,
+            bold: font.bold ?? this.currentFont.bold,
+            oblique: font.oblique ?? this.currentFont.oblique,
+            size: font.size ?? this.currentFont.size,
+            color: font.color ?? this.currentFont.color,
+        };
+        let fontName = this.currentFont.name;
+        if (finalFont.bold || finalFont.oblique) {
+            fontName += `-${finalFont.bold ? 'Bold' : ''}${finalFont.oblique ? 'Oblique' : ''}`;
+        }
+        this.engine.font(fontName, finalFont.size);
+        this.currentFont = finalFont;
+    }
+    constructor(params) {
+        this.engine = new pdfkit_1.default({ autoFirstPage: false });
+        this.engine.info.Title = params?.title ?? 'pdf';
+        this.setFont(this.currentFont);
+        this.template = params?.template?.bind(this);
+        this.configPage = {
+            size: 'A4',
+            layout: 'portrait',
+            ...(params?.page ?? {}),
+            margins: this.prepareBoundValues(params?.page?.margins, {
+                left: 20,
+                top: 20,
+                right: 20,
+                bottom: 20
+            })
+        };
+        if (params?.addFirstPage == null || params.addFirstPage)
+            this.addPage();
+    }
+    addPage(config) {
+        const finalConfig = {
+            ...this.configPage,
+            ...(config ?? {}),
+            margins: this.prepareBoundValues(config?.margins ?? this.configPage.margins, {
+                left: 20,
+                top: 20,
+                right: 20,
+                bottom: 20
+            })
+        };
+        this.engine.addPage(finalConfig);
+        this.configPage = finalConfig;
+        this.cursor.top = finalConfig.margins.top;
+        this.template?.();
+    }
+    rectangleTo(params) {
+        this.rectangle({
+            ...params,
+            left: this.cursor.left,
+            top: this.cursor.top,
+            width: params.left - this.cursor.left,
+            height: params.top - this.cursor.top,
+        });
+    }
+    rectangle(params) {
+        this.engine.lineWidth(params.stroke?.width ?? 0);
+        const border = this.prepareBorderValues(params.border);
+        const radius = this.prepareRadiusValues(params.radius);
+        radius.leftBottom = Math.min(radius.leftBottom, params.height / 2, params.width / 2);
+        radius.leftTop = Math.min(radius.leftTop, params.height / 2, params.width / 2);
+        radius.rightBottom = Math.min(radius.rightBottom, params.height / 2, params.width / 2);
+        radius.rightTop = Math.min(radius.rightTop, params.height / 2, params.width / 2);
+        if (params.fillColor) {
+            this.engine.path('M' + `${params.left + radius.leftTop},${params.top} `
+                + `L${params.left + params.width - radius.rightTop},${params.top} `
+                + (radius.rightTop ? `A${radius.rightTop},${radius.rightTop} 0 0 1 ${params.left + params.width},${params.top + radius.rightTop} ` : ' ')
+                + `L${params.left + params.width},${params.top + params.height - radius.rightBottom} `
+                + (radius.rightBottom ? `A${radius.rightBottom},${radius.rightBottom} 0 0 1 ${params.left + params.width - radius.rightBottom},${params.top + params.height} ` : ' ')
+                + `L${params.left + radius.leftBottom},${params.top + params.height} `
+                + (radius.leftBottom ? `A${radius.leftBottom},${radius.leftBottom} 0 0 1 ${params.left},${params.top + params.height - radius.leftBottom} ` : ' ')
+                + `L${params.left},${params.top + radius.leftTop} `
+                + (radius.leftTop ? `A${radius.leftTop},${radius.leftTop} 0 0 1 ${params.left + radius.leftTop},${params.top} ` : ' ')
+                + '').fill(params.fillColor);
+        }
+        const color = this.prepareBorderColorValues(params.stroke?.color);
+        if (border.top)
+            this.engine.path(`M${params.left + radius.leftTop},${params.top} L${params.left + params.width - radius.rightTop},${params.top}`).stroke(color.top);
+        if (border.rightTop && radius.rightTop)
+            this.engine.path(`M${params.left + params.width - radius.rightTop},${params.top} A${radius.rightTop},${radius.rightTop} 0 0 1 ${params.left + params.width},${params.top + radius.rightTop}`).stroke(color.rightTop);
+        if (border.right)
+            this.engine.path(`M${params.left + params.width},${params.top + radius.rightTop} L${params.left + params.width},${params.top + params.height - radius.rightBottom}`).stroke(color.right);
+        if (border.rightBottom && radius.rightBottom)
+            this.engine.path(`
+			M${params.left + params.width},${params.top + params.height - radius.rightBottom}
+			A${radius.rightBottom},${radius.rightBottom} 0 0 1 ${params.left + params.width - radius.rightBottom},${params.top + params.height}
+		`).stroke(color.rightBottom);
+        if (border.bottom)
+            this.engine.path(`M${params.left + params.width - radius.rightBottom},${params.top + params.height} L${params.left + radius.leftBottom},${params.top + params.height}`).stroke(color.bottom);
+        if (border.leftBottom && radius.leftBottom)
+            this.engine.path(`M${params.left + radius.leftBottom},${params.top + params.height} A${radius.leftBottom},${radius.leftBottom} 0 0 1 ${params.left},${params.top + params.height - radius.leftBottom}`).stroke(color.leftBottom);
+        if (border.left)
+            this.engine.path(`M${params.left},${params.top + params.height - radius.leftBottom} L${params.left},${params.top + radius.leftTop}`).stroke(color.left);
+        if (border.leftTop && radius.leftTop)
+            this.engine.path(`M${params.left},${params.top + radius.leftTop} A${radius.leftTop},${radius.leftTop} 0 0 1 ${params.left + radius.leftTop},${params.top}`).stroke(color.leftTop);
+        this.cursor.top = params.top + params.height;
+        this.cursor.left = params.left + params.width;
+    }
+    /* PDFDocument ya es un stream.Readable; "end" cierra la escritura y lo deja listo para ser consumido/canalizado por el llamador. */
+    build() {
+        this.engine.end();
+        return this.engine;
+    }
+    table(params) {
+        const width = (() => {
+            if (params.width == null || params.width == 'auto') {
+                return this.engine.page.width - this.engine.page.margins.right - (params.left ?? this.cursor.left);
+            }
+            else if (params.width == 'full') {
+                return this.engine.page.width - this.engine.page.margins.right - this.engine.page.margins.left;
+            }
+            else {
+                return params.width;
+            }
+        })();
+        const left = params.left ?? this.cursor.left;
+        const top = params.top ?? this.cursor.top;
+        const padding = this.prepareBoundValues(params.padding);
+        const gap = params.gap ?? 0;
+        let cursorTop = top + padding.top;
+        const usefulWidth = width - padding.left - padding.right;
+        const buffer = {
+            ...params,
+            rows: [],
+            left,
+            top,
+            padding,
+            border: this.prepareBorderValues(params.border),
+            radius: this.prepareRadiusValues(params.radius),
+            width,
+            height: 0 /* valor provisional */
+        };
+        let i = 0;
+        let rowToDraw = params.rows[i];
+        while (rowToDraw) {
+            const preparedRow = this.prepareRow({
+                ...rowToDraw,
+                left: left + padding.left,
+                top: cursorTop,
+                width: usefulWidth,
+                font: params.font,
+                autojump: (params.autojump ?? true) ? true : undefined
+            });
+            if (preparedRow.currentPage.cells.some(cell => cell.letters?.length)) {
+                buffer.rows.push(preparedRow.currentPage);
+            }
+            /* Si la fila actual se rompe, dibuja el buffer de la tabla */
+            if (preparedRow.nextPage.cells.some(cell => cell.text)) {
+                const lastRow = buffer.rows[buffer.rows.length - 1];
+                buffer.height = lastRow ? ((lastRow?.top ?? 0) + (lastRow?.height ?? 0) - buffer.top + padding.bottom) : 0;
+                this.drawTable(buffer);
+                this.addPage();
+                rowToDraw = preparedRow.nextPage;
+                buffer.rows = [];
+                buffer.top = this.cursor.top;
+                cursorTop = this.cursor.top + padding.top;
+            }
+            else {
+                i++;
+                rowToDraw = params.rows[i];
+                cursorTop += preparedRow.currentPage.height + gap;
+            }
+        }
+        if (buffer.rows.length) {
+            const lastRow = buffer.rows[buffer.rows.length - 1];
+            buffer.height = lastRow.top + lastRow.height - buffer.top + padding.bottom;
+            this.drawTable(buffer);
+        }
+        this.cursor.left = left;
+    }
+    drawTable(params) {
+        /* Dibuja el borde. Este bloque podría ignorarse si al final no se escribirá ningún caracter debido al salto de página */
+        if (params.border || params.fillColor) {
+            this.rectangle({
+                left: params.left,
+                top: params.top,
+                width: params.width,
+                height: params.height,
+                border: params.border,
+                radius: params.radius,
+                fillColor: params.fillColor,
+                stroke: params.stroke
+            });
+        }
+        /* Dibujo de las celdas */
+        for (const row of params.rows) {
+            this.drawRow(row);
+        }
+        this.setCursorTopPosition(params.top + params.height);
+    }
+    prepareRow(params) {
+        const width = (() => {
+            if (params.width == null || params.width == 'auto') {
+                return this.engine.page.width - this.engine.page.margins.right - (params.left ?? this.cursor.left);
+            }
+            else if (params.width == 'full') {
+                return this.engine.page.width - this.engine.page.margins.right - this.engine.page.margins.left;
+            }
+            else {
+                return params.width;
+            }
+        })();
+        const left = params.left ?? this.cursor.left;
+        const top = params.top ?? this.cursor.top;
+        const padding = this.prepareBoundValues(params.padding);
+        const response = {
+            currentPage: {
+                ...params,
+                cells: [],
+                left,
+                top,
+                padding,
+                border: this.prepareBorderValues(params.border),
+                radius: this.prepareRadiusValues(params.radius),
+                width,
+                height: 0 /* valor provisional */
+            },
+            nextPage: {
+                ...params,
+                cells: []
+            }
+        };
+        const gap = params.gap ?? 0;
+        let cursorLeft = left + padding.left;
+        const usedWidth = params.cells.reduce((ac, cell) => ac + (('width' in cell && cell.width != null) ? cell.width : 0), 0);
+        const usefulWidth = width - padding.left - padding.right - gap * (params.cells.length - 1) - usedWidth;
+        const totalWeight = params.cells.reduce((ac, cell) => ac + (('weight' in cell && cell.weight != null) ? cell.weight : 0), 0);
+        for (const cell of params.cells) {
+            let cellWidth = 0;
+            if ('width' in cell && cell.width != null) {
+                cellWidth = cell.width;
+            }
+            else if ('weight' in cell && cell.weight != null) {
+                cellWidth = usefulWidth * cell.weight / totalWeight;
+            }
+            const preparedCell = this.prepareCell({
+                ...cell,
+                left: cursorLeft,
+                top: top + padding.top,
+                width: cellWidth,
+                font: cell.font ?? params.font,
+                autojump: (params.autojump ?? true) ? true : undefined,
+                complete: params.complete
+            });
+            response.currentPage.cells.push(preparedCell.currentPage);
+            response.nextPage.cells.push({
+                ...cell,
+                text: undefined,
+                ...preparedCell.nextPage,
+                ...('width' in cell ? { width: cell.width } : { weight: cell.weight })
+            });
+            cursorLeft += preparedCell.currentPage.width + gap;
+        }
+        /* Efectúa la alineación vertical en cada celda */
+        const height = Math.max(...response.currentPage.cells.map(cell => cell.height));
+        for (const [i, cell] of response.currentPage.cells.entries()) {
+            if (params.cells[i].vAlign != null)
+                this.verticalAlign(cell.letters, params.cells[i].vAlign, height, cell.padding);
+            cell.height = height;
+        }
+        response.currentPage.height = height + padding.top + padding.bottom;
+        return response;
+    }
+    drawRow(params) {
+        /* Dibuja el borde. Este bloque podría ignorarse si al final no se escribirá ningún caracter debido al salto de página */
+        if (params.border || params.fillColor) {
+            this.rectangle({
+                left: params.left,
+                top: params.top,
+                width: params.width,
+                height: params.height,
+                border: params.border,
+                radius: params.radius,
+                fillColor: params.fillColor,
+                stroke: params.stroke
+            });
+        }
+        /* Dibujo de las celdas */
+        for (const cell of params.cells) {
+            this.drawCell(cell);
+        }
+        this.setCursorTopPosition(params.top + params.height);
+    }
+    row(params) {
+        let paramsToDraw = params;
+        while (paramsToDraw) {
+            const prepared = this.prepareRow(paramsToDraw);
+            this.drawRow(prepared.currentPage);
+            if (prepared.nextPage.cells.some(cell => cell.text)) {
+                this.addPage();
+                paramsToDraw = {
+                    ...prepared.nextPage,
+                    top: this.cursor.top
+                };
+            }
+            else {
+                paramsToDraw = null;
+            }
+        }
+    }
+    setCursorLeftPosition(value) {
+        let n;
+        if (value == 'left') {
+            n = this.engine.page.margins.left;
+        }
+        else {
+            n = value;
+        }
+        this.cursor.left = n;
+        return this;
+    }
+    moveCursorLeft(value) {
+        this.cursor.left += value;
+        return this;
+    }
+    setCursorTopPosition(value) {
+        let n;
+        if (value == 'top') {
+            n = this.engine.page.margins.top;
+        }
+        else {
+            n = value;
+        }
+        this.cursor.top = n;
+        return this;
+    }
+    moveCursorTop(value, autoJump = true) {
+        this.cursor.top += value;
+        if (autoJump) {
+            if (this.cursor.top >= this.engine.page.height - this.configPage.margins.bottom)
+                this.addPage();
+        }
+        return this;
+    }
+    getCursorLeftPosition() {
+        return this.cursor.left;
+    }
+    getCursorTopPosition() {
+        return this.cursor.top;
+    }
+    getBottomSpaceQuantity() {
+        return this.page.height - this.cursor.top;
+    }
+    getPageWidth() {
+        return this.engine.page.width;
+    }
+    verticalAlign(letters, vAlign, height, padding) {
+        if (vAlign != 'top') {
+            const charTop = Math.min(...letters.map(letter => letter.top));
+            const textHeight = Math.max(...letters.map(letter => letter.top + letter.height)) - charTop;
+            const delta = height - padding.top - padding.bottom - textHeight;
+            /* Observa la distancia entre el último caracter y el ancho */
+            for (const letter of letters) {
+                letter.top += vAlign == 'bottom' ? delta : (delta / 2);
+            }
+        }
+    }
+    prepareCell(params) {
+        const text = [];
+        if (typeof params.text == 'string') {
+            text.push({ chars: params.text });
+        }
+        else if (typeof params.text == 'number') {
+            text.push({ chars: params.text.toString() });
+        }
+        else if (params.text == null) {
+            text.push({ chars: '' });
+        }
+        else if (params.text instanceof Array) {
+            if (params.text.length) {
+                text.push(...params.text);
+            }
+            else {
+                text.push({ chars: '' });
+            }
+        }
+        const letters = [];
+        const spacesIndexes = [];
+        const width = params.width == 'auto' ? this.engine.page.width - this.engine.page.margins.right - (params.left ?? this.cursor.left) : params.width;
+        /* Captura las coordenadas de inicio de celda */
+        const left = params.left ?? this.cursor.left;
+        const top = params.top ?? this.cursor.top;
+        /* Calcula el padding */
+        const padding = this.prepareBoundValues(params.padding, {
+            left: 0,
+            top: 0,
+            right: 0,
+            bottom: 0
+        });
+        /* Separa cada caracter por un objeto independiente identificando sus dimensiones, posición, fuente y color */
+        let charLeftPosition = left + padding.left;
+        const charTopStartPosition = top + padding.top;
+        for (const t of text) {
+            /* Almacena el estado anterior de la fuente para restablcerla. */
+            this.captureFont();
+            const font = {
+                name: t.font?.name ?? params.font?.name ?? this.currentFont.name,
+                bold: t.font?.bold ?? params.font?.bold ?? this.currentFont.bold,
+                oblique: t.font?.oblique ?? params.font?.oblique ?? this.currentFont.oblique,
+                size: t.font?.size ?? params.font?.size ?? this.currentFont.size,
+                color: t.font?.color ?? params.font?.color ?? this.currentFont.color,
+            };
+            this.setFont(font);
+            if (t.chars == null)
+                t.chars = '';
+            /* Sustituye los tabs por espacios regulares. */
+            t.chars = t.chars.replace(/\t/g, ' ');
+            for (let i = 0; i < t.chars.length; i++) {
+                const char = t.chars[i];
+                const charWidth = pols_utils_1.PUtilsNumber.round(this.engine.widthOfString(char), 6);
+                const charHeight = pols_utils_1.PUtilsNumber.round(this.engine.heightOfString(char), 6);
+                letters.push({
+                    left: charLeftPosition,
+                    top: charTopStartPosition,
+                    char,
+                    width: charWidth,
+                    height: charHeight,
+                    font,
+                });
+                charLeftPosition += charWidth;
+                if (char === ' ')
+                    spacesIndexes.push(letters.length - 1);
+            }
+            this.restoreFont();
+        }
+        /* Si se ha definido el ancho de un párrafo, se determina dónde se puede hacer salto de línea */
+        /* Reinicia el inicio del primer caracter */
+        charLeftPosition = left + padding.left;
+        let lastSpaceIndex = null;
+        let lastSpaceSet = null;
+        let i = 0;
+        while (i < letters.length) {
+            const letter = letters[i];
+            letter.left = charLeftPosition;
+            if (letter.char != ' ' && width != null && (letter.left + letter.width > width + left - padding.right)) {
+                /* Si la posición excede el ancho de la celda, se busca el último espacio insertado, si no se ha insertado ningún espacio, el script continua */
+                if (lastSpaceIndex == null && i > 0)
+                    lastSpaceIndex = i - 1;
+                if (lastSpaceIndex != null) {
+                    if (lastSpaceIndex !== lastSpaceSet) {
+                        i = lastSpaceIndex;
+                        lastSpaceSet = lastSpaceIndex;
+                    }
+                }
+                else {
+                    letter.left = left + padding.left;
+                }
+                charLeftPosition = left + padding.left;
+            }
+            else if (letter.char == '\n') {
+                charLeftPosition = left + padding.left;
+            }
+            else {
+                charLeftPosition += letter.width;
+            }
+            if ([' ', '-'].includes(letter.char))
+                lastSpaceIndex = i;
+            i++;
+        }
+        /* Inserta cada caracter en un arreglo diferente según la línea que ocupa */
+        const lines = [[]];
+        let currentLine = 0;
+        for (const [i, letter] of letters.entries()) {
+            if (i > 0 && letter.left == left + padding.left) {
+                /* Si la letra tiene como posición  */
+                lines.push([]);
+                currentLine++;
+            }
+            lines[currentLine].push(letter);
+        }
+        /* Define la posición vertical de cada letra en su respectiva línea */
+        let charTopPosition = charTopStartPosition;
+        let isFirstLine = true;
+        for (const line of lines) {
+            const maxHeight = Math.max(...line.map(letter => letter.height));
+            for (const letter of line) {
+                letter.top = charTopPosition - 0.4 + (!isFirstLine ? (params.spacing ?? 0) : 0);
+                /* Corrige la alineación vertical de las letras */
+                if (letter.height < maxHeight)
+                    letter.top += maxHeight - letter.height;
+            }
+            charTopPosition = Math.max(...line.map(letter => letter.height + letter.top));
+            isFirstLine = false;
+        }
+        /* Elimina los espacios finales de cada línea */
+        for (const line of lines) {
+            if (line[line.length - 1]?.char == ' ')
+                line.splice(line.length - 1, 1);
+        }
+        const paragraphs = {
+            currentPage: [],
+            nextPage: []
+        };
+        let currentParagraph = 'currentPage';
+        /* Identifica qué líneas se desbordan de la página y las marca con "nextPage" a true */
+        for (const line of lines) {
+            const firstLetterOfLine = line[0];
+            if (!firstLetterOfLine)
+                continue;
+            /* Si la letra se desborda, se crea un nuevo párrafo */
+            if ('autojump' in params && currentParagraph != 'nextPage' && firstLetterOfLine.top + firstLetterOfLine.height + padding.bottom > (this.engine.page.height - this.engine.page.margins.bottom)) {
+                if (params.complete) {
+                    paragraphs.nextPage = paragraphs.currentPage;
+                    paragraphs.currentPage = [];
+                }
+                currentParagraph = 'nextPage';
+            }
+            paragraphs[currentParagraph].push(line);
+        }
+        /* Realiza la alineación horizontal */
+        if (width != null && (params.hAlign ?? 'left') != 'left') {
+            /* Observa la distancia entre el último caracter y el ancho */
+            for (const line of lines) {
+                if (!line.length)
+                    continue;
+                const letter = line[line.length - 1];
+                const delta = left + width - padding.right - (letter.left + letter.width);
+                for (const letter of line) {
+                    letter.left += params.hAlign === 'right' ? delta : (delta / 2);
+                }
+            }
+        }
+        /* Realiza la alineación vertical sólo para el primer párrafo */
+        if ('height' in params && (params.vAlign ?? 'top') != 'top') {
+            this.verticalAlign(paragraphs.currentPage.flat(), params.vAlign ?? 'top', params.height, padding);
+        }
+        const letterForCurrentPage = paragraphs.currentPage.flat();
+        const lastLetterForCurrentPage = letterForCurrentPage[letterForCurrentPage.length - 1];
+        const finalWidth = width ?? (Math.max(...lines.map(line => line.reduce((ac, letter) => ac + letter.width, 0))) + padding.left + padding.right);
+        return {
+            currentPage: {
+                letters: letterForCurrentPage,
+                left,
+                top,
+                width: finalWidth,
+                height: 'height' in params ? params.height : (lastLetterForCurrentPage == null ? top : (lastLetterForCurrentPage.top + lastLetterForCurrentPage.height)) - top + padding.bottom,
+                padding,
+                border: this.prepareBorderValues(params.border),
+                radius: this.prepareRadiusValues(params.radius),
+                stroke: params.stroke,
+                fillColor: params.fillColor
+            },
+            nextPage: paragraphs.nextPage.length ? {
+                ...params,
+                text: (() => {
+                    const letters = [];
+                    for (const [i, line] of paragraphs.nextPage.entries()) {
+                        letters.push(...line.map(letter => ({
+                            chars: letter.char,
+                            font: letter.font
+                        })));
+                        if (i < paragraphs.nextPage.length - 1 && letters[letters.length - 1].chars != '\n') {
+                            letters.push({
+                                chars: '\n',
+                                font: letters[letters.length - 1].font
+                            });
+                        }
+                    }
+                    return letters;
+                })(),
+                width: finalWidth
+            } : undefined
+        };
+    }
+    drawCell(params) {
+        /* Dibuja el borde. Este bloque podría ignorarse si al final no se escribirá ningún caracter debido al salto de página */
+        if (params.border || params.fillColor) {
+            this.rectangle({
+                left: params.left,
+                top: params.top,
+                width: params.width,
+                height: params.height,
+                border: params.border,
+                radius: params.radius,
+                fillColor: params.fillColor,
+                stroke: params.stroke
+            });
+        }
+        /* Dibujo de las letras */
+        let moveCursorTop = 0;
+        for (const letter of params.letters) {
+            /* Almacena el estado anterior de la fuente para restablcerla. */
+            this.captureFont();
+            this.setFont(letter.font);
+            let deltaFix = 0;
+            if ((letter.font.name ?? this.currentFont.name) == 'Helvetica') {
+                deltaFix = (letter.font.size ?? this.currentFont.size) * 0.2;
+            }
+            this.engine.fillColor(letter.font.color ?? this.currentFont.color).text(letter.char, letter.left, letter.top + deltaFix + (letter.font.name == 'Symbol' ? (letter.height * 0.6) : 0), { lineBreak: false });
+            moveCursorTop = Math.max(moveCursorTop, letter.top + letter.height);
+            this.restoreFont();
+        }
+        this.setCursorTopPosition(params.top + params.height);
+    }
+    cell(params) {
+        let paramsToDraw = params;
+        while (paramsToDraw) {
+            const prepared = this.prepareCell(paramsToDraw);
+            this.drawCell(prepared.currentPage);
+            if (prepared.nextPage) {
+                this.addPage();
+                paramsToDraw = {
+                    ...prepared.nextPage,
+                    top: this.cursor.top
+                };
+            }
+            else {
+                paramsToDraw = null;
+            }
+        }
+    }
+    image(params) {
+        const options = {};
+        if ('fill' in params) {
+            if (params.fill == 'proportional') {
+                options.fit = [params.width, params.height];
+            }
+            else if (params.fill == 'cover') {
+                options.cover = [params.width, params.height];
+            }
+            if ('vAlign' in params)
+                options.valign = params.vAlign == 'top' ? undefined : params.vAlign;
+            if ('hAlign' in params)
+                options.align = params.hAlign == 'left' ? undefined : params.hAlign;
+        }
+        else {
+            if ('width' in params)
+                options.width = params.width;
+            if ('height' in params)
+                options.height = params.height;
+        }
+        this.engine.image(params.filePath, params.left, params.top, options);
+        this.cursor.left = this.engine.x;
+        this.cursor.top = this.engine.y;
+    }
+    prepareBoundValues(value, defa = {
+        left: 0,
+        top: 0,
+        bottom: 0,
+        right: 0
+    }) {
+        if (value != null) {
+            if (typeof value == 'number') {
+                return {
+                    left: value,
+                    right: value,
+                    top: value,
+                    bottom: value,
+                };
+            }
+            else {
+                return {
+                    top: value.top ?? defa?.top ?? 0,
+                    right: value.right ?? defa?.right ?? 0,
+                    bottom: value.bottom ?? defa?.bottom ?? 0,
+                    left: value.left ?? defa?.left ?? 0,
+                };
+            }
+        }
+        else {
+            return defa;
+        }
+    }
+    prepareRadiusValues(value, defa = {
+        leftTop: 0,
+        leftBottom: 0,
+        rightTop: 0,
+        rightBottom: 0,
+    }) {
+        if (value != null) {
+            if (typeof value == 'number') {
+                return {
+                    leftTop: value,
+                    rightTop: value,
+                    leftBottom: value,
+                    rightBottom: value,
+                };
+            }
+            else {
+                return {
+                    leftTop: value.leftTop ?? defa?.leftTop ?? 0,
+                    rightTop: value.rightTop ?? defa?.rightTop ?? 0,
+                    leftBottom: value.leftBottom ?? defa?.leftBottom ?? 0,
+                    rightBottom: value.rightBottom ?? defa?.rightBottom ?? 0,
+                };
+            }
+        }
+        else {
+            return defa;
+        }
+    }
+    prepareBorderValues(value, defa = {
+        left: false,
+        right: false,
+        bottom: false,
+        top: false,
+        leftBottom: false,
+        leftTop: false,
+        rightBottom: false,
+        rightTop: false
+    }) {
+        if (value != null) {
+            if (typeof value == 'boolean') {
+                return {
+                    leftTop: value,
+                    top: value,
+                    rightTop: value,
+                    right: value,
+                    rightBottom: value,
+                    bottom: value,
+                    leftBottom: value,
+                    left: value,
+                };
+            }
+            else {
+                return {
+                    leftTop: value.leftTop ?? defa?.leftTop ?? false,
+                    top: value.top ?? defa?.top ?? false,
+                    rightTop: value.rightTop ?? defa?.rightTop ?? false,
+                    right: value.right ?? defa?.right ?? false,
+                    rightBottom: value.rightBottom ?? defa?.rightBottom ?? false,
+                    bottom: value.bottom ?? defa?.bottom ?? false,
+                    leftBottom: value.leftBottom ?? defa?.leftBottom ?? false,
+                    left: value.left ?? defa?.left ?? false,
+                };
+            }
+        }
+        else {
+            return defa;
+        }
+    }
+    prepareBorderColorValues(value, defa = {
+        top: 'black',
+        rightTop: 'black',
+        right: 'black',
+        rightBottom: 'black',
+        bottom: 'black',
+        leftBottom: 'black',
+        left: 'black',
+        leftTop: 'black',
+    }) {
+        return typeof value == 'string' ? {
+            top: value,
+            rightTop: value,
+            right: value,
+            rightBottom: value,
+            bottom: value,
+            leftBottom: value,
+            left: value,
+            leftTop: value,
+        } : {
+            top: value?.top ?? defa.top,
+            rightTop: value?.rightTop ?? defa.rightTop,
+            right: value?.right ?? defa.right,
+            rightBottom: value?.rightBottom ?? defa.rightBottom,
+            bottom: value?.bottom ?? defa.bottom,
+            leftBottom: value?.leftBottom ?? defa.leftBottom,
+            left: value?.left ?? defa.left,
+            leftTop: value?.leftTop ?? defa.leftTop,
+        };
+    }
+}
+exports.PPdf = PPdf;

package/eslint.config.mjs

@@ -0,0 +1,19 @@
+import globals from "globals";
+import pluginJs from "@eslint/js";
+import tseslint from "typescript-eslint";
+
+export default [
+	{
+		files: ["**/*.{ts}"],
+	},
+	{ languageOptions: { globals: globals.node } },
+	pluginJs.configs.recommended,
+	...tseslint.configs.recommended,
+	{
+		rules: {
+			"@typescript-eslint/no-unused-vars": "warn",
+			"@typescript-eslint/no-explicit-any": "off",
+			"no-use-before-define": "off"
+		}
+	}
+];

package/package.json

@@ -0,0 +1,30 @@
+{
+	"name": "pols-pdf",
+	"version": "1.0.0",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"scripts": {
+		"build": "npx tsc",
+		"lint": "eslint src/index.ts",
+		"test": "npx ts-node-dev -r tsconfig-paths/register --project tsconfig.json",
+		"export": "npm run build && npm publish"
+	},
+	"author": "Jean Paul Sánchez mendoza",
+	"license": "ISC",
+	"description": "",
+	"devDependencies": {
+		"@eslint/js": "^9.13.0",
+		"@types/node": "^22.7.9",
+		"@types/pdfkit": "^0.17.6",
+		"eslint": "^9.13.0",
+		"globals": "^15.11.0",
+		"ts-node-dev": "^2.0.0",
+		"tsconfig-paths": "^4.2.0",
+		"typescript": "^5.6.3",
+		"typescript-eslint": "^8.11.0"
+	},
+	"dependencies": {
+		"pdfkit": "^0.19.1",
+		"pols-utils": "^6.0.1"
+	}
+}