@lpdfio/lpdf 0.29.0 → 0.31.0

package/dist/attrs.d.ts

@@ -15,7 +15,8 @@ export interface ColumnAttr {
     /**
      * Space between the edge of the box and its content, written like CSS: one value for all sides,
      * two for top-bottom and left-right, three for top, left-right and bottom, four for top, right,
-     * bottom and left.
+     * bottom and left. Each value is a length or a name from the space row of the tokens, and they
+     * can be mixed: 0pt 0pt 0pt m.
      */
     padding?: string;
     /**
@@ -33,7 +34,7 @@ export interface ColumnAttr {
      * that overlap do not show through each other, and a box inside a faded box is faded further: 0.5
      * inside 0.5 is drawn at 0.25. A form field in the box is not faded. Default 1.
      */
-    opacity?: string;
+    opacity?: number;
     /**
      * A hard-edged shadow: a copy of the box, moved right and down by the first two lengths (negative
      * is left and up) and filled with the color, drawn under the box with the same radius. An opacity
@@ -47,12 +48,13 @@ export interface ColumnAttr {
      * Where the box falls in the page flow. no: never split the box, and move it whole to the next
      * page when it does not fit. break-before: start it on a new page. break-after: start the next
      * sibling on a new page. keep-next: keep it on one page with the sibling that follows, moving
-     * both to the next page if that sibling would not fit. break-before, break-after and keep-next
-     * take effect on the children of layout; on a box inside another box they are not applied. no
-     * applies at any depth.
+     * both to the next page if that sibling would not fit and cannot start on this page: a table
+     * splits after its header and a row, and a text after a few lines, and then it stays with that
+     * first part. break-before, break-after and keep-next take effect on the children of layout; on a
+     * box inside another box they are not applied. no applies at any depth.
      */
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
     align?: string;
     justify?: string;
     /**
@@ -81,7 +83,8 @@ export interface RowAttr {
     /**
      * Space between the edge of the box and its content, written like CSS: one value for all sides,
      * two for top-bottom and left-right, three for top, left-right and bottom, four for top, right,
-     * bottom and left.
+     * bottom and left. Each value is a length or a name from the space row of the tokens, and they
+     * can be mixed: 0pt 0pt 0pt m.
      */
     padding?: string;
     /**
@@ -99,7 +102,7 @@ export interface RowAttr {
      * that overlap do not show through each other, and a box inside a faded box is faded further: 0.5
      * inside 0.5 is drawn at 0.25. A form field in the box is not faded. Default 1.
      */
-    opacity?: string;
+    opacity?: number;
     /**
      * A hard-edged shadow: a copy of the box, moved right and down by the first two lengths (negative
      * is left and up) and filled with the color, drawn under the box with the same radius. An opacity
@@ -113,12 +116,13 @@ export interface RowAttr {
      * Where the box falls in the page flow. no: never split the box, and move it whole to the next
      * page when it does not fit. break-before: start it on a new page. break-after: start the next
      * sibling on a new page. keep-next: keep it on one page with the sibling that follows, moving
-     * both to the next page if that sibling would not fit. break-before, break-after and keep-next
-     * take effect on the children of layout; on a box inside another box they are not applied. no
-     * applies at any depth.
+     * both to the next page if that sibling would not fit and cannot start on this page: a table
+     * splits after its header and a row, and a text after a few lines, and then it stays with that
+     * first part. break-before, break-after and keep-next take effect on the children of layout; on a
+     * box inside another box they are not applied. no applies at any depth.
      */
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
     align?: string;
     justify?: string;
     /**
@@ -145,7 +149,8 @@ export interface GridAttr {
     /**
      * Space between the edge of the box and its content, written like CSS: one value for all sides,
      * two for top-bottom and left-right, three for top, left-right and bottom, four for top, right,
-     * bottom and left.
+     * bottom and left. Each value is a length or a name from the space row of the tokens, and they
+     * can be mixed: 0pt 0pt 0pt m.
      */
     padding?: string;
     /**
@@ -163,7 +168,7 @@ export interface GridAttr {
      * that overlap do not show through each other, and a box inside a faded box is faded further: 0.5
      * inside 0.5 is drawn at 0.25. A form field in the box is not faded. Default 1.
      */
-    opacity?: string;
+    opacity?: number;
     /**
      * A hard-edged shadow: a copy of the box, moved right and down by the first two lengths (negative
      * is left and up) and filled with the color, drawn under the box with the same radius. An opacity
@@ -177,12 +182,13 @@ export interface GridAttr {
      * Where the box falls in the page flow. no: never split the box, and move it whole to the next
      * page when it does not fit. break-before: start it on a new page. break-after: start the next
      * sibling on a new page. keep-next: keep it on one page with the sibling that follows, moving
-     * both to the next page if that sibling would not fit. break-before, break-after and keep-next
-     * take effect on the children of layout; on a box inside another box they are not applied. no
-     * applies at any depth.
+     * both to the next page if that sibling would not fit and cannot start on this page: a table
+     * splits after its header and a row, and a text after a few lines, and then it stays with that
+     * first part. break-before, break-after and keep-next take effect on the children of layout; on a
+     * box inside another box they are not applied. no applies at any depth.
      */
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
     /**
      * Width of the element. A length fixes it. fill, in a row, takes the width its line leaves after
      * the other children, shared equally if several on the line use fill, and never moves to the next
@@ -190,7 +196,177 @@ export interface GridAttr {
      */
     width?: string;
     colWidth?: string;
-    cols?: string;
+    cols?: number;
+}
+/**
+ * A list of items, each with a marker: a bullet drawn as a shape, or a number the engine gives. The
+ * items go top to bottom with gap between them, each one a li, and a list nests inside an item. The
+ * words of an item start indent from the list's left edge, at every level. A long item splits
+ * across pages through the line the page ends in, and its marker stays with the first part.
+ */
+export interface ListAttr {
+    font?: string;
+    fontSize?: string;
+    /**
+     * The color of the text inside the box. A text that sets no color of its own takes the nearest
+     * box's, and the text token when no box sets one. A divider or a barcode in the box keeps its own
+     * color.
+     */
+    color?: string;
+    gap?: string;
+    /**
+     * Space between the edge of the box and its content, written like CSS: one value for all sides,
+     * two for top-bottom and left-right, three for top, left-right and bottom, four for top, right,
+     * bottom and left. Each value is a length or a name from the space row of the tokens, and they
+     * can be mixed: 0pt 0pt 0pt m.
+     */
+    padding?: string;
+    /**
+     * 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;
+    border?: string;
+    radius?: string;
+    /**
+     * How opaque the box and everything in it is, from 0 to 1. The box is faded as one, so children
+     * that overlap do not show through each other, and a box inside a faded box is faded further: 0.5
+     * inside 0.5 is drawn at 0.25. A form field in the box is not faded. Default 1.
+     */
+    opacity?: number;
+    /**
+     * A hard-edged shadow: a copy of the box, moved right and down by the first two lengths (negative
+     * is left and up) and filled with the color, drawn under the box with the same radius. An opacity
+     * from 0 to 1 after the color fades the shadow alone: "2pt 3pt #000000 0.2". There is no blur.
+     * The shadow takes no room in the layout, so it can run into the margin or a neighbor, and the
+     * siblings after the box are drawn over it. A box with no background shows the shadow only
+     * outside it. The box's own opacity fades the box and its shadow together.
+     */
+    shadow?: string;
+    /**
+     * Where the box falls in the page flow. no: never split the box, and move it whole to the next
+     * page when it does not fit. break-before: start it on a new page. break-after: start the next
+     * sibling on a new page. keep-next: keep it on one page with the sibling that follows, moving
+     * both to the next page if that sibling would not fit and cannot start on this page: a table
+     * splits after its header and a row, and a text after a few lines, and then it stays with that
+     * first part. break-before, break-after and keep-next take effect on the children of layout; on a
+     * box inside another box they are not applied. no applies at any depth.
+     */
+    paginate?: string;
+    debug?: boolean;
+    /** bullet marks each item with a shape, number with a number. Default bullet. */
+    type?: string;
+    /**
+     * How a number list writes its numbers: decimal (1, 2, 3), lower-alpha (a, b, c, then aa, ab),
+     * upper-alpha (A, B, C), lower-roman (i, ii, iii) or upper-roman (I, II, III). A number that a
+     * letter or a numeral can't write, below 1 or past 3999 for a numeral, is written in decimal.
+     * Default decimal.
+     */
+    format?: string;
+    /**
+     * The number of a number list's first item, to continue a list that something cut in two. Default
+     * 1.
+     */
+    start?: number;
+    /**
+     * Text before each number of a number list: prefix="(" and suffix=")" write (a). Default none.
+     */
+    prefix?: string;
+    /**
+     * Text after each number of a number list: suffix=")" writes a). Default a full stop, so a number
+     * is written 1.
+     */
+    suffix?: string;
+    /**
+     * The shape that marks the items of a bullet list. Without it a list uses a disc, a list inside a
+     * bullet list a circle, and one inside that a square, then the three again.
+     */
+    bullet?: string;
+    /**
+     * The width of the marker's column: the words of an item start this far from the list's left
+     * edge, and a list inside an item starts there too. The marker is set at the right of its column,
+     * so 9. and 10. end together, and a marker wider than the column is not made to fit. The same
+     * length at every level. Default 24pt.
+     */
+    indent?: string;
+    /**
+     * Width of the element. A length fixes it. fill, in a row, takes the width its line leaves after
+     * the other children, shared equally if several on the line use fill, and never moves to the next
+     * line; in a column it takes the full width.
+     */
+    width?: string;
+}
+/**
+ * One item of a list: a box that holds what a layout holds, such as a text, an image, a table or
+ * another list, and sits beside the item's marker. The words go in a text. data-source repeats the
+ * item once for each entry of the data, and the numbers of a number list follow what is made. The
+ * item's own box (padding, background, border) surrounds the marker and the content, and its gap
+ * goes between its children: the gap of the list, unless the item sets one.
+ */
+export interface LiAttr {
+    font?: string;
+    fontSize?: string;
+    /**
+     * The color of the text inside the box. A text that sets no color of its own takes the nearest
+     * box's, and the text token when no box sets one. A divider or a barcode in the box keeps its own
+     * color.
+     */
+    color?: string;
+    gap?: string;
+    /**
+     * Space between the edge of the box and its content, written like CSS: one value for all sides,
+     * two for top-bottom and left-right, three for top, left-right and bottom, four for top, right,
+     * bottom and left. Each value is a length or a name from the space row of the tokens, and they
+     * can be mixed: 0pt 0pt 0pt m.
+     */
+    padding?: string;
+    /**
+     * 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;
+    border?: string;
+    radius?: string;
+    /**
+     * How opaque the box and everything in it is, from 0 to 1. The box is faded as one, so children
+     * that overlap do not show through each other, and a box inside a faded box is faded further: 0.5
+     * inside 0.5 is drawn at 0.25. A form field in the box is not faded. Default 1.
+     */
+    opacity?: number;
+    /**
+     * A hard-edged shadow: a copy of the box, moved right and down by the first two lengths (negative
+     * is left and up) and filled with the color, drawn under the box with the same radius. An opacity
+     * from 0 to 1 after the color fades the shadow alone: "2pt 3pt #000000 0.2". There is no blur.
+     * The shadow takes no room in the layout, so it can run into the margin or a neighbor, and the
+     * siblings after the box are drawn over it. A box with no background shows the shadow only
+     * outside it. The box's own opacity fades the box and its shadow together.
+     */
+    shadow?: string;
+    /**
+     * Where the box falls in the page flow. no: never split the box, and move it whole to the next
+     * page when it does not fit. break-before: start it on a new page. break-after: start the next
+     * sibling on a new page. keep-next: keep it on one page with the sibling that follows, moving
+     * both to the next page if that sibling would not fit and cannot start on this page: a table
+     * splits after its header and a row, and a text after a few lines, and then it stays with that
+     * first part. break-before, break-after and keep-next take effect on the children of layout; on a
+     * box inside another box they are not applied. no applies at any depth.
+     */
+    paginate?: string;
+    debug?: boolean;
+    /**
+     * Makes the item's marker a checkbox in place of the bullet or the number: an outline in the line
+     * color, with a tick in the color of the item's words when this is true, and empty when it is
+     * false. The words start where those of a bullet do, and an item of a number list still takes its
+     * number. An item without it keeps its bullet or number. A task item of a Markdown, - [ ] or -
+     * [x], is one.
+     */
+    checked?: boolean;
 }
 /**
  * A box around a single child, which it centres. Never splits across pages: if it does not fit, the
@@ -208,7 +384,8 @@ export interface FrameAttr {
     /**
      * Space between the edge of the box and its content, written like CSS: one value for all sides,
      * two for top-bottom and left-right, three for top, left-right and bottom, four for top, right,
-     * bottom and left.
+     * bottom and left. Each value is a length or a name from the space row of the tokens, and they
+     * can be mixed: 0pt 0pt 0pt m.
      */
     padding?: string;
     /**
@@ -226,7 +403,7 @@ export interface FrameAttr {
      * that overlap do not show through each other, and a box inside a faded box is faded further: 0.5
      * inside 0.5 is drawn at 0.25. A form field in the box is not faded. Default 1.
      */
