@lpdfio/lpdf 0.31.0 → 0.32.0

package/dist/_shared.d.ts

@@ -9,7 +9,7 @@ export interface RenderOptions {
      * Optional ISO 8601 creation timestamp (e.g. `"2024-06-01T12:00:00"`).
      * When provided, written as `/CreationDate` in the PDF info dictionary.
      * Omitting this keeps builds reproducible (no embedded timestamp).
-     * Required for a document whose `output` asks for `pdfa`, which writes it as both dates of the file.
+     * Required for a document whose `output` asks for `pdfa`, `pdfua` or `pdfx`, which writes it as both dates of the file.
      */
     createdOn?: string;
     /**

package/dist/attrs.d.ts

@@ -55,6 +55,19 @@ export interface ColumnAttr {
      */
     paginate?: 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;
     /**
@@ -123,6 +136,19 @@ export interface RowAttr {
      */
     paginate?: 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;
     /**
@@ -189,6 +215,19 @@ export interface GridAttr {
      */
     paginate?: 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
@@ -257,6 +296,19 @@ export interface ListAttr {
      */
     paginate?: 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;
     /**
@@ -359,6 +411,19 @@ export interface LiAttr {
      */
     paginate?: 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
@@ -424,6 +489,19 @@ export interface FrameAttr {
      */
     paginate?: 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
@@ -449,6 +527,19 @@ export interface LinkAttr {
     width?: string;
     height?: 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.
@@ -464,6 +555,19 @@ export interface DividerAttr {
      */
     width?: 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.
@@ -477,6 +581,17 @@ export interface SpanAttr {
      * table of contents, # alone jumps to that entry's bookmark.
      */
     href?: 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;
 }
@@ -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
@@ -517,6 +638,19 @@ export interface ImgAttr {
     radius?: string;
     paginate?: 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
@@ -549,6 +683,19 @@ export interface ShapeAttr {
     /** How opaque the shape is, from 0 to 1. Default 1. */
     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
@@ -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?: 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.
@@ -623,6 +789,13 @@ export interface TextAttr {
      * 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
@@ -663,6 +836,19 @@ export interface TextAttr {
     captureFallback?: string;
     paginate?: 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:
@@ -727,6 +913,19 @@ export interface CodeAttr {
      */
     paginate?: 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
@@ -812,6 +1011,19 @@ export interface TdAttr {
      */
     paginate?: 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
@@ -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
@@ -896,6 +1134,19 @@ export interface TableAttr {
     height?: string;
     paginate?: 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.
@@ -922,12 +1173,25 @@ export interface FieldAttr {
     background?: string;
     border?: 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. */
@@ -938,11 +1202,19 @@ export interface BookmarkAttr {
      */
     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
@@ -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 {
@@ -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
@@ -1488,6 +1872,19 @@ export interface BarcodeAtAttr {
     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
@@ -1566,6 +1963,25 @@ export interface FileAttr {
     /** 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.
  */

package/dist/browser.js

@@ -66,6 +66,19 @@ var LpdfEngine = class {
     const len1 = WASM_VECTOR_LEN;
     wasm.lpdfengine_load_markdown_styles(this.__wbg_ptr, ptr0, len0, ptr1, len1);
   }
+  /**
+   * Register the bytes of an ICC colour profile, for the `<profile>` of a document's `<assets>` whose `ref`, or with
+   * no ref whose name, is `name`: the press profile a PDF/X document names in `<output profile>`.
+   * @param {string} name
+   * @param {Uint8Array} bytes
+   */
+  load_profile(name, bytes) {
+    const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+    const len1 = WASM_VECTOR_LEN;
+    wasm.lpdfengine_load_profile(this.__wbg_ptr, ptr0, len0, ptr1, len1);
+  }
   /**
    * @param {string} license_key
    */
@@ -517,6 +530,7 @@ async function initLpdf(wasmSource, licenseKey = "") {
   const fontMap = /* @__PURE__ */ new Map();
   const imageMap = /* @__PURE__ */ new Map();
   const fileMap = /* @__PURE__ */ new Map();
+  const profileMap = /* @__PURE__ */ new Map();
   const markdownStyles = /* @__PURE__ */ new Map();
   return {
     loadFont(name, bytes) {
@@ -528,6 +542,9 @@ async function initLpdf(wasmSource, licenseKey = "") {
     loadFile(name, bytes) {
       fileMap.set(name, bytes);
     },
+    loadProfile(name, bytes) {
+      profileMap.set(name, bytes);
+    },
     loadMarkdownStyles(src, text) {
       markdownStyles.set(src, text);
     },
@@ -546,6 +563,9 @@ async function initLpdf(wasmSource, licenseKey = "") {
       for (const [name, bytes] of fileMap) {
         engine.load_file(name, bytes);
       }
+      for (const [name, bytes] of profileMap) {
+        engine.load_profile(name, bytes);
+      }
       for (const [src, text] of markdownStyles) {
         engine.load_markdown_styles(src, text);
       }

package/dist/engine.d.ts

@@ -31,6 +31,7 @@ export declare class PdfEngine {
     private readonly _fonts;
     private readonly _images;
     private readonly _files;
+    private readonly _profiles;
     private readonly _markdownStyles;
     private _disposed;
     constructor();
@@ -65,6 +66,12 @@ export declare class PdfEngine {
      * no ref whose name, is `name`. The PDF carries them as they are. Call before `render`. Returns `this` for chaining.
      */
     loadFile(name: string, bytes: Uint8Array): this;
+    /**
+     * Register the bytes of an ICC color profile, for the `<profile>` of the document's `<assets>` whose `ref`, or with
+     * no ref whose name, is `name`: the press profile a PDF/X document names in its output. Call before `render`.
+     * Returns `this` for chaining.
+     */
+    loadProfile(name: string, bytes: Uint8Array): this;
     /**
      * Register the text of a file of Markdown rules, the root of which is a `<markdown-styles>`, for the `src` that
      * names it, as `<markdown-styles src="…">` does. Call before `render`. Returns `this` for chaining.
@@ -86,6 +93,11 @@ export declare class PdfEngine {
      * that wasn't. A `src` that can't be read is an error that names the file and the path.
      */
     private _loadFiles;
+    /**
+     * Hand the engine the color profiles the document declares: the ones loaded here, and the ones read from the `src`
+     * of a profile that wasn't. A `src` that can't be read is an error that names the profile and the path.
+     */
+    private _loadProfiles;
     private _throwIfDisposed;
     /**
      * Render an lpdf XML string to PDF bytes (Node.js).

package/dist/engine.js

@@ -40,6 +40,7 @@ class PdfEngine {
         this._fonts = new Map();
         this._images = new Map();
         this._files = new Map();
+        this._profiles = new Map();
         this._markdownStyles = new Map();
         this._disposed = false;
     }
@@ -93,6 +94,16 @@ class PdfEngine {
         this._files.set(name, bytes);
         return this;
     }
+    /**
+     * Register the bytes of an ICC color profile, for the `<profile>` of the document's `<assets>` whose `ref`, or with
+     * no ref whose name, is `name`: the press profile a PDF/X document names in its output. Call before `render`.
+     * Returns `this` for chaining.
+     */
+    loadProfile(name, bytes) {
+        this._throwIfDisposed();
+        this._profiles.set(name, bytes);
+        return this;
+    }
     /**
      * Register the text of a file of Markdown rules, the root of which is a `<markdown-styles>`, for the `src` that
      * names it, as `<markdown-styles src="…">` does. Call before `render`. Returns `this` for chaining.
@@ -148,6 +159,26 @@ class PdfEngine {
             engine.load_file(key, bytes);
         }
     }
+    /**
+     * Hand the engine the color profiles the document declares: the ones loaded here, and the ones read from the `src`
+     * of a profile that wasn't. A `src` that can't be read is an error that names the profile and the path.
+     */
+    _loadProfiles(engine, srcs) {
+        const profiles = new Map(this._profiles);
+        for (const [key, src] of srcs) {
+            if (profiles.has(key))
+                continue;
+            try {
+                profiles.set(key, (0, node_fs_1.readFileSync)(src));
+            }
+            catch (e) {
+                throw new LpdfRenderError(`profile '${key}' of <assets>: cannot read its src '${src}': ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+        for (const [key, bytes] of profiles) {
+            engine.load_profile(key, bytes);
+        }
+    }
     _throwIfDisposed() {
         if (this._disposed)
             throw new Error('PdfEngine has been disposed.');
@@ -183,6 +214,7 @@ class PdfEngine {
                 }
                 this._loadMarkdownStyles(engine, markdownStylesSrcs(xml));
                 this._loadFiles(engine, extractAssetSrcs(xml, 'file'));
+                this._loadProfiles(engine, extractAssetSrcs(xml, 'profile'));
                 // Auto-load images declared via <image src="…"> that weren't pre-loaded.
                 for (const [key, src] of extractAssetSrcs(xml, 'image')) {
                     if (!this._images.has(key)) {
@@ -225,6 +257,7 @@ class PdfEngine {
                 }
                 this._loadMarkdownStyles(engine, markdownStylesSrcsOfDocument(input));
                 this._loadFiles(engine, fileSrcsOfDocument(input));
+                this._loadProfiles(engine, assetSrcsOfDocument(input, 'profiles'));
                 pdf = engine.render_tree_pdf(json, ...(0, _shared_1.encryptionArguments)(callOptions, secureRandomBytes));
             }
         }
@@ -269,7 +302,7 @@ function xmlElements(xml, tag) {
     }
     return elements;
 }
-/** The `ref ?? name → src` pairs of the `<font>`, `<image>` or `<file>` elements in XML. */
+/** The `ref ?? name → src` pairs of the `<font>`, `<image>`, `<file>` or `<profile>` elements in XML. */
 function extractAssetSrcs(xml, tag) {
     const result = new Map();
     for (const attributes of xmlElements(xml, tag)) {
@@ -315,7 +348,7 @@ function fileSrcsOfDocument(document) {
     }
     return result;
 }
-/** The `ref ?? name → src` pairs of the fonts or images a document declares in `attrs.assets`. */
+/** The `ref ?? name → src` pairs of the fonts, images or color profiles a document declares in `attrs.assets`. */
 function assetSrcsOfDocument(document, kind) {
     const result = new Map();
     const declared = document.attrs['assets']?.[kind] ?? [];

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { PdfEngine, LpdfRenderError } from './engine';
 export type { RenderOptions, EngineOptions } from './_shared';
 export { FieldType, Pin, Orientation, SectionType, FootnoteCounter, Cipher, Permission, FileRelationship, BuiltinFont, PageScope, } from './constants';
 export type { PdfDocument, LpdfSectionNode, LpdfSectionChild, LpdfLayoutBlock, DocumentTokens, TokenSlot, TokenRow, DocumentAssets, DocumentMeta, DocumentOutput, SectionAttr, DocumentAttr, } from './kit';
-export type { ColumnAttr, RowAttr, GridAttr, ListAttr, LiAttr, FrameAttr, LinkAttr, TableAttr, TheadAttr, TrAttr, TdAttr, TextAttr, CodeAttr, SpanAttr, CodeSpanAttr, DividerAttr, ImgAttr, ShapeAttr, BarcodeAttr, RegionAttr, FieldAttr, BookmarkAttr, LayerAttr, RectAttr, CircleAttr, EllipseAttr, LineAttr, PathAttr, TextAtAttr, ImgAtAttr, BarcodeAtAttr, FontAttr, ImageAttr, FileAttr, LayoutAttr, GradientToken, GradientStop, MarkdownAttr, MarkdownStylesAttr, MarkdownH1Attr, MarkdownH2Attr, MarkdownH3Attr, MarkdownH4Attr, MarkdownH5Attr, MarkdownH6Attr, MarkdownPAttr, MarkdownCodeAttr, MarkdownQuoteAttr, MarkdownLiAttr, MarkdownAAttr, MarkdownStrongAttr, MarkdownEmAttr, MarkdownDelAttr, MarkdownTableAttr, MarkdownThAttr, MarkdownTdAttr, } from './attrs';
+export type { ColumnAttr, RowAttr, GridAttr, ListAttr, LiAttr, FrameAttr, LinkAttr, TableAttr, TheadAttr, TrAttr, TdAttr, TextAttr, CodeAttr, SpanAttr, CodeSpanAttr, DividerAttr, ImgAttr, ShapeAttr, BarcodeAttr, RegionAttr, FieldAttr, BookmarkAttr, LayerAttr, RectAttr, CircleAttr, EllipseAttr, LineAttr, PathAttr, TextAtAttr, ImgAtAttr, BarcodeAtAttr, FontAttr, ImageAttr, FileAttr, ProfileAttr, LayoutAttr, GradientToken, GradientStop, MarkdownAttr, MarkdownStylesAttr, MarkdownH1Attr, MarkdownH2Attr, MarkdownH3Attr, MarkdownH4Attr, MarkdownH5Attr, MarkdownH6Attr, MarkdownPAttr, MarkdownCodeAttr, MarkdownQuoteAttr, MarkdownLiAttr, MarkdownAAttr, MarkdownStrongAttr, MarkdownEmAttr, MarkdownDelAttr, MarkdownTableAttr, MarkdownThAttr, MarkdownTdAttr, } from './attrs';
 export type { LpdfNode, LpdfContainerNode, LpdfListNode, LpdfLiNode, LpdfTextNode, LpdfCodeNode, LpdfSpanNode, LpdfCodeSpanNode, LpdfFnNode, LpdfDividerNode, LpdfImgNode, LpdfShapeNode, LpdfBarcodeNode, LpdfTableNode, LpdfTheadNode, LpdfTrNode, LpdfTdNode, LpdfRegionNode, LpdfFieldNode, LpdfBookmarkNode, } from './layout';
 export { LMarkdown } from './markdown';
 export type { LpdfMarkdownNode, LpdfMarkdownStylesNode, LpdfMarkdownContentNode, LpdfMarkdownRuleNode, } from './markdown';

package/dist/kit.d.ts

@@ -22,7 +22,7 @@
 import type { LpdfBookmarkNode, LpdfNode } from './layout';
 import type { LpdfCanvasLayerNode } from './canvas';
 import type { LpdfMarkdownNode } from './markdown';
-import type { FileAttr, FontAttr, GradientToken, ImageAttr, LayoutAttr } from './attrs';
+import type { FileAttr, FontAttr, GradientToken, ImageAttr, LayoutAttr, ProfileAttr } from './attrs';
 import { type AttrValue } from './_shared';
 /** A slot of a token row, from the smallest to the largest. */
 export type TokenSlot = 'xs' | 's' | 'm' | 'l' | 'xl' | 'xxl';
@@ -49,12 +49,18 @@ export interface DocumentTokens {
     lineHeight?: TokenRow<number>;
 }
 /**
- * The fonts and images the document declares, as the `assets` element of the XML does. A font or image
- * is picked by its `name`: text sets `font` to a font's name, an `img` sets `name` to an image's.
+ * The fonts, images and color profiles the document declares, as the `assets` element of the XML does. A font or
+ * image is picked by its `name`: text sets `font` to a font's name, an `img` sets `name` to an image's, and the
+ * output's `profile` names a profile.
  */
 export interface DocumentAssets {
     fonts?: FontAttr[];
     images?: ImageAttr[];
+    /**
+     * ICC color profiles: the profile of the printing press a PDF/X document is made for, which the printer gives out.
+     * Each is read from its `src`, or loaded with `loadProfile` under its `ref` or name.
+     */
+    profiles?: ProfileAttr[];
 }
 export interface DocumentMeta {
     title?: string;
@@ -62,6 +68,8 @@ export interface DocumentMeta {
     subject?: string;
     keywords?: string;
     creator?: string;
+    /** The language the document is written in, as a language tag such as `en-US`. A PDF/UA document needs it. */
+    lang?: string;
 }
 /**
  * How the PDF file is written, as the `output` element of the XML is: whether it is encrypted, and what a reader
@@ -82,20 +90,62 @@ export interface DocumentOutput {
      * error that says what to change: a built-in font, a CMYK color, a form field, a barcode's digits, `encrypt`.
      */
     pdfa?: string;
+    /**
+     * Writes the PDF as PDF/UA-1, a tagged PDF a screen reader can read: `1`. It combines with `pdfa`. The render
+     * needs `createdOn`, the meta a `title` and a `lang`, every image and barcode of the layout an `alt`, and every
+     * text a font of `assets`. What PDF/UA cannot hold is an error that says what to change.
+     */
+    pdfua?: string;
+    /**
+     * Writes the PDF as PDF/X-4, for a commercial printer: `4`. It needs `profile`, and combines with `pdfua`. Every
+     * page gets a TrimBox and a BleedBox, RGB is tied to sRGB, and links print as text, as PDF/X allows nothing
+     * clickable. The render needs `createdOn`, the meta a `title`, and every text a font of `assets`. What PDF/X cannot
+     * hold is an error that says what to change: a profile that is not a printer profile, a built-in font, a form
+     * field, a CMYK color with a profile that is not a CMYK one, `encrypt`, `pdfa`, attachments.
+     */
+    pdfx?: string;
+    /** The profile of `assets` that a PDF/X file is made for: the ICC profile of the printing press. It needs `pdfx`. */
+    profile?: string;
+    /**
+     * Writes the PDF linearized, for fast web view: page 1 comes first in the file, with hints that say where every
+     * other page is, so a viewer that fetches the file by byte ranges, as a browser does, shows page 1 while the rest
+     * downloads. Each page then names only the fonts and images it draws. With `encrypt` the file is encrypted first
+     * and linearized last. Any change to the file afterwards, such as a stamp, ends the linearization.
+     */
+    linearize?: boolean;
 }
 export interface SectionAttr {
     size?: string;
     orientation?: string;
+    /** How far this section's pages reach past their trim edge, such as `5mm`. Overrides the document's; `0mm` takes it away. */
+    bleed?: string;
     background?: string;
     title?: string;
     debug?: boolean;
     type?: string;
     tocIndentStep?: string;
     footnoteCounter?: string;
+    /**
+     * The number of the section's first page, which starts a new run of pages: `1` restarts the count. Without it the
+     * pages count on from the section before. `{page}` prints a page's number, and `{pages}` how many pages its run has.
+     */
+    pageStart?: number;
+    /**
+     * How the section's page numbers are written: `decimal`, `lower-alpha`, `upper-alpha`, `lower-roman` or
+     * `upper-roman`. Without it the section keeps the format before.
+     */
+    pageFormat?: string;
+    /** Text before the section's page numbers, such as `A-`. Without it the section keeps the prefix before; `''` takes it away. */
+    pagePrefix?: string;
 }
 export interface DocumentAttr {
     size?: string;
     orientation?: string;
+    /**
+     * How far each page reaches past its trim edge, such as `3mm`, for a background or an image that runs off the page
+     * when it is cut. The page grows by it and its background fills it; the layout keeps to the trimmed page.
+     */
+    bleed?: string;
     background?: string;
     font?: string;
     assets?: DocumentAssets;

package/dist/wasm/lpdf-web.js

@@ -67,6 +67,19 @@ export class LpdfEngine {
         const len1 = WASM_VECTOR_LEN;
         wasm.lpdfengine_load_markdown_styles(this.__wbg_ptr, ptr0, len0, ptr1, len1);
     }
+    /**
+     * Register the bytes of an ICC colour profile, for the `<profile>` of a document's `<assets>` whose `ref`, or with
+     * no ref whose name, is `name`: the press profile a PDF/X document names in `<output profile>`.
+     * @param {string} name
+     * @param {Uint8Array} bytes
+     */
+    load_profile(name, bytes) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.lpdfengine_load_profile(this.__wbg_ptr, ptr0, len0, ptr1, len1);
+    }
     /**
      * @param {string} license_key
      */

package/dist/wasm/lpdf.js

@@ -67,6 +67,19 @@ class LpdfEngine {
         const len1 = WASM_VECTOR_LEN;
         wasm.lpdfengine_load_markdown_styles(this.__wbg_ptr, ptr0, len0, ptr1, len1);
     }
+    /**
+     * Register the bytes of an ICC colour profile, for the `<profile>` of a document's `<assets>` whose `ref`, or with
+     * no ref whose name, is `name`: the press profile a PDF/X document names in `<output profile>`.
+     * @param {string} name
+     * @param {Uint8Array} bytes
+     */
+    load_profile(name, bytes) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.lpdfengine_load_profile(this.__wbg_ptr, ptr0, len0, ptr1, len1);
+    }
     /**
      * @param {string} license_key
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lpdfio/lpdf",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "Node.js SDK for Lpdf — PDF as Code on every platform. You describe a document as code or XML. Lpdf renders a compact, pixel-perfect PDF — identical across platforms.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",