pols-pdf 1.1.2 → 1.1.4

package/README.md

@@ -110,7 +110,7 @@ pdf.rectangle({
 pdf.cell({
 	text: 'Texto de la celda',
 	width: 200,
-	height: 40,                 // o autojump: true si no se conoce el alto de antemano
+	height: 40,                 // opcional: si se omite, el alto se calcula según el contenido
 	padding: 6,
 	hAlign: 'center',
 	vAlign: 'center',
@@ -122,11 +122,12 @@ pdf.cell({
 
 - `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.
+- Una celda admite `height` (alto fijo) **o** `autojump` (opcional, `boolean`, por defecto `true`):
+  con `autojump` 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. Pasar `autojump: false` desactiva
+  ese salto automático (el contenido que no entre se recorta al borde de la página).
+- Si el contenido no entra en la página (con `autojump` activo, que es el default), `cell()`
+  agrega una página nueva y continúa dibujando el resto automáticamente.
 
 ---
 
@@ -193,6 +194,25 @@ Cambia la fuente activa del documento; los métodos de texto (`cell`, `row`, `ta
 aceptan `font` por llamada (y por fragmento de texto individual dentro de `text`), sin necesidad
 de llamar a `setFont` explícitamente.
 
+`font` se hereda en cascada — tabla → fila → celda → fragmento de texto — y cada nivel solo
+sobrescribe las propiedades que declara explícitamente, heredando el resto del nivel anterior. Por
+ejemplo, en:
+
+```typescript
+pdf.table({
+	font: { size: '80%' },
+	rows: [{
+		cells: [
+			{ text: 'Solped:', font: { bold: true }, weight: 1 },
+			{ text: '12345', weight: 3 },
+		]
+	}]
+})
+```
+
+la celda `'Solped:'` se dibuja en **negrita y al 80% del tamaño de fuente activo**: `bold: true`
+la define la celda, pero `size: '80%'` lo hereda de la tabla porque la celda no lo redefine.
+
 ---
 
 ## Tipos con forma abreviada (`*Params`)
@@ -211,6 +231,8 @@ completo:
 
 ## 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`).
+Todas las clases y tipos exportados llevan el prefijo `P` (`PPdf`, `PCellParams`, `PRowParams`,
+etc.), siguiendo la convención usada en los paquetes hermanos de este ecosistema: `pols-date`
+(`PDate`) y `pols-utils` (`PRecord`, `PUtilsNumber`). Los tipos ya resueltos que usa el motor de
+layout internamente (`PCellCompiled`, `PRowCompiled`, `PTableCompiled`, etc.) llevan el sufijo
+`Compiled` y no se exportan — no forman parte de la API pública.

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import pdfkit from 'pdfkit';
 export type PBoundParams = number | {
     top?: number;
     bottom?: number;
@@ -154,7 +155,7 @@ export declare class PPdf {
     private static readonly lineHeightCache;
     private cursor;
     private configPage;
-    private engine;
+    engine: typeof pdfkit;
     template?: () => void;
     private currentFont;
     get title(): string;

package/dist/index.js

@@ -6,6 +6,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PPdf = void 0;
 const pdfkit_1 = __importDefault(require("pdfkit"));
 const pols_utils_1 = require("pols-utils");
+const calculateWidth = ({ width, left, pdf }) => {
+    if (width == null || width == 'auto') {
+        return pdf.engine.page.width - pdf.engine.page.margins.right - (left ?? pdf.getCursorLeftPosition());
+    }
+    else if (width == 'full') {
+        return pdf.engine.page.width - pdf.engine.page.margins.right - pdf.engine.page.margins.left;
+    }
+    else {
+        return width;
+    }
+};
 class PPdf {
     /* Cachés de métricas de fuente, compartidas por todas las instancias: widthOfString/heightOfString
     de pdfkit son funciones puras de (fuente, carácter) — el mismo par siempre da el mismo resultado —,
@@ -168,17 +179,11 @@ class PPdf {
         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 width = calculateWidth({
+            width: params.width,
+            left: params.left,
+            pdf: this,
+        });
         const left = params.left ?? this.cursor.left;
         const top = params.top ?? this.cursor.top;
         const padding = this.prepareBoundValues(params.padding);
@@ -673,7 +678,17 @@ class PPdf {
         this.setCursorTopPosition(params.top + params.height);
     }
     cell(params) {
-        let paramsToDraw = params;
+        const width = calculateWidth({
+            width: params.width,
+            left: params.left,
+            pdf: this
+        });
+        const left = params.left ?? this.cursor.left;
+        let paramsToDraw = {
+            ...params,
+            width,
+            left
+        };
         while (paramsToDraw) {
             const prepared = this.prepareCell(paramsToDraw);
             this.drawCell(prepared.currentPage);
@@ -688,6 +703,7 @@ class PPdf {
                 paramsToDraw = null;
             }
         }
+        this.setCursorLeftPosition(left);
     }
     image(params) {
         const options = {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pols-pdf",
-	"version": "1.1.2",
+	"version": "1.1.4",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"scripts": {