@lpdfio/lpdf 0.30.0 → 0.32.0

package/dist/attrs.d.ts

@@ -34,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
@@ -54,7 +54,20 @@ export interface ColumnAttr {
      * box inside another box they are not applied. no applies at any depth.
      */
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
     align?: string;
     justify?: string;
     /**
@@ -102,7 +115,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
@@ -122,7 +135,20 @@ export interface RowAttr {
      * box inside another box they are not applied. no applies at any depth.
      */
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
     align?: string;
     justify?: string;
     /**
@@ -168,7 +194,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
@@ -188,7 +214,20 @@ export interface GridAttr {
      * box inside another box they are not applied. no applies at any depth.
      */
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: 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
@@ -196,7 +235,7 @@ 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
@@ -236,7 +275,7 @@ export interface ListAttr {
      * 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
@@ -256,7 +295,20 @@ export interface ListAttr {
      * box inside another box they are not applied. no applies at any depth.
      */
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
     /** bullet marks each item with a shape, number with a number. Default bullet. */
     type?: string;
     /**
@@ -270,7 +322,7 @@ export interface ListAttr {
      * The number of a number list's first item, to continue a list that something cut in two. Default
      * 1.
      */
-    start?: string;
+    start?: number;
     /**
      * Text before each number of a number list: prefix="(" and suffix=")" write (a). Default none.
      */
@@ -338,7 +390,7 @@ export interface LiAttr {
      * 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
@@ -358,7 +410,20 @@ export interface LiAttr {
      * box inside another box they are not applied. no applies at any depth.
      */
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
     /**
      * 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
@@ -366,7 +431,7 @@ export interface LiAttr {
      * number. An item without it keeps its bullet or number. A task item of a Markdown, - [ ] or -
      * [x], is one.
      */
-    checked?: string;
+    checked?: boolean;
 }
 /**
  * A box around a single child, which it centres. Never splits across pages: if it does not fit, the
@@ -403,7 +468,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
@@ -423,7 +488,20 @@ export interface FrameAttr {
      * box inside another box they are not applied. no applies at any depth.
      */
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: 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
@@ -448,7 +526,20 @@ export interface LinkAttr {
      */
     width?: string;
     height?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * Attributes of the `divider` element.
@@ -463,22 +554,46 @@ export interface DividerAttr {
      * line; in a column it takes the full width.
      */
     width?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * 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;
+    /**
+     * Makes the span a cross-reference to the bookmark with this id: a link to it whose words say
+     * where it is. In the span's words, {bookmark-page} prints the page the bookmark is on, as the
+     * footer of that page prints it, and {bookmark-label} the bookmark's label, so "{bookmark-label},
+     * on page {bookmark-page}" shows "clause 4, on page 12". An id that no bookmark has, another {…}
+     * token in the words, and href beside it are errors. It works in a text, a footnote, a region, a
+     * text-at and a code. The document is laid out again until each reference shows the page its
+     * bookmark lands on, and a reference keeps room for the widest words it has shown, so a number
+     * that got narrower can leave a small gap after it.
+     */
+    bookmarkRef?: 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
@@ -501,6 +616,12 @@ export interface CodeSpanAttr {
  */
 export interface ImgAttr {
     name: string;
+    /**
+     * What the image shows, which a screen reader reads in a PDF/UA document; alt="" marks it as
+     * decoration, which a reader skips. A PDF/UA document needs it on every image of the layout. A
+     * document without pdfua ignores it.
+     */
+    alt?: string;
     height?: string;
     /**
      * Width of the element. A length fixes it. fill, in a row, takes the width its line leaves after
@@ -516,7 +637,20 @@ export interface ImgAttr {
     border?: string;
     radius?: string;
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * A rectangle, a circle or an ellipse in the layout, for a status dot, a color swatch or a progress
@@ -547,8 +681,21 @@ 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;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * A QR code, a Code 128 or an EAN-13. It is never stretched. With only a width or a height, the
@@ -571,7 +718,7 @@ export interface BarcodeAttr {
      */
     height?: string;
     ec?: string;
-    hrt?: string;
+    hrt?: boolean;
     color?: string;
     background?: string;
     /**
@@ -580,8 +727,27 @@ export interface BarcodeAttr {
      * line; in a column it takes the full width.
      */
     width?: string;
+    /**
+     * What the barcode is for, which a screen reader reads in a PDF/UA document in place of its data,
+     * which means nothing read aloud: "QR code to pay this invoice". alt="" marks it as decoration. A
+     * PDF/UA document needs it on every barcode of the layout. A document without pdfua ignores it.
+     */
+    alt?: string;
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * A block of wrapping text. Use span children to style parts of it, and fn children for footnotes.
@@ -595,47 +761,54 @@ 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
      * line; in a column it takes the full width.
      */
     width?: string;
+    /**
+     * Makes the text a heading, h1 to h6, which a PDF/UA document tags as one: a screen reader lists
+     * the headings and moves between them. A text without role is a paragraph. A PDF/UA document's
+     * headings start at h1 and go down one level at a time. It changes nothing a page shows: set the
+     * size and the weight as on any text. A document without pdfua ignores it.
+     */
+    role?: string;
     /**
      * The fewest lines of the text 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?: 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
@@ -662,7 +835,20 @@ export interface TextAttr {
      */
     captureFallback?: string;
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * Code, or any text whose spaces and lines matter, in a box. The text is kept as it is written:
@@ -706,7 +892,7 @@ export interface CodeAttr {
      * 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
@@ -726,7 +912,20 @@ export interface CodeAttr {
      * box inside another box they are not applied. no applies at any depth.
      */
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: 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
@@ -737,24 +936,24 @@ export interface CodeAttr {
      * 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?: string;
+    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;
+    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?: string;
+    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?: string;
+    orphans?: number;
 }
 /**
  * Attributes of the `td` element.
@@ -791,7 +990,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
@@ -811,7 +1010,20 @@ export interface TdAttr {
      * box inside another box they are not applied. no applies at any depth.
      */
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: 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
@@ -819,7 +1031,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
@@ -829,7 +1041,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;
 }
@@ -838,6 +1050,19 @@ export interface TdAttr {
  */
 export interface TheadAttr {
     background?: string;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * Attributes of the `tr` element.
@@ -852,6 +1077,19 @@ export interface TrAttr {
      */
     keep?: string;
     background?: string;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * Rows and cells in columns whose widths are set by cols. The thead row repeats at the top of every
@@ -895,7 +1133,20 @@ export interface TableAttr {
     width?: string;
     height?: string;
     paginate?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * Attributes of the `field` element.
@@ -907,10 +1158,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
@@ -921,13 +1172,26 @@ export interface FieldAttr {
     height?: string;
     background?: string;
     border?: string;
-    debug?: string;
+    debug?: boolean;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * An entry of the PDF's outline, the bookmark panel of a viewer, and a target for links with
- * href="#id". It draws nothing and marks the element that follows it, so it is never left at the
- * bottom of a page apart from that element. Directly inside a section, it marks the section's first
- * page.
+ * href="#id" and for cross-references with bookmark-ref. It draws nothing and marks the element
+ * that follows it, so it is never left at the bottom of a page apart from that element. Directly
+ * inside a section, it marks the section's first page.
  */
 export interface BookmarkAttr {
     /** The text of the entry, in the outline and in a table of contents. */
@@ -936,13 +1200,21 @@ 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
-     * when an earlier bookmark has it. Two bookmarks may not have the same id.
+     * The name links use to jump here, as href="#id", and cross-references as bookmark-ref="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 when an earlier bookmark has it. Two bookmarks may
+     * not have the same id.
      */
     id?: string;
+    /**
+     * true leaves the bookmark out of the viewer's outline and out of the table of contents, for a
+     * figure or a table: label="Table 3" ref-only="true". Links with href="#id" and cross-references
+     * with bookmark-ref still reach it, and {bookmark-label} still shows its label. Defaults to
+     * false.
+     */
+    refOnly?: boolean;
 }
 /**
  * Pins content to the top or bottom edge of pages, outside the normal flow, for headers and
@@ -962,7 +1234,7 @@ 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
@@ -1001,8 +1273,8 @@ export interface MarkdownAttr {
      * 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?: string;
-    debug?: string;
+    bookmarks?: number;
+    debug?: boolean;
 }
 /**
  * How the parts of the Markdown look. A rule is named after the Markdown it styles and takes the
@@ -1026,10 +1298,10 @@ export interface MarkdownStylesAttr {
 export interface MarkdownH1Attr {
     font?: string;
     fontSize?: string;
-    bold?: string;
+    bold?: boolean;
     color?: string;
     align?: string;
-    lineHeight?: string;
+    lineHeight?: string | number;
     padding?: string;
     background?: string;
     border?: string;
@@ -1041,10 +1313,10 @@ export interface MarkdownH1Attr {
 export interface MarkdownH2Attr {
     font?: string;
     fontSize?: string;
-    bold?: string;
+    bold?: boolean;
     color?: string;
     align?: string;
-    lineHeight?: string;
+    lineHeight?: string | number;
     padding?: string;
     background?: string;
     border?: string;
@@ -1056,10 +1328,10 @@ export interface MarkdownH2Attr {
 export interface MarkdownH3Attr {
     font?: string;
     fontSize?: string;
-    bold?: string;
+    bold?: boolean;
     color?: string;
     align?: string;
-    lineHeight?: string;
+    lineHeight?: string | number;
     padding?: string;
     background?: string;
     border?: string;
@@ -1071,10 +1343,10 @@ export interface MarkdownH3Attr {
 export interface MarkdownH4Attr {
     font?: string;
     fontSize?: string;
-    bold?: string;
+    bold?: boolean;
     color?: string;
     align?: string;
-    lineHeight?: string;
+    lineHeight?: string | number;
     padding?: string;
     background?: string;
     border?: string;
@@ -1086,10 +1358,10 @@ export interface MarkdownH4Attr {
 export interface MarkdownH5Attr {
     font?: string;
     fontSize?: string;
-    bold?: string;
+    bold?: boolean;
     color?: string;
     align?: string;
-    lineHeight?: string;
+    lineHeight?: string | number;
     padding?: string;
     background?: string;
     border?: string;
@@ -1101,10 +1373,10 @@ export interface MarkdownH5Attr {
 export interface MarkdownH6Attr {
     font?: string;
     fontSize?: string;
-    bold?: string;
+    bold?: boolean;
     color?: string;
     align?: string;
-    lineHeight?: string;
+    lineHeight?: string | number;
     padding?: string;
     background?: string;
     border?: string;
@@ -1116,10 +1388,10 @@ export interface MarkdownH6Attr {
 export interface MarkdownPAttr {
     font?: string;
     fontSize?: string;
-    bold?: string;
+    bold?: boolean;
     color?: string;
     align?: string;
-    lineHeight?: string;
+    lineHeight?: string | number;
     padding?: string;
     background?: string;
     border?: string;
@@ -1134,12 +1406,12 @@ export interface MarkdownCodeAttr {
     font?: string;
     fontSize?: string;
     color?: string;
-    lineHeight?: string;
+    lineHeight?: string | number;
     padding?: string;
     background?: string;
     border?: string;
     radius?: string;
-    tabSize?: string;
+    tabSize?: number;
 }
 /**
  * A block quote, written > in Markdown: a bar beside its content. font, font-size, color,
@@ -1150,10 +1422,10 @@ export interface MarkdownCodeAttr {
 export interface MarkdownQuoteAttr {
     font?: string;
     fontSize?: string;
-    bold?: string;
+    bold?: boolean;
     color?: string;
     align?: string;
-    lineHeight?: string;
+    lineHeight?: string | number;
     padding?: string;
     background?: string;
     border?: string;
@@ -1182,8 +1454,8 @@ export interface MarkdownLiAttr {
 export interface MarkdownAAttr {
     font?: string;
     color?: string;
-    bold?: string;
-    underline?: string;
+    bold?: boolean;
+    underline?: boolean;
 }
 /**
  * Strong text, written **text** in Markdown. Bold in a built-in font; an embedded font names its
@@ -1192,7 +1464,7 @@ export interface MarkdownAAttr {
 export interface MarkdownStrongAttr {
     font?: string;
     color?: string;
-    bold?: string;
+    bold?: boolean;
 }
 /**
  * Emphasis, written *text* in Markdown. Italic in a built-in font; an embedded font names its
@@ -1208,7 +1480,7 @@ export interface MarkdownEmAttr {
 export interface MarkdownDelAttr {
     font?: string;
     color?: string;
-    strike?: string;
+    strike?: boolean;
 }
 /**
  * A table. Its columns are sized by their content: a column takes the width its cells need on one
@@ -1233,7 +1505,7 @@ export interface MarkdownTableAttr {
 export interface MarkdownThAttr {
     font?: string;
     fontSize?: string;
-    bold?: string;
+    bold?: boolean;
     color?: string;
     align?: string;
     padding?: string;
@@ -1246,7 +1518,7 @@ export interface MarkdownThAttr {
 export interface MarkdownTdAttr {
     font?: string;
     fontSize?: string;
-    bold?: string;
+    bold?: boolean;
     color?: string;
     align?: string;
     padding?: string;
@@ -1267,7 +1539,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
@@ -1287,6 +1559,26 @@ export interface LayerAttr {
      * The color of the text-at in the layer that sets none of its own. Defaults to the text token.
      */
     color?: string;
+    /**
+     * In a PDF/UA document, what the layer shows, which a screen reader reads as one figure at the
+     * layer's place in the document: a layer before the layout before it, one after the layout after
+     * it. Without alt a layer is decoration, as a header is, and a screen reader skips it with all
+     * its text: a watermark, a running title, a logo's letters. A document without pdfua ignores it.
+     */
+    alt?: string;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * Attributes of the `rect` element in a layer.
@@ -1309,6 +1601,19 @@ export interface RectAttr {
      * with no fill shows the shadow only outside it.
      */
     shadow?: string;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * Attributes of the `circle` element in a layer.
@@ -1339,6 +1644,19 @@ export interface CircleAttr {
      * with no fill shows the shadow only outside it.
      */
     shadow?: string;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * Attributes of the `ellipse` element in a layer.
@@ -1370,6 +1688,19 @@ export interface EllipseAttr {
      * with no fill shows the shadow only outside it.
      */
     shadow?: string;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * Attributes of the `line` element in a layer.
@@ -1383,6 +1714,19 @@ export interface LineAttr {
     strokeWidth?: string;
     strokeDash?: string;
     lineCap?: string;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * Attributes of the `path` element in a layer.
@@ -1395,13 +1739,27 @@ export interface PathAttr {
     strokeWidth?: string;
     strokeDash?: string;
     lineCap?: string;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * Text at a fixed place on the page. It is the text of the layout, with the same defaults: the
  * document's font or Helvetica, 11pt and the text colour. It is one line unless told otherwise;
  * give width to cut it off at a width or to wrap it with max-lines. x and y place its box: the
  * top-left corner, or with anchor, an offset from that point of the page, where the box's matching
- * point goes. {page} and {pages} in it count within the section, and a text that comes from data
+ * point goes. {page} in it prints the page's number and {pages} how many pages its run has, as its
+ * section's page-start, page-format and page-prefix number them, and a text that comes from data
  * belongs in the layout, since a longer text loses its end here without a warning.
  */
 export interface TextAtAttr {
@@ -1415,28 +1773,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
@@ -1444,6 +1802,19 @@ export interface TextAtAttr {
      * and max-lines above 1 wraps the text within it.
      */
     width?: string;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * An image at a fixed place on the page. It needs width or height, and the other follows the
@@ -1459,6 +1830,19 @@ export interface ImgAtAttr {
     anchor?: string;
     width?: string;
     height?: string;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * A barcode at a fixed place on the page. It needs width or height, and the other follows the
@@ -1481,13 +1865,26 @@ export interface BarcodeAtAttr {
      */
     height?: string;
     ec?: string;
-    hrt?: string;
+    hrt?: boolean;
     color?: string;
     background?: string;
     x?: string;
     y?: string;
     anchor?: string;
     width?: string;
+    /**
+     * Puts the element, and everything in it, in an optional content group, which the viewer shows or
+     * hides. print: printed, and not shown on screen. screen: shown on screen, and not printed. The
+     * element keeps its room either way, so nothing moves. An element with a group inside an element
+     * with another shows only where both show. Acrobat, Chrome and Firefox switch the groups; Preview
+     * and Safari show everything, on screen and in print. Hidden content is still in the file, where
+     * it can be selected and copied: it is not a way to keep anything secret. A link in print content
+     * is drawn and does nothing, and a form field can't be in print content: use a frame with a
+     * border for a box filled in by hand. With pdfa or pdfua on the output, everything shows. With
+     * pdfx, the file is the print version: screen content stays in it, off, and a reader can turn it
+     * on in a layers panel.
+     */
+    ocg?: string;
 }
 /**
  * The flowing content of a section. Elements stack down the page, and a new page starts when one
@@ -1538,3 +1935,97 @@ 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;
+}
+/**
+ * Declares an ICC color profile that the profile attribute of output names: the profile of the
+ * printing press a PDF/X file is made for, which the printer gives out. The SDK reads the file from
+ * src, or the profile was loaded on the engine under ref or, with no ref, under its own name. The
+ * engine bundles no press profile.
+ */
+export interface ProfileAttr {
+    /**
+     * The name that the profile attribute of output uses to pick this profile: lowercase letters,
+     * digits and -, starting with a letter.
+     */
+    name: string;
+    /** The key the profile was loaded under on the engine, when that is not its name. */
+    ref?: string;
+    /**
+     * A path the SDK reads the ICC profile from, when the profile was not loaded on the engine.
+     */
+    src?: 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[];
+}