-    opacity?: string;
+    opacity?: number;
     /**
      * A hard-edged shadow: a copy of the box, moved right and down by the first two lengths (negative
      * is left and up) and filled with the color, drawn under the box with the same radius. An opacity
@@ -240,12 +417,13 @@ export interface FrameAttr {
      * Where the box falls in the page flow. no: never split the box, and move it whole to the next
      * page when it does not fit. break-before: start it on a new page. break-after: start the next
      * sibling on a new page. keep-next: keep it on one page with the sibling that follows, moving
-     * both to the next page if that sibling would not fit. break-before, break-after and keep-next
-     * take effect on the children of layout; on a box inside another box they are not applied. no
-     * applies at any depth.
+     * both to the next page if that sibling would not fit and cannot start on this page: a table
+     * splits after its header and a row, and a text after a few lines, and then it stays with that
+     * first part. break-before, break-after and keep-next take effect on the children of layout; on a
+     * box inside another box they are not applied. no applies at any depth.
      */
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
     /**
      * Width of the element. A length fixes it. fill, in a row, takes the width its line leaves after
      * the other children, shared equally if several on the line use fill, and never moves to the next
@@ -270,7 +448,7 @@ export interface LinkAttr {
      */
     width?: string;
     height?: string;
-    debug?: string;
+    debug?: boolean;
 }
 /**
  * Attributes of the `divider` element.
@@ -285,22 +463,34 @@ export interface DividerAttr {
      * line; in a column it takes the full width.
      */
     width?: string;
