@lpdfio/lpdf 0.28.0 → 0.29.0

package/README.md

@@ -41,6 +41,12 @@ const doc = L.document({ size: 'letter' }, [
 engine.render(doc).then((pdf) => require('node:fs').writeFileSync('proposal.pdf', pdf))
 ```
 
+An ES module or a TypeScript file imports the same names, and gets the same classes:
+
+```js
+import { L, NoAttr } from '@lpdfio/lpdf'
+```
+
 ## Requirements
 
 - Node.js 20+

package/dist/L.d.ts

@@ -43,10 +43,12 @@ export declare const L: Readonly<{
     thead: (attrs: import("./attrs").TheadAttr | null, nodes?: import("./layout").LpdfTdNode[]) => import("./layout").LpdfTheadNode;
     tr: (attrs: import("./attrs").TrAttr | null, nodes?: import("./layout").LpdfTdNode[]) => import("./layout").LpdfTrNode;
     td: (attrs: import("./attrs").TdAttr | null, nodes?: import("./layout").LpdfNode[]) => import("./layout").LpdfTdNode;
-    text: (attrs: import("./attrs").TextAttr | null, nodes?: (string | import("./layout").LpdfSpanNode)[]) => import("./layout").LpdfTextNode;
+    text: (attrs: import("./attrs").TextAttr | null, nodes?: (string | import("./layout").LpdfSpanNode | import("./layout").LpdfFnNode)[]) => import("./layout").LpdfTextNode;
     span: (attrs: import("./attrs").SpanAttr | null, nodes?: string[]) => import("./layout").LpdfSpanNode;
+    fn: (attrs: null, nodes?: (string | import("./layout").LpdfSpanNode)[]) => import("./layout").LpdfFnNode;
     divider: (attrs?: import("./attrs").DividerAttr | null) => import("./layout").LpdfDividerNode;
     img: (attrs: import("./attrs").ImgAttr) => import("./layout").LpdfImgNode;
+    shape: (attrs: import("./attrs").ShapeAttr) => import("./layout").LpdfShapeNode;
     barcode: (attrs: import("./attrs").BarcodeAttr) => import("./layout").LpdfBarcodeNode;
     region: (attrs: import("./attrs").RegionAttr, nodes?: import("./layout").LpdfNode[]) => import("./layout").LpdfRegionNode;
     field: (attrs: import("./attrs").FieldAttr) => import("./layout").LpdfFieldNode;

package/dist/L.js

@@ -53,8 +53,10 @@ exports.L = Object.freeze({
     td: layout_1.LpdfLayout.td,
     text: layout_1.LpdfLayout.text,
     span: layout_1.LpdfLayout.span,
+    fn: layout_1.LpdfLayout.fn,
     divider: layout_1.LpdfLayout.divider,
     img: layout_1.LpdfLayout.img,
+    shape: layout_1.LpdfLayout.shape,
     barcode: layout_1.LpdfLayout.barcode,
     region: layout_1.LpdfLayout.region,
     field: layout_1.LpdfLayout.field,

package/dist/attrs.d.ts

@@ -19,9 +19,10 @@ export interface ColumnAttr {
      */
     padding?: string;
     /**
-     * Height of the box. Leave it out to size to the content. A length fixes it; fill takes what is
-     * left after its siblings (shared equally if several use fill); full takes all the height
-     * available. Any of these stops the box splitting across pages.
+     * Height of the box. Leave it out to size to the content. A length, or a name from the height row
+     * of the tokens, fixes it; fill takes what is left after its siblings (shared equally if several
+     * use fill); full takes all the height available. Any of these stops the box splitting across
+     * pages.
      */
     height?: string;
     background?: string;
@@ -84,9 +85,10 @@ export interface RowAttr {
      */
     padding?: string;
     /**
-     * Height of the box. Leave it out to size to the content. A length fixes it; fill takes what is
-     * left after its siblings (shared equally if several use fill); full takes all the height
-     * available. Any of these stops the box splitting across pages.
+     * Height of the box. Leave it out to size to the content. A length, or a name from the height row
+     * of the tokens, fixes it; fill takes what is left after its siblings (shared equally if several
+     * use fill); full takes all the height available. Any of these stops the box splitting across
+     * pages.
      */
     height?: string;
     background?: string;
@@ -147,9 +149,10 @@ export interface GridAttr {
      */
     padding?: string;
     /**
-     * Height of the box. Leave it out to size to the content. A length fixes it; fill takes what is
-     * left after its siblings (shared equally if several use fill); full takes all the height
-     * available. Any of these stops the box splitting across pages.
+     * Height of the box. Leave it out to size to the content. A length, or a name from the height row
+     * of the tokens, fixes it; fill takes what is left after its siblings (shared equally if several
+     * use fill); full takes all the height available. Any of these stops the box splitting across
+     * pages.
      */
     height?: string;
     background?: string;
@@ -209,9 +212,10 @@ export interface FrameAttr {
      */
     padding?: string;
     /**
-     * Height of the box. Leave it out to size to the content. A length fixes it; fill takes what is
-     * left after its siblings (shared equally if several use fill); full takes all the height
-     * available. Any of these stops the box splitting across pages.
+     * Height of the box. Leave it out to size to the content. A length, or a name from the height row
+     * of the tokens, fixes it; fill takes what is left after its siblings (shared equally if several
+     * use fill); full takes all the height available. Any of these stops the box splitting across
+     * pages.
      */
     height?: string;
     background?: string;
@@ -324,6 +328,38 @@ export interface ImgAttr {
     paginate?: string;
     debug?: string;
 }
+/**
+ * A rectangle, a circle or an ellipse in the layout, for a status dot, a color swatch or a progress
+ * bar. It takes its box in the flow as an image does, with no children, and is drawn centered in
+ * that box, which the parent's align places. A rect and an ellipse need a width and a height, and a
+ * circle an r. A shape with no fill and no stroke draws nothing, but keeps its box. A stroke is
+ * centered on the edge of the box, so half of it lies outside. To put a shape at a place on the
+ * page, use a rect, circle or ellipse in a layer.
+ */
+export interface ShapeAttr {
+    type: string;
+    /**
+     * Width of a rect or an ellipse, a length or a name from the width row of the tokens. A circle
+     * takes r instead.
+     */
+    width?: string;
+    /**
+     * Height of a rect or an ellipse, a length or a name from the height row of the tokens. A circle
+     * takes r instead.
+     */
+    height?: string;
+    /** Radius of a circle. Its box is the square of side 2r. */
+    r?: string;
+    /** Rounding of the corners of a rect. A circle and an ellipse are round already. */
+    radius?: string;
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: string;
+    strokeDash?: string;
+    /** How opaque the shape is, from 0 to 1. Default 1. */
+    opacity?: string;
+    debug?: string;
+}
 /**
  * A QR code, a Code 128 or an EAN-13. It is never stretched. With only a width or a height, the
  * other follows the barcode's proportions. With both, they are a maximum: the barcode takes the
@@ -334,13 +370,14 @@ export interface BarcodeAttr {
     type: string;
     data: string;
     /**
-     * Height of the whole barcode, with the digits of hrt inside it: they take the bottom 12pt and
-     * the bars the rest. A barcode is never stretched. With only a height, the width follows the
-     * barcode's proportions. With both width and height, they are a maximum: the barcode takes the
-     * largest size that fits in them, and its box becomes that size. A QR code is square, so it takes
-     * the smaller of the two. Without a size, a code128 is as wide as its bars at 1pt per module and
-     * its bars are 40pt high, and an ean13 is the standard symbol, 0.33mm per module and bars 22.85mm
-     * high. The digits of hrt add 12pt to either.
+     * Height of the whole barcode, a length or a name from the height row of the tokens, with the
+     * digits of hrt inside it: they take the bottom 12pt and the bars the rest. A barcode is never
+     * stretched. With only a height, the width follows the barcode's proportions. With both width and
+     * height, they are a maximum: the barcode takes the largest size that fits in them, and its box
+     * becomes that size. A QR code is square, so it takes the smaller of the two. Without a size, a
+     * code128 is as wide as its bars at 1pt per module and its bars are 40pt high, and an ean13 is
+     * the standard symbol, 0.33mm per module and bars 22.85mm high. The digits of hrt add 12pt to
+     * either.
      */
     height?: string;
     ec?: string;
@@ -357,8 +394,8 @@ export interface BarcodeAttr {
     debug?: string;
 }
 /**
- * A block of wrapping text. Use span children to style parts of it. Splits across pages between
- * lines.
+ * A block of wrapping text. Use span children to style parts of it, and fn children for footnotes.
+ * Splits across pages between lines.
  */
 export interface TextAttr {
     fontSize?: string;
@@ -457,9 +494,10 @@ export interface TdAttr {
      */
     padding?: string;
     /**
-     * Height of the box. Leave it out to size to the content. A length fixes it; fill takes what is
-     * left after its siblings (shared equally if several use fill); full takes all the height
-     * available. Any of these stops the box splitting across pages.
+     * Height of the box. Leave it out to size to the content. A length, or a name from the height row
+     * of the tokens, fixes it; fill takes what is left after its siblings (shared equally if several
+     * use fill); full takes all the height available. Any of these stops the box splitting across
+     * pages.
      */
     height?: string;
     background?: string;
@@ -490,6 +528,24 @@ export interface TdAttr {
      */
     paginate?: string;
     debug?: string;
+    /**
+     * How many of the table's columns the cell spans. It is as wide as those columns and the gaps
+     * between them, and the cells after it in the row start at the column after its last. A row whose
+     * cells span more columns than the table's cols names is an error; a row with fewer leaves its
+     * last columns empty. It changes widths only: row heights and page breaks work as before. Default
+     * 1.
+     */
+    colspan?: string;
+    /**
+     * How many rows the cell spans, its own included. It is as tall as those rows and the gaps
+     * between them, and the rows under it leave its columns out: their cells start at the first free
+     * columns. If the cell's content is taller than the rows are together, the last of them grows by
+     * the difference. A row with a cell too many for the free columns, and a span that runs past the
+     * last row of the table, are errors; a thead is one row and takes no rowspan. The rows a cell
+     * spans stay on one page: the group moves to the next page whole when it does not fit, and one
+     * taller than a page is clipped at the page's end. Default 1.
+     */
+    rowspan?: string;
     align?: string;
     valign?: string;
 }
@@ -503,6 +559,14 @@ export interface TheadAttr {
  * Attributes of the `tr` element.
  */
 export interface TrAttr {
+    /**
+     * with-next keeps the row on the same page as the row after it. A run of rows that each say
+     * with-next, and the row that ends it, move to the next page together when a page break would
+     * fall inside them. A run taller than a page breaks where its rows fit, as if it had no keep.
+     * Rows are never split, and a header is never left alone at the bottom of a page, with or without
+     * this.
+     */
+    keep?: string;
     background?: string;
 }
 /**

package/dist/browser.js

@@ -413,6 +413,11 @@ var Orientation = {
 var SectionType = {
   Toc: "toc"
 };
+var FootnoteCounter = {
+  Page: "page",
+  Section: "section",
+  Document: "document"
+};
 var BuiltinFont = {
   Courier: "Courier",
   CourierBold: "Courier-Bold",
@@ -490,6 +495,7 @@ async function initLpdf(wasmSource, licenseKey = "") {
 export {
   BuiltinFont,
   FieldType,
+  FootnoteCounter,
   NoAttr,
   Orientation,
   PageScope,

package/dist/constants.d.ts

@@ -26,6 +26,13 @@ export declare const SectionType: {
     readonly Toc: "toc";
 };
 export type SectionType = (typeof SectionType)[keyof typeof SectionType];
+/** The values of the `footnote-counter` attribute of a document or a section. */
+export declare const FootnoteCounter: {
+    readonly Page: "page";
+    readonly Section: "section";
+    readonly Document: "document";
+};
+export type FootnoteCounter = (typeof FootnoteCounter)[keyof typeof FootnoteCounter];
 /** The values of the `core` attribute of a font: the built-in PDF fonts, which need no file. */
 export declare const BuiltinFont: {
     readonly Courier: "Courier";

package/dist/constants.js

@@ -2,7 +2,7 @@
 // Generated from lpdf.xsd by scripts/gen-sdk-api.mjs.
 // Do not edit: change the schema and run `make gen-sdk-api`.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PageScope = exports.BuiltinFont = exports.SectionType = exports.Orientation = exports.Pin = exports.FieldType = void 0;
+exports.PageScope = exports.BuiltinFont = exports.FootnoteCounter = exports.SectionType = exports.Orientation = exports.Pin = exports.FieldType = void 0;
 /** The values of the `type` attribute of a field. */
 exports.FieldType = {
     Text: 'text',
@@ -27,6 +27,12 @@ exports.Orientation = {
 exports.SectionType = {
     Toc: 'toc',
 };
+/** The values of the `footnote-counter` attribute of a document or a section. */
+exports.FootnoteCounter = {
+    Page: 'page',
+    Section: 'section',
+    Document: 'document',
+};
 /** The values of the `core` attribute of a font: the built-in PDF fonts, which need no file. */
 exports.BuiltinFont = {
     Courier: 'Courier',

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 export { PdfEngine, LpdfRenderError } from './engine';
 export type { EncryptPermissions, EncryptOptions } from './engine';
 export type { RenderOptions, EngineOptions } from './_shared';
-export { FieldType, Pin, Orientation, SectionType, BuiltinFont, PageScope } from './constants';
+export { FieldType, Pin, Orientation, SectionType, FootnoteCounter, BuiltinFont, PageScope } from './constants';
 export type { PdfDocument, LpdfSectionNode, LpdfSectionChild, LpdfLayoutBlock, DocumentTokens, GradientToken, GradientStop, DocumentAssets, DocumentMeta, SectionAttr, DocumentAttr, } from './kit';
-export type { ColumnAttr, RowAttr, GridAttr, FrameAttr, LinkAttr, TableAttr, TheadAttr, TrAttr, TdAttr, TextAttr, SpanAttr, DividerAttr, ImgAttr, BarcodeAttr, RegionAttr, FieldAttr, BookmarkAttr, LayerAttr, RectAttr, CircleAttr, EllipseAttr, LineAttr, PathAttr, TextAtAttr, ImgAtAttr, BarcodeAtAttr, FontAttr, ImageAttr, LayoutAttr, } from './attrs';
-export type { LpdfNode, LpdfContainerNode, LpdfTextNode, LpdfSpanNode, LpdfDividerNode, LpdfImgNode, LpdfBarcodeNode, LpdfTableNode, LpdfTheadNode, LpdfTrNode, LpdfTdNode, LpdfRegionNode, LpdfFieldNode, LpdfBookmarkNode, } from './layout';
+export type { ColumnAttr, RowAttr, GridAttr, FrameAttr, LinkAttr, TableAttr, TheadAttr, TrAttr, TdAttr, TextAttr, SpanAttr, DividerAttr, ImgAttr, ShapeAttr, BarcodeAttr, RegionAttr, FieldAttr, BookmarkAttr, LayerAttr, RectAttr, CircleAttr, EllipseAttr, LineAttr, PathAttr, TextAtAttr, ImgAtAttr, BarcodeAtAttr, FontAttr, ImageAttr, LayoutAttr, } from './attrs';
+export type { LpdfNode, LpdfContainerNode, LpdfTextNode, LpdfSpanNode, LpdfFnNode, LpdfDividerNode, LpdfImgNode, LpdfShapeNode, LpdfBarcodeNode, LpdfTableNode, LpdfTheadNode, LpdfTrNode, LpdfTdNode, LpdfRegionNode, LpdfFieldNode, LpdfBookmarkNode, } from './layout';
 export { CanvasTransform } from './canvas';
 export type { LpdfCanvasLayerNode, LpdfCanvasPrimitiveNode, LpdfCanvasRectNode, LpdfCanvasLineNode, LpdfCanvasEllipseNode, LpdfCanvasCircleNode, LpdfCanvasPathNode, LpdfCanvasTextAtNode, LpdfCanvasImgAtNode, LpdfCanvasBarcodeAtNode, } from './canvas';
 export { L, NoAttr } from './L';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NoAttr = exports.L = exports.CanvasTransform = exports.PageScope = exports.BuiltinFont = exports.SectionType = exports.Orientation = exports.Pin = exports.FieldType = exports.LpdfRenderError = exports.PdfEngine = void 0;
+exports.NoAttr = exports.L = exports.CanvasTransform = exports.PageScope = exports.BuiltinFont = exports.FootnoteCounter = exports.SectionType = exports.Orientation = exports.Pin = exports.FieldType = exports.LpdfRenderError = exports.PdfEngine = void 0;
 // ── Engine ────────────────────────────────────────────────────────────────────
 var engine_1 = require("./engine");
 Object.defineProperty(exports, "PdfEngine", { enumerable: true, get: function () { return engine_1.PdfEngine; } });
@@ -11,6 +11,7 @@ Object.defineProperty(exports, "FieldType", { enumerable: true, get: function ()
 Object.defineProperty(exports, "Pin", { enumerable: true, get: function () { return constants_1.Pin; } });
 Object.defineProperty(exports, "Orientation", { enumerable: true, get: function () { return constants_1.Orientation; } });
 Object.defineProperty(exports, "SectionType", { enumerable: true, get: function () { return constants_1.SectionType; } });
+Object.defineProperty(exports, "FootnoteCounter", { enumerable: true, get: function () { return constants_1.FootnoteCounter; } });
 Object.defineProperty(exports, "BuiltinFont", { enumerable: true, get: function () { return constants_1.BuiltinFont; } });
 Object.defineProperty(exports, "PageScope", { enumerable: true, get: function () { return constants_1.PageScope; } });
 // ── Layer types ───────────────────────────────────────────────────────────────

package/dist/kit.d.ts

@@ -42,11 +42,19 @@ export interface GradientToken {
 export interface DocumentTokens {
     colors?: Record<string, string>;
     gradients?: Record<string, GradientToken>;
+    /**
+     * Names for the slots of the scale, each to the slot it stands for: `{ caption: 'xs' }` lets `fontSize: 'caption'`
+     * mean the text size `xs`, and `gap: 'caption'` the space `xs`. A name is lowercase letters, digits and `-`,
+     * starting with a letter, and is neither a slot nor `fill` or `full`.
+     */
+    aliases?: Record<string, string>;
     space?: Record<string, string>;
     grid?: Record<string, string>;
     border?: Record<string, string>;
     radius?: Record<string, string>;
     width?: Record<string, string>;
+    /** The heights `height` names: `{ xs: '16pt', s: '24pt', m: '32pt', l: '48pt', xl: '64pt', xxl: '96pt' }` by default. */
+    height?: Record<string, string>;
     textSize?: Record<string, string>;
     lineHeight?: Record<string, string>;
 }
@@ -73,6 +81,7 @@ export interface SectionAttr {
     debug?: string;
     type?: string;
     tocIndentStep?: string;
+    footnoteCounter?: string;
 }
 export interface DocumentAttr {
     size?: string;
@@ -83,6 +92,7 @@ export interface DocumentAttr {
     tokens?: DocumentTokens;
     meta?: DocumentMeta;
     debug?: string;
+    footnoteCounter?: string;
 }
 /** A layout block — wraps an ordered list of layout nodes. */
 export interface LpdfLayoutBlock {

package/dist/layout.d.ts

@@ -1,9 +1,15 @@
-import type { ColumnAttr, RowAttr, GridAttr, FrameAttr, LinkAttr, TableAttr, TheadAttr, TrAttr, TdAttr, TextAttr, SpanAttr, DividerAttr, ImgAttr, BarcodeAttr, FieldAttr, RegionAttr, BookmarkAttr } from './attrs';
+import type { ColumnAttr, RowAttr, GridAttr, FrameAttr, LinkAttr, TableAttr, TheadAttr, TrAttr, TdAttr, TextAttr, SpanAttr, DividerAttr, ImgAttr, ShapeAttr, BarcodeAttr, FieldAttr, RegionAttr, BookmarkAttr } from './attrs';
 export interface LpdfSpanNode {
     type: 'span';
     attrs: Record<string, string>;
     nodes: string[];
 }
+/** A footnote: its words go at the bottom of the page where its number lands. */
+export interface LpdfFnNode {
+    type: 'fn';
+    attrs: Record<string, string>;
+    nodes: (string | LpdfSpanNode)[];
+}
 export interface LpdfContainerNode {
     type: 'column' | 'row' | 'grid' | 'frame' | 'link';
     attrs: Record<string, string>;
@@ -12,7 +18,7 @@ export interface LpdfContainerNode {
 export interface LpdfTextNode {
     type: 'text';
     attrs: Record<string, string>;
-    nodes: (string | LpdfSpanNode)[];
+    nodes: (string | LpdfSpanNode | LpdfFnNode)[];
 }
 export interface LpdfDividerNode {
     type: 'divider';
@@ -22,6 +28,10 @@ export interface LpdfImgNode {
     type: 'img';
     attrs: Record<string, string>;
 }
+export interface LpdfShapeNode {
+    type: 'shape';
+    attrs: Record<string, string>;
+}
 export interface LpdfBarcodeNode {
     type: 'barcode';
     attrs: Record<string, string>;
@@ -60,7 +70,7 @@ export interface LpdfBookmarkNode {
     type: 'bookmark';
     attrs: Record<string, string>;
 }
-export type LpdfNode = LpdfContainerNode | LpdfTextNode | LpdfDividerNode | LpdfTableNode | LpdfImgNode | LpdfBarcodeNode | LpdfRegionNode | LpdfFieldNode | LpdfBookmarkNode;
+export type LpdfNode = LpdfContainerNode | LpdfTextNode | LpdfDividerNode | LpdfTableNode | LpdfImgNode | LpdfShapeNode | LpdfBarcodeNode | LpdfRegionNode | LpdfFieldNode | LpdfBookmarkNode;
 declare function column(attrs: ColumnAttr | null, nodes?: LpdfNode[]): LpdfContainerNode;
 declare function row(attrs: RowAttr | null, nodes?: LpdfNode[]): LpdfContainerNode;
 declare function grid(attrs: GridAttr | null, nodes?: LpdfNode[]): LpdfContainerNode;
@@ -70,10 +80,18 @@ declare function table(attrs: TableAttr, nodes?: (LpdfTheadNode | LpdfTrNode)[])
 declare function thead(attrs: TheadAttr | null, nodes?: LpdfTdNode[]): LpdfTheadNode;
 declare function tr(attrs: TrAttr | null, nodes?: LpdfTdNode[]): LpdfTrNode;
 declare function td(attrs: TdAttr | null, nodes?: LpdfNode[]): LpdfTdNode;
-declare function text(attrs: TextAttr | null, nodes?: (string | LpdfSpanNode)[]): LpdfTextNode;
+declare function text(attrs: TextAttr | null, nodes?: (string | LpdfSpanNode | LpdfFnNode)[]): LpdfTextNode;
 declare function span(attrs: SpanAttr | null, nodes?: string[]): LpdfSpanNode;
+/**
+ * A footnote, in the nodes of a text. The engine numbers it and puts a small raised number at its place in the
+ * text; its words go at the bottom of the page where that number lands. It has no attributes: pass `NoAttr`.
+ * The words are strings and spans.
+ */
+declare function fn(attrs: null, nodes?: (string | LpdfSpanNode)[]): LpdfFnNode;
 declare function divider(attrs?: DividerAttr | null): LpdfDividerNode;
 declare function img(attrs: ImgAttr): LpdfImgNode;
+/** A rect, circle or ellipse that takes its box in the layout, as an image does. */
+declare function shape(attrs: ShapeAttr): LpdfShapeNode;
 declare function barcode(attrs: BarcodeAttr): LpdfBarcodeNode;
 declare function region(attrs: RegionAttr, nodes?: LpdfNode[]): LpdfRegionNode;
 declare function field(attrs: FieldAttr): LpdfFieldNode;
@@ -90,8 +108,10 @@ export declare const LpdfLayout: Readonly<{
     link: typeof link;
     text: typeof text;
     span: typeof span;
+    fn: typeof fn;
     divider: typeof divider;
     img: typeof img;
+    shape: typeof shape;
     barcode: typeof barcode;
     table: typeof table;
     thead: typeof thead;

package/dist/layout.js

@@ -40,12 +40,24 @@ function text(attrs, nodes = []) {
 function span(attrs, nodes = []) {
     return { type: 'span', attrs: (0, _shared_1.buildAttrs)(attrs), nodes };
 }
+/**
+ * A footnote, in the nodes of a text. The engine numbers it and puts a small raised number at its place in the
+ * text; its words go at the bottom of the page where that number lands. It has no attributes: pass `NoAttr`.
+ * The words are strings and spans.
+ */
+function fn(attrs, nodes = []) {
+    return { type: 'fn', attrs: {}, nodes };
+}
 function divider(attrs = null) {
     return { type: 'divider', attrs: (0, _shared_1.buildAttrs)(attrs) };
 }
 function img(attrs) {
     return { type: 'img', attrs: (0, _shared_1.buildAttrs)(attrs) };
 }
+/** A rect, circle or ellipse that takes its box in the layout, as an image does. */
+function shape(attrs) {
+    return { type: 'shape', attrs: (0, _shared_1.buildAttrs)(attrs) };
+}
 function barcode(attrs) {
     return { type: 'barcode', attrs: (0, _shared_1.buildAttrs)(attrs) };
 }
@@ -70,8 +82,10 @@ exports.LpdfLayout = Object.freeze({
     link,
     text,
     span,
+    fn,
     divider,
     img,
+    shape,
     barcode,
     table,
     thead,

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@lpdfio/lpdf",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "Node.js SDK for Lpdf — PDF as Code on every platform. You describe a document as code or XML. Lpdf renders a compact, pixel-perfect PDF — identical across platforms.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "default": "./dist/index.js"
     },
     "./browser": {
       "import": "./dist/browser.js",
@@ -18,7 +19,7 @@
     "build": "tsc && node build-browser.mjs && node -e \"require('node:fs').cpSync('./wasm', './dist/wasm', {recursive:true})\"",
     "build:node": "tsc",
     "build:browser": "node build-browser.mjs",
-    "test": "node --test test/render.test.mjs"
+    "test": "node --test test/render.test.mjs test/package-entry.test.mjs"
   },
   "author": "lpdf.io",
   "homepage": "https://lpdf.io",