pdfme Files

This release adds image columns to tables. You can switch any table column to Image in the Designer, upload PNG or JPEG images per cell in the Designer and Form, and render them in generated PDFs. Tables also get per-column vertical alignment, and column styles now stay with the right column when a column is removed.

Features

• Image columns in tables: A table column can now hold images instead of text. It is opt-in per column with columnStyles.cellType ('text' | 'image', default 'text'). Each image cell's value is a PNG or JPEG data URL, so inputs stay string[][]. Other values (URLs, GIF, WebP, SVG, broken data) are not drawn and log one warning; empty cells are left blank. Row height follows columnStyles.imageHeightMode: fixed uses columnStyles.imageHeight in mm (default 20mm), and auto follows the image's aspect ratio at the column width, capped to fit the page on a blank basePdf. Images are drawn with contain fit and positioned by the column's horizontal and vertical alignment. Header cells stay text, image cells do not change column widths, and the image plugin does not have to be registered. (#484, [#1660])
• Column Style card in the Designer: The table's Column Style card is now one merged card with a block per column. For each column you can set the type (Text or Image), horizontal and vertical alignment, and, for image columns, the height mode (fixed mm or auto). With 7 or more columns, each column starts collapsed to a one-line summary. Switching a column between Text and Image clears that column's body cells. (#1663)
• Image cells in the Designer and Form: While an image cell is being edited, you can select a PNG or JPEG file or remove the image. Empty cells show a placeholder, and clicking an empty image cell in the Form or Designer opens the file picker. If the browser blocks the picker, use the Select image button. (#1663)
• Per-column vertical alignment: New columnStyles.verticalAlignment map, with the same shape as alignment. It overrides Head Style and Body Style for that column, including the header cell, and also sets the vertical position of images. Columns without a value render exactly as before. (#1663)

Fixes

• Column styles after removing a column: Deleting a table column in the Designer now shifts every columnStyles map (alignment, fontName, the new image keys, and others) so each style stays on its column. Before, a style set on a later column ended up on the wrong column. (#1658)

Upgrade notes

• Existing templates: Templates without cellType or verticalAlignment keep the same row heights and PDF output. One page-break edge case changed: when a table with repeatHead is the only field on its page and only its header fits there, the table now moves to the top of that page together with its first row, instead of leaving a header-only page. (#1660)

Maintenance

• Dropped the deprecated @types/bwip-js (bwip-js ships its own types), upgraded Vitest to 5 and Vite+ to 1.0, and improved Sentry setup for the playground build. No runtime changes to the published packages. (#1657, [#1659], [#1661], [#1662])