-    debug?: string;
+    debug?: boolean;
 }
 /**
  * Attributes of the `span` element.
  */
 export interface SpanAttr {
     font?: string;
-    bold?: string;
+    bold?: boolean;
     color?: string;
     /**
      * Makes the span a link: a URL, or #id to jump to the bookmark with that id. In an entry of a
      * table of contents, # alone jumps to that entry's bookmark.
      */
     href?: string;
-    underline?: string;
-    strike?: string;
+    underline?: boolean;
+    strike?: boolean;
+}
+/**
+ * A run of code inside a text: its words in Courier on a light tint, the tint drawn behind them. It
+ * is the inline twin of code, and like a span it is not broken inside, so it goes to the next line
+ * whole, and a run longer than a whole line breaks at the last character that fits, so nothing runs
+ * past the box. White space in it collapses as in the text around it.
+ */
+export interface CodeSpanAttr {
+    font?: string;
+    color?: string;
+    /** The tint drawn behind the run. Default #f3f4f6. */
+    background?: string;
 }
 /**
  * An image. It is never stretched. With only a width or a height, the other follows the image's
@@ -326,7 +516,7 @@ export interface ImgAttr {
     border?: string;
     radius?: string;
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
 }
 /**
  * A rectangle, a circle or an ellipse in the layout, for a status dot, a color swatch or a progress
@@ -357,8 +547,8 @@ export interface ShapeAttr {
     strokeWidth?: string;
     strokeDash?: string;
     /** How opaque the shape is, from 0 to 1. Default 1. */
-    opacity?: string;
-    debug?: string;
+    opacity?: number;
+    debug?: boolean;
 }
 /**
  * A QR code, a Code 128 or an EAN-13. It is never stretched. With only a width or a height, the
@@ -381,7 +571,7 @@ export interface BarcodeAttr {
      */
     height?: string;
     ec?: string;
-    hrt?: string;
+    hrt?: boolean;
     color?: string;
     background?: string;
     /**
@@ -391,7 +581,7 @@ export interface BarcodeAttr {
      */
     width?: string;
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
 }
 /**
  * A block of wrapping text. Use span children to style parts of it, and fn children for footnotes.
@@ -405,28 +595,28 @@ export interface TextAttr {
      * Helvetica-Bold, Times-Roman becomes Times-Bold, Courier becomes Courier-Bold, and the oblique
      * and italic faces their bold forms. A custom font has no bold face to pick, so name one in font.
      */
-    bold?: string;
+    bold?: boolean;
     color?: string;
     align?: string;
     /**
      * The distance between lines, as a factor of the font size: a number above 0, such as 1.5, or a
      * name from the line-height row of the tokens. Default 1.2, which is the token m.
      */
-    lineHeight?: string;
+    lineHeight?: string | number;
     /**
      * The most lines drawn. Only whole lines are drawn, and the rest of the text is dropped. A text
      * in the layout has no cap by default and wraps at the width it has; the lines it drops take no
      * room, and a text that splits across pages keeps the cap across them. A text-at is one line by
      * default, and above 1 needs a width to wrap within.
      */
-    maxLines?: string;
+    maxLines?: number;
     /**
      * End the last line drawn in an ellipsis when max-lines drops text, shortened to fit the width.
      * Off by default: the text stops at the end of a line. A text-at also ends a line in one when it
      * is cut off at its width. A text in the layout without max-lines is never cut, so there it has
      * no effect.
      */
-    ellipsis?: string;
+    ellipsis?: boolean;
     /**
      * Width of the element. A length fixes it. fill, in a row, takes the width its line leaves after
      * the other children, shared equally if several on the line use fill, and never moves to the next
@@ -438,14 +628,14 @@ export interface TextAttr {
      * Default 2. If fewer would be left, lines move from the first page to the next; 1 turns the
      * protection off.
      */
-    widows?: string;
+    widows?: number;
     /**
      * The fewest lines of the text that may stand alone at the bottom of a page when it splits.
      * Default 2. If fewer would fit, the whole text moves to the next page; 1 turns the protection
      * off. When no split can keep both widows and orphans, even on an empty page, the text splits
      * where the lines fit.
      */
-    orphans?: string;
+    orphans?: number;
     /**
      * Records the words of this text under a name as the pages are filled, so a text with capture-ref
      * in a header or a footer can show them. Put it on a heading in the flow. The page that holds the
@@ -472,7 +662,99 @@ export interface TextAttr {
      */
     captureFallback?: string;
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
+}
+/**
+ * Code, or any text whose spaces and lines matter, in a box. The text is kept as it is written:
+ * every space, and a new line wherever one is written, except the line break after the start tag
+ * and the indent of the line the end tag stands on. A line longer than the box wraps at a space,
+ * and a word with none breaks at the last character that fits, so nothing is cut off. A tab fills
+ * to the next multiple of tab-size columns. The box fills the width and grows with its lines, in
+ * Courier on a light tint with padding m unless font, background and padding say otherwise. It
+ * holds text and span children, which color or style parts of it. It splits across pages between
+ * lines, and each part is drawn in its own box. A code element is a column around one text, so the
+ * text takes its font, size and color from font, font-size and color.
+ */
+export interface CodeAttr {
+    font?: string;
+    fontSize?: string;
+    /**
+     * The color of the text inside the box. A text that sets no color of its own takes the nearest
+     * box's, and the text token when no box sets one. A divider or a barcode in the box keeps its own
+     * color.
+     */
+    color?: string;
+    /**
+     * Space between the edge of the box and its content, written like CSS: one value for all sides,
+     * two for top-bottom and left-right, three for top, left-right and bottom, four for top, right,
+     * bottom and left. Each value is a length or a name from the space row of the tokens, and they
+     * can be mixed: 0pt 0pt 0pt m.
+     */
+    padding?: string;
+    /**
+     * 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;
+    border?: string;
+    radius?: string;
+    /**
+     * How opaque the box and everything in it is, from 0 to 1. The box is faded as one, so children
+     * that overlap do not show through each other, and a box inside a faded box is faded further: 0.5
+     * inside 0.5 is drawn at 0.25. A form field in the box is not faded. Default 1.
+     */
+    opacity?: number;
+    /**
+     * A hard-edged shadow: a copy of the box, moved right and down by the first two lengths (negative
+     * is left and up) and filled with the color, drawn under the box with the same radius. An opacity
+     * from 0 to 1 after the color fades the shadow alone: "2pt 3pt #000000 0.2". There is no blur.
+     * The shadow takes no room in the layout, so it can run into the margin or a neighbor, and the
+     * siblings after the box are drawn over it. A box with no background shows the shadow only
+     * outside it. The box's own opacity fades the box and its shadow together.
+     */
+    shadow?: string;
+    /**
+     * Where the box falls in the page flow. no: never split the box, and move it whole to the next
+     * page when it does not fit. break-before: start it on a new page. break-after: start the next
+     * sibling on a new page. keep-next: keep it on one page with the sibling that follows, moving
+     * both to the next page if that sibling would not fit and cannot start on this page: a table
+     * splits after its header and a row, and a text after a few lines, and then it stays with that
+     * first part. break-before, break-after and keep-next take effect on the children of layout; on a
+     * box inside another box they are not applied. no applies at any depth.
+     */
+    paginate?: string;
+    debug?: boolean;
+    /**
+     * Width of the element. A length fixes it. fill, in a row, takes the width its line leaves after
+     * the other children, shared equally if several on the line use fill, and never moves to the next
+     * line; in a column it takes the full width.
+     */
+    width?: string;
+    /**
+     * How many columns a tab fills to: it moves the next character to the next multiple of this many
+     * characters from the start of the line. Default 4.
+     */
+    tabSize?: number;
+    /**
+     * The distance between lines, as a factor of the font size: a number above 0, such as 1.5, or a
+     * name from the line-height row of the tokens. Default 1.2, which is the token m.
+     */
+    lineHeight?: string | number;
+    /**
+     * The fewest lines of the code that may stand alone at the top of the next page when it splits.
+     * Default 2. If fewer would be left, lines move from the first page to the next; 1 turns the
+     * protection off.
+     */
+    widows?: number;
+    /**
+     * The fewest lines of the code that may stand alone at the bottom of a page when it splits.
+     * Default 2. If fewer would fit, the whole code moves to the next page; 1 turns the protection
+     * off.
+     */
+    orphans?: number;
 }
 /**
  * Attributes of the `td` element.
@@ -490,7 +772,8 @@ export interface TdAttr {
     /**
      * Space between the edge of the box and its content, written like CSS: one value for all sides,
      * two for top-bottom and left-right, three for top, left-right and bottom, four for top, right,
-     * bottom and left.
+     * bottom and left. Each value is a length or a name from the space row of the tokens, and they
+     * can be mixed: 0pt 0pt 0pt m.
      */
     padding?: string;
     /**
@@ -508,7 +791,7 @@ export interface TdAttr {
      * that overlap do not show through each other, and a box inside a faded box is faded further: 0.5
      * inside 0.5 is drawn at 0.25. A form field in the box is not faded. Default 1.
      */
-    opacity?: string;
+    opacity?: number;
     /**
      * A hard-edged shadow: a copy of the box, moved right and down by the first two lengths (negative
      * is left and up) and filled with the color, drawn under the box with the same radius. An opacity
@@ -522,12 +805,13 @@ export interface TdAttr {
      * Where the box falls in the page flow. no: never split the box, and move it whole to the next
      * page when it does not fit. break-before: start it on a new page. break-after: start the next
      * sibling on a new page. keep-next: keep it on one page with the sibling that follows, moving
-     * both to the next page if that sibling would not fit. break-before, break-after and keep-next
-     * take effect on the children of layout; on a box inside another box they are not applied. no
-     * applies at any depth.
+     * both to the next page if that sibling would not fit and cannot start on this page: a table
+     * splits after its header and a row, and a text after a few lines, and then it stays with that
+     * first part. break-before, break-after and keep-next take effect on the children of layout; on a
+     * box inside another box they are not applied. no applies at any depth.
      */
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
     /**
      * 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
@@ -535,7 +819,7 @@ export interface TdAttr {
      * last columns empty. It changes widths only: row heights and page breaks work as before. Default
      * 1.
      */
-    colspan?: string;
+    colspan?: number;
     /**
      * 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
@@ -545,7 +829,7 @@ export interface TdAttr {
      * 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;
+    rowspan?: number;
     align?: string;
     valign?: string;
 }
@@ -575,11 +859,31 @@ export interface TrAttr {
  */
 export interface TableAttr {
     /**
-     * Column widths, separated by spaces, in fr, pt or % units: for example 2fr 1fr 120pt 20%.
+     * Column widths, separated by spaces, in fr, pt or % units, or auto: for example 2fr 1fr 120pt
+     * 20%. An auto column takes the width its cells need on one line, and the auto columns share what
+     * the pt and % columns leave, in proportion to what they need. When they do not fit, each keeps
+     * at least its longest word, and when not even those fit, the longest are cut and a short column
+     * keeps its width. auto and fr cannot be in one table: use pt or % for the fixed columns. For
+     * example auto 90pt 60pt.
      */
     cols: string;
+    /**
+     * A grid: a line around every cell, as thickness and color, for example 1pt #cccccc.
+     */
     border?: string;
+    /** The background of every other row below the header, or none. */
     stripe?: string;
+    /**
+     * The line under the header row, across the table, as thickness and color like border, or none:
+     * for example xs line.
+     */
+    headBorder?: string;
+    /**
+     * The line under each row, across the table, as thickness and color like border, or none: for
+     * example xs line-muted. Under the header row, head-border takes its place when it is set. A line
+     * stops where a cell spans on into the next row.
+     */
+    rowBorder?: string;
     gap?: string;
     padding?: string;
     background?: string;
@@ -591,7 +895,7 @@ export interface TableAttr {
     width?: string;
     height?: string;
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
 }
 /**
  * Attributes of the `field` element.
@@ -603,10 +907,10 @@ export interface FieldAttr {
     label?: string;
     options?: string;
     group?: string;
-    checked?: string;
-    required?: string;
-    readonly?: string;
-    maxLen?: string;
+    checked?: boolean;
+    required?: boolean;
+    readonly?: boolean;
+    maxLen?: number;
     actionUrl?: string;
     /**
      * Width of the element. A length fixes it. fill, in a row, takes the width its line leaves after
@@ -617,7 +921,7 @@ export interface FieldAttr {
     height?: string;
     background?: string;
     border?: string;
-    debug?: string;
+    debug?: boolean;
 }
 /**
  * An entry of the PDF's outline, the bookmark panel of a viewer, and a target for links with
@@ -632,7 +936,7 @@ export interface BookmarkAttr {
      * Depth in the outline, 1 to 6. Defaults to 1. An entry nests under the closest entry before it
      * with a lower level.
      */
-    level?: string;
+    level?: number;
     /**
      * The name links use to jump here, as href="#id". Leave it out to make it from the label:
      * lowercase, with other characters than letters and digits turned into hyphens, and -2, -3 added
@@ -658,7 +962,296 @@ export interface RegionAttr {
      */
     page?: string;
     w?: string;
-    debug?: string;
+    debug?: boolean;
+}
+/**
+ * Markdown as the content of a section, where a layout would go. It holds only Markdown: optional
+ * markdown-styles, which say how each part of it looks, and one markdown-content, which holds the
+ * text. The page, a header, a footer or a cover are not Markdown, so they stay in the XML: layers
+ * paint a header and a footer in the margin, and a cover or a table of contents is a section of its
+ * own. CommonMark with tables, strikethrough and footnotes, and a $ is text. Raw HTML is for an
+ * HTML output, which a PDF is not, so a tag is left out and the words in it are kept: a block such
+ * as a p or a div puts the words around it on lines of their own. Two tags are read: br breaks a
+ * line, and img shows an image, at its width and height in pixels when it has them, which
+ * Markdown's own image has no way to say. An image at a URL, in Markdown or in an img, is left out,
+ * since an image must be an asset. A heading is a bookmark, so the table of contents and the
+ * outline of the viewer fill themselves.
+ */
+export interface MarkdownAttr {
+    /**
+     * The space between the page edges and the Markdown: one value for all four sides, or two to four
+     * in the order top, right, bottom, left. Defaults to 36pt. A layer draws a header or a footer in
+     * it.
+     */
+    margin?: string;
+    /** The font of the Markdown, which a rule can change. Defaults to the document's. */
+    font?: string;
+    /** The size of the text of the Markdown, which a rule can change. Defaults to 11pt. */
+    fontSize?: string;
+    /**
+     * The color of the text of the Markdown, which a rule can change. Defaults to the text token.
+     */
+    color?: string;
+    /**
+     * The space between the blocks: headings, paragraphs, lists, code, quotes, tables and images.
+     * Default none.
+     */
+    gap?: string;
+    /**
+     * How many levels of headings become bookmarks, for the outline of the viewer and the table of
+     * contents: n keeps the levels 1 to n, 0 none. Default 6.
+     */
+    bookmarks?: number;
+    debug?: boolean;
+}
+/**
+ * How the parts of the Markdown look. A rule is named after the Markdown it styles and takes the
+ * attributes of the element it becomes, so that h1 takes what a text takes. A rule here overrides
+ * the same rule of the file that src names, which overrides the defaults: a style that is not set
+ * stays what it was. Values are the tokens' (font-size="xxl", color="primary") or plain lengths and
+ * colors, and fonts are names from assets. A built-in font needs no rule for italic and bold; an
+ * embedded font names the faces: em font="body-italic", strong font="body-bold".
+ */
+export interface MarkdownStylesAttr {
+    /**
+     * A file of rules, whose root is a markdown-styles. The rules written here override its rules.
+     * The engine reads no files: the SDK, the command line or the extension reads it, as it reads the
+     * src of a font or an image.
+     */
+    src?: string;
+}
+/**
+ * A heading of level 1, written # in Markdown.
+ */
+export interface MarkdownH1Attr {
+    font?: string;
+    fontSize?: string;
+    bold?: boolean;
+    color?: string;
+    align?: string;
+    lineHeight?: string | number;
+    padding?: string;
+    background?: string;
+    border?: string;
+    radius?: string;
+}
+/**
+ * A heading of level 2, written ## in Markdown.
+ */
+export interface MarkdownH2Attr {
+    font?: string;
+    fontSize?: string;
+    bold?: boolean;
+    color?: string;
+    align?: string;
+    lineHeight?: string | number;
+    padding?: string;
+    background?: string;
+    border?: string;
+    radius?: string;
+}
+/**
+ * A heading of level 3, written ### in Markdown.
+ */
+export interface MarkdownH3Attr {
+    font?: string;
+    fontSize?: string;
+    bold?: boolean;
+    color?: string;
+    align?: string;
+    lineHeight?: string | number;
+    padding?: string;
+    background?: string;
+    border?: string;
+    radius?: string;
+}
+/**
+ * A heading of level 4, written #### in Markdown.
+ */
+export interface MarkdownH4Attr {
+    font?: string;
+    fontSize?: string;
+    bold?: boolean;
+    color?: string;
+    align?: string;
+    lineHeight?: string | number;
+    padding?: string;
+    background?: string;
+    border?: string;
+    radius?: string;
+}
+/**
+ * A heading of level 5, written ##### in Markdown.
+ */
+export interface MarkdownH5Attr {
+    font?: string;
+    fontSize?: string;
+    bold?: boolean;
+    color?: string;
+    align?: string;
+    lineHeight?: string | number;
+    padding?: string;
+    background?: string;
+    border?: string;
+    radius?: string;
+}
+/**
+ * A heading of level 6, written ###### in Markdown.
+ */
+export interface MarkdownH6Attr {
+    font?: string;
+    fontSize?: string;
+    bold?: boolean;
+    color?: string;
+    align?: string;
+    lineHeight?: string | number;
+    padding?: string;
+    background?: string;
+    border?: string;
+    radius?: string;
+}
+/**
+ * A paragraph, and the words of a list item, a quote and a footnote.
+ */
+export interface MarkdownPAttr {
+    font?: string;
+    fontSize?: string;
+    bold?: boolean;
+    color?: string;
+    align?: string;
+    lineHeight?: string | number;
+    padding?: string;
+    background?: string;
+    border?: string;
+    radius?: string;
+}
+/**
+ * Code: the box of a fenced or indented block, and the run of inline code, which takes the font,
+ * the color and the background. The language of a fence is ignored, since there is no highlighting
+ * by language.
+ */
+export interface MarkdownCodeAttr {
+    font?: string;
+    fontSize?: string;
+    color?: string;
+    lineHeight?: string | number;
+    padding?: string;
+    background?: string;
+    border?: string;
+    radius?: string;
+    tabSize?: number;
+}
+/**
+ * A block quote, written > in Markdown: a bar beside its content. font, font-size, color,
+ * line-height and align set the words; padding, background, border and radius the box around the
+ * bar and the words; bar-color and bar-width the bar, a strip along the left of the box: bar-width
+ * is a length or a name from the space row of the tokens.
+ */
+export interface MarkdownQuoteAttr {
+    font?: string;
+    fontSize?: string;
+    bold?: boolean;
+    color?: string;
+    align?: string;
+    lineHeight?: string | number;
+    padding?: string;
+    background?: string;
+    border?: string;
+    radius?: string;
+    barColor?: string;
+    barWidth?: string;
+}
+/**
+ * An item of a bullet or a numbered list. indent is the width of the marker's column and bullet the
+ * shape of a bullet list's marker, as on a list; gap goes between the blocks of an item.
+ */
+export interface MarkdownLiAttr {
+    font?: string;
+    fontSize?: string;
+    color?: string;
+    gap?: string;
+    padding?: string;
+    background?: string;
+    border?: string;
+    indent?: string;
+    bullet?: string;
+}
+/**
+ * A link, written [text](url) in Markdown.
+ */
+export interface MarkdownAAttr {
+    font?: string;
+    color?: string;
+    bold?: boolean;
+    underline?: boolean;
+}
+/**
+ * Strong text, written **text** in Markdown. Bold in a built-in font; an embedded font names its
+ * bold face in font.
+ */
+export interface MarkdownStrongAttr {
+    font?: string;
+    color?: string;
+    bold?: boolean;
+}
+/**
+ * Emphasis, written *text* in Markdown. Italic in a built-in font; an embedded font names its
+ * italic face in font.
+ */
+export interface MarkdownEmAttr {
+    font?: string;
+    color?: string;
+}
+/**
+ * Struck-through text, written ~~text~~ in Markdown.
+ */
+export interface MarkdownDelAttr {
+    font?: string;
+    color?: string;
+    strike?: boolean;
+}
+/**
+ * A table. Its columns are sized by their content: a column takes the width its cells need on one
+ * line, the room that is left is shared in proportion, and a name that does not fit breaks at the
+ * edge of its cell. stripe is the color of every other row, or none; head-border is the line under
+ * the header row and row-border the line under each of the other rows, as thickness and color like
+ * border, or none. The default styles draw a line in line-muted under the header and under each
+ * row, with no stripe.
+ */
+export interface MarkdownTableAttr {
+    border?: string;
+    stripe?: string;
+    headBorder?: string;
+    rowBorder?: string;
+    gap?: string;
+    padding?: string;
+    background?: string;
+}
+/**
+ * A cell of a table's header row.
+ */
+export interface MarkdownThAttr {
+    font?: string;
+    fontSize?: string;
+    bold?: boolean;
+    color?: string;
+    align?: string;
+    padding?: string;
+    background?: string;
+    border?: string;
+}
+/**
+ * A cell of a table's other rows.
+ */
+export interface MarkdownTdAttr {
+    font?: string;
+    fontSize?: string;
+    bold?: boolean;
+    color?: string;
+    align?: string;
+    padding?: string;
+    background?: string;
+    border?: string;
 }
 /**
  * Draws shapes, text, images and barcodes at exact positions on the page, independent of the
@@ -674,7 +1267,7 @@ export interface LayerAttr {
      * How opaque everything in the layer is, from 0 to 1. To fade one element, put it in a layer of
      * its own.
      */
-    opacity?: string;
+    opacity?: number;
     transform?: string;
     /**
      * A rectangle that cuts off what the layer draws outside it: x y w h, in points from the top left
@@ -822,28 +1415,28 @@ export interface TextAtAttr {
      * Helvetica-Bold, Times-Roman becomes Times-Bold, Courier becomes Courier-Bold, and the oblique
      * and italic faces their bold forms. A custom font has no bold face to pick, so name one in font.
      */
-    bold?: string;
+    bold?: boolean;
     color?: string;
     align?: string;
     /**
      * The distance between lines, as a factor of the font size: a number above 0, such as 1.5, or a
      * name from the line-height row of the tokens. Default 1.2, which is the token m.
      */
-    lineHeight?: string;
+    lineHeight?: string | number;
     /**
      * The most lines drawn. Only whole lines are drawn, and the rest of the text is dropped. A text
      * in the layout has no cap by default and wraps at the width it has; the lines it drops take no
      * room, and a text that splits across pages keeps the cap across them. A text-at is one line by
      * default, and above 1 needs a width to wrap within.
      */
-    maxLines?: string;
+    maxLines?: number;
     /**
      * End the last line drawn in an ellipsis when max-lines drops text, shortened to fit the width.
      * Off by default: the text stops at the end of a line. A text-at also ends a line in one when it
      * is cut off at its width. A text in the layout without max-lines is never cut, so there it has
      * no effect.
      */
-    ellipsis?: string;
+    ellipsis?: boolean;
     /**
      * Width of the box. Without it the text is one line of the width its characters need, and align
      * has no effect; a long text runs on past the edge of the page, which cuts it off, but stays in
@@ -888,7 +1481,7 @@ export interface BarcodeAtAttr {
      */
     height?: string;
     ec?: string;
-    hrt?: string;
+    hrt?: boolean;
     color?: string;
     background?: string;
     x?: string;
@@ -945,3 +1538,78 @@ export interface ImageAttr {
      */
     src?: string;
 }
+/**
+ * A file the PDF carries, under the name a reader shows. The SDK reads it from src, or it was
+ * loaded on the engine under ref or, with no ref, under its own name. A file with no bytes is an
+ * error, and so are two files with the same name.
+ */
+export interface FileAttr {
+    /**
+     * The name a reader shows the file under and saves it as, such as invoice.xml. Each file of the
+     * document has a name of its own.
+     */
+    name: string;
+    /** A path the SDK reads the file from, when the file was not loaded on the engine. */
+    src?: string;
+    /** The key the file was loaded under on the engine, when that is not its name. */
+    ref?: string;
+    /**
+     * The type of the file, such as text/xml, application/pdf or text/csv. Defaults to
+     * application/octet-stream, which says only that it is a file.
+     */
+    mime?: string;
+    /**
+     * How the file relates to the document: source, data, alternative, supplement or unspecified, the
+     * default. An e-invoice's XML is data.
+     */
+    relationship?: string;
+    /** A line about the file, which a reader shows beside its name. */
+    description?: string;
+}
+/**
+ * One color of a gradient, at an offset along it.
+ */
+export interface GradientStop {
+    /**
+     * Where the color is reached along the gradient, from 0% (the start) to 100% (the end). Stops go
+     * in increasing order.
+     */
+    offset: string;
+    /**
+     * The color at the stop: hex, cmyk(), rgb(), hsl() or a color token. The stops of a gradient are
+     * all CMYK or all RGB.
+     */
+    color: string;
+}
+/**
+ * A named blend of colors. A background or a fill uses it as gradient:name, and the blend spans the
+ * box it fills. Give from and to for two colors, or stop children for more.
+ */
+export interface GradientToken {
+    /**
+     * linear runs along a line across the box. radial runs from the center out to the farthest
+     * corner.
+     */
+    type: 'linear' | 'radial';
+    /**
+     * The first color: hex, cmyk(), rgb(), hsl() or a color token, CMYK if to is and RGB if it is
+     * not. Used with to, when there are no stop children. For a radial gradient it is the center.
+     */
+    from?: string;
+    /**
+     * The last color: hex, cmyk(), rgb(), hsl() or a color token. Used with from, when there are no
+     * stop children. For a radial gradient it is the edge.
+     */
+    to?: string;
+    /**
+     * The direction of a linear gradient, in degrees: 0 runs from the top to the bottom, 90 from the
+     * left to the right, 180 from the bottom to the top. Default 0. A radial gradient has no
+     * direction.
+     */
+    angle?: number;
+    /**
+     * The colors of the gradient, for more than two: each at an offset, in increasing order. Give
+     * these, or from and to.
+     */
+    stops?: GradientStop[];
+}