@jasy/pdf 1.0.0-alpha.2 → 1.0.0-alpha.4

package/dist/elements/index.js

@@ -1,29 +1,12 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PDFElement = void 0;
-var pdf_element_1 = require("./pdf-element"); // the base element type - public for composing custom layouts
-Object.defineProperty(exports, "PDFElement", { enumerable: true, get: function () { return pdf_element_1.PDFElement; } });
-__exportStar(require("./text-element"), exports);
-__exportStar(require("./pdf-document-element"), exports);
-__exportStar(require("./page-element"), exports);
-__exportStar(require("./rectangle-element"), exports);
-__exportStar(require("./image-element"), exports);
-__exportStar(require("./layout/expanded-element"), exports);
-__exportStar(require("./layout/padding-element"), exports);
-__exportStar(require("./layout/positioned-element"), exports);
-__exportStar(require("./line-element"), exports);
-__exportStar(require("./row-element"), exports);
+export { PDFElement } from "./pdf-element.js"; // the base element type - public for composing custom layouts
+export * from "./text-element.js";
+export * from "./pdf-document-element.js";
+export * from "./page-element.js";
+export * from "./rectangle-element.js";
+export * from "./image-element.js";
+export * from "./layout/expanded-element.js";
+export * from "./layout/padding-element.js";
+export * from "./layout/default-text-style-element.js";
+export * from "./layout/positioned-element.js";
+export * from "./line-element.js";
+export * from "./row-element.js";

package/dist/elements/layout/default-text-style-element.d.ts

@@ -0,0 +1,30 @@
+import { PDFElement, LayoutContext, WithChild, SizedPDFElement } from "../pdf-element.js";
+import { BoxConstraints, Offset, Size } from "../../layout/box-constraints.js";
+import { Fragmentable, FragmentResult } from "../../layout/fragmentation.js";
+import { ResolvedTextStyle } from "../../text/text-style.js";
+interface DefaultTextStyleParams extends WithChild {
+    style: Partial<ResolvedTextStyle>;
+}
+/**
+ * Provides default text properties (font/size/color/lineHeight/align/weight) to its whole subtree -
+ * Flutter's `DefaultTextStyle`. Transparent to layout: the child takes the same constraints, offset
+ * and size; only the inherited TextStyle changes. A `Text` below still wins per property, and these
+ * overrides layer onto whatever the element already inherited from above.
+ */
+export declare class DefaultTextStyleElement extends SizedPDFElement implements Fragmentable {
+    private child;
+    private style;
+    constructor({ child, style }: DefaultTextStyleParams);
+    private childCtx;
+    fragment(maxHeight: number, width: number, ctx: LayoutContext): FragmentResult;
+    private cloneWithChild;
+    calculateLayout(constraints: BoxConstraints, offset: Offset, ctx: LayoutContext): Size;
+    getProps(): {
+        x: number;
+        y: number;
+        width: number | undefined;
+        height: number | undefined;
+        child: PDFElement;
+    };
+}
+export {};

package/dist/elements/layout/default-text-style-element.js

@@ -0,0 +1,47 @@
+import { SizedPDFElement } from "../pdf-element.js";
+import { isFragmentable } from "../../layout/fragmentation.js";
+import { DEFAULT_TEXT_STYLE, mergeTextStyle } from "../../text/text-style.js";
+/**
+ * Provides default text properties (font/size/color/lineHeight/align/weight) to its whole subtree -
+ * Flutter's `DefaultTextStyle`. Transparent to layout: the child takes the same constraints, offset
+ * and size; only the inherited TextStyle changes. A `Text` below still wins per property, and these
+ * overrides layer onto whatever the element already inherited from above.
+ */
+export class DefaultTextStyleElement extends SizedPDFElement {
+    constructor({ child, style }) {
+        super({ x: 0, y: 0 });
+        this.child = child;
+        this.style = style;
+    }
+    childCtx(ctx) {
+        return {
+            ...ctx,
+            textStyle: mergeTextStyle(ctx.textStyle ?? DEFAULT_TEXT_STYLE, this.style),
+        };
+    }
+    // Transparent to fragmentation too: split the child against the merged context, re-wrapping each
+    // half so the remainder on the next page keeps the same defaults.
+    fragment(maxHeight, width, ctx) {
+        if (!isFragmentable(this.child))
+            return { fitted: null, remainder: this };
+        const split = this.child.fragment(maxHeight, width, this.childCtx(ctx));
+        return {
+            fitted: split.fitted ? this.cloneWithChild(split.fitted) : null,
+            remainder: split.remainder ? this.cloneWithChild(split.remainder) : null,
+        };
+    }
+    cloneWithChild(child) {
+        return new DefaultTextStyleElement({ child, style: this.style });
+    }
+    calculateLayout(constraints, offset, ctx) {
+        this.x = offset.x;
+        this.y = offset.y;
+        const size = this.child.calculateLayout(constraints, offset, this.childCtx(ctx));
+        this.width = size.width;
+        this.height = size.height;
+        return size;
+    }
+    getProps() {
+        return { x: this.x, y: this.y, width: this.width, height: this.height, child: this.child };
+    }
+}

package/dist/elements/layout/deferred-element.d.ts

@@ -1,6 +1,6 @@
-import { BoxConstraints, Offset, Size } from "../../layout/box-constraints";
-import { Fragmentable, FragmentResult } from "../../layout/fragmentation";
-import { LayoutContext, PDFElement } from "../pdf-element";
+import { BoxConstraints, Offset, Size } from "../../layout/box-constraints.js";
+import { Fragmentable, FragmentResult } from "../../layout/fragmentation.js";
+import { LayoutContext, PDFElement } from "../pdf-element.js";
 /**
  * Builds its subtree at layout time via `resolve(ctx)`, so the tree can depend on font
  * metrics (e.g. a Table resolving `"auto"` column widths from cell content). The engine

package/dist/elements/layout/deferred-element.js

@@ -1,14 +1,11 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DeferredElement = void 0;
-const fragmentation_1 = require("../../layout/fragmentation");
-const pdf_element_1 = require("../pdf-element");
+import { isFragmentable } from "../../layout/fragmentation.js";
+import { PDFElement } from "../pdf-element.js";
 /**
  * Builds its subtree at layout time via `resolve(ctx)`, so the tree can depend on font
  * metrics (e.g. a Table resolving `"auto"` column widths from cell content). The engine
  * stays table-agnostic - the closure comes from the API layer.
  */
-class DeferredElement extends pdf_element_1.PDFElement {
+export class DeferredElement extends PDFElement {
     constructor(resolve) {
         super();
         this.resolve = resolve;
@@ -22,7 +19,7 @@ class DeferredElement extends pdf_element_1.PDFElement {
     }
     fragment(maxHeight, width, ctx) {
         const c = this.build(ctx);
-        return (0, fragmentation_1.isFragmentable)(c)
+        return isFragmentable(c)
             ? c.fragment(maxHeight, width, ctx)
             : { fitted: this, remainder: null };
     }
@@ -30,4 +27,3 @@ class DeferredElement extends pdf_element_1.PDFElement {
         return { composed: this.composed };
     }
 }
-exports.DeferredElement = DeferredElement;

package/dist/elements/layout/expanded-element.d.ts

@@ -1,6 +1,6 @@
-import { PDFElement, LayoutContext, FlexiblePDFElement, WithChild, FlexibleElement } from "../pdf-element";
-import { BoxConstraints, Offset, Size } from "../../layout/box-constraints";
-import { Fragmentable, FragmentResult } from "../../layout/fragmentation";
+import { PDFElement, LayoutContext, FlexiblePDFElement, WithChild, FlexibleElement } from "../pdf-element.js";
+import { BoxConstraints, Offset, Size } from "../../layout/box-constraints.js";
+import { Fragmentable, FragmentResult } from "../../layout/fragmentation.js";
 interface ExpandedElementParams extends FlexibleElement, WithChild {
 }
 export declare class ExpandedElement extends FlexiblePDFElement implements Fragmentable {

package/dist/elements/layout/expanded-element.js

@@ -1,11 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExpandedElement = void 0;
-const element_validator_1 = require("../../validators/element-validator");
-const pdf_element_1 = require("../pdf-element");
-const box_constraints_1 = require("../../layout/box-constraints");
-const fragmentation_1 = require("../../layout/fragmentation");
-class ExpandedElement extends pdf_element_1.FlexiblePDFElement {
+import { Validator } from "../../validators/element-validator.js";
+import { FlexiblePDFElement, } from "../pdf-element.js";
+import { BoxConstraints } from "../../layout/box-constraints.js";
+import { isFragmentable } from "../../layout/fragmentation.js";
+export class ExpandedElement extends FlexiblePDFElement {
     constructor({ flex, child }) {
         super({ flex });
         this.x = 0;
@@ -20,17 +17,17 @@ class ExpandedElement extends pdf_element_1.FlexiblePDFElement {
         // Absolute placement from the parent; assignment (not +=) so re-layout is idempotent.
         this.x = offset.x;
         this.y = offset.y;
-        element_validator_1.Validator.validateFlexElement(this);
+        Validator.validateFlexElement(this);
         if (constraints.hasBoundedHeight) {
-            // A bounded region: fill it - the normal flex behaviour.
+            // A bounded region: fill it - the normal flex behavior.
             this.height = constraints.maxHeight;
-            this.child.calculateLayout(box_constraints_1.BoxConstraints.loose(this.width, this.height), { x: this.x, y: this.y }, ctx);
+            this.child.calculateLayout(BoxConstraints.loose(this.width, this.height), { x: this.x, y: this.y }, ctx);
         }
         else {
             // Unbounded (measuring while paginating): there's no leftover space to fill, so
             // collapse to the child's natural height. This lets an overflowing column flow
             // instead of the flex silently hiding the overflow.
-            const childSize = this.child.calculateLayout(box_constraints_1.BoxConstraints.loose(this.width, Infinity), { x: this.x, y: this.y }, ctx);
+            const childSize = this.child.calculateLayout(BoxConstraints.loose(this.width, Infinity), { x: this.x, y: this.y }, ctx);
             this.height = childSize.height;
         }
         // Top-left coordinates; the Y-flip now happens once at the IR -> backend seam.
@@ -43,7 +40,7 @@ class ExpandedElement extends pdf_element_1.FlexiblePDFElement {
      * whole Expanded moves on.
      */
     fragment(maxHeight, width, ctx) {
-        if (!(0, fragmentation_1.isFragmentable)(this.child)) {
+        if (!isFragmentable(this.child)) {
             return { fitted: null, remainder: this };
         }
         const split = this.child.fragment(maxHeight, width, ctx);
@@ -65,4 +62,3 @@ class ExpandedElement extends pdf_element_1.FlexiblePDFElement {
         };
     }
 }
-exports.ExpandedElement = ExpandedElement;

package/dist/elements/layout/padding-element.d.ts

@@ -1,6 +1,6 @@
-import { PDFElement, LayoutContext, WithChild, SizedPDFElement } from "../pdf-element";
-import { BoxConstraints, Offset, Size } from "../../layout/box-constraints";
-import { Fragmentable, FragmentResult } from "../../layout/fragmentation";
+import { PDFElement, LayoutContext, WithChild, SizedPDFElement } from "../pdf-element.js";
+import { BoxConstraints, Offset, Size } from "../../layout/box-constraints.js";
+import { Fragmentable, FragmentResult } from "../../layout/fragmentation.js";
 interface PaddingElementParams extends WithChild {
     margin: [number, number, number, number];
 }

package/dist/elements/layout/padding-element.js

@@ -1,11 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PaddingElement = void 0;
-const element_validator_1 = require("../../validators/element-validator");
-const pdf_element_1 = require("../pdf-element");
-const box_constraints_1 = require("../../layout/box-constraints");
-const fragmentation_1 = require("../../layout/fragmentation");
-class PaddingElement extends pdf_element_1.SizedPDFElement {
+import { Validator } from "../../validators/element-validator.js";
+import { SizedPDFElement } from "../pdf-element.js";
+import { BoxConstraints } from "../../layout/box-constraints.js";
+import { isFragmentable } from "../../layout/fragmentation.js";
+export class PaddingElement extends SizedPDFElement {
     constructor({ margin, child }) {
         super({ x: 0, y: 0 });
         this.child = child;
@@ -18,7 +15,7 @@ class PaddingElement extends pdf_element_1.SizedPDFElement {
      * child can't be split, the whole padding moves on as the remainder.
      */
     fragment(maxHeight, width, ctx) {
-        if (!(0, fragmentation_1.isFragmentable)(this.child)) {
+        if (!isFragmentable(this.child)) {
             return { fitted: null, remainder: this };
         }
         const [marginTop, marginRight, marginBottom, marginLeft] = this.margin;
@@ -34,7 +31,6 @@ class PaddingElement extends pdf_element_1.SizedPDFElement {
         return new PaddingElement({ margin: this.margin, child });
     }
     calculateLayout(constraints, offset, ctx) {
-        var _a;
         // Padding takes the width it is offered; its height shrink-wraps the child.
         if (constraints.hasBoundedWidth)
             this.width = constraints.maxWidth;
@@ -50,7 +46,7 @@ class PaddingElement extends pdf_element_1.SizedPDFElement {
         const childWidth = constraints.hasBoundedWidth
             ? Math.max(0, constraints.maxWidth - marginLeft - marginRight)
             : Infinity;
-        const childConstraints = box_constraints_1.BoxConstraints.loose(childWidth, Infinity);
+        const childConstraints = BoxConstraints.loose(childWidth, Infinity);
         const childSize = this.child.calculateLayout(childConstraints, childOffset, ctx);
         this.height = childSize.height + marginTop + marginBottom;
         // Unbounded width (e.g. a fixed child in a Row): shrink-wrap to the child + insets,
@@ -58,9 +54,9 @@ class PaddingElement extends pdf_element_1.SizedPDFElement {
         if (!constraints.hasBoundedWidth) {
             this.width = childSize.width + marginLeft + marginRight;
         }
-        element_validator_1.Validator.validateSizedElement(this);
+        Validator.validateSizedElement(this);
         // Top-left coordinates; the Y-flip now happens once at the IR -> backend seam.
-        return { width: (_a = this.width) !== null && _a !== void 0 ? _a : 0, height: this.height };
+        return { width: this.width ?? 0, height: this.height };
     }
     getProps() {
         return {
@@ -73,4 +69,3 @@ class PaddingElement extends pdf_element_1.SizedPDFElement {
         };
     }
 }
-exports.PaddingElement = PaddingElement;

package/dist/elements/layout/positioned-element.d.ts

@@ -1,11 +1,24 @@
-import { BoxConstraints, Offset, Size } from "../../layout/box-constraints";
-import { LayoutContext, PDFElement, WithChild } from "../pdf-element";
-/** Offsets from the frame's box edges, in points. Negative lets the child poke outside. */
+import { BoxConstraints, Offset, Size } from "../../layout/box-constraints.js";
+import { LayoutContext, PDFElement, WithChild } from "../pdf-element.js";
+/** A position anchor along one axis: `start` (left/top), `center`, or `end` (right/bottom). */
+export type PositionAnchor = "start" | "center" | "end";
+/**
+ * How a `Positioned` child sits in its frame. Two ways, pick per axis:
+ *  - EDGE pinning: `top`/`right`/`bottom`/`left` (points from that edge; negative pokes outside).
+ *    Pinning BOTH sides of an axis stretches the child to fill between them.
+ *  - ANCHOR + nudge: `h`/`v` anchor the child (start/center/end) and `x`/`y` nudge it from there
+ *    (e.g. `{ h: "center", x: -10 }` = centered minus 10pt). The child shrink-wraps to its content.
+ * An edge wins over an anchor on the same axis. With nothing set the child sits at the top-left.
+ */
 export interface PositionedInsets {
     top?: number;
     right?: number;
     bottom?: number;
     left?: number;
+    h?: PositionAnchor;
+    v?: PositionAnchor;
+    x?: number;
+    y?: number;
 }
 interface PositionedElementParams extends WithChild, PositionedInsets {
 }
@@ -22,7 +35,7 @@ interface PositionedElementParams extends WithChild, PositionedInsets {
 export declare class PositionedElement extends PDFElement {
     private child;
     private insets;
-    constructor({ child, top, right, bottom, left }: PositionedElementParams);
+    constructor({ child, top, right, bottom, left, h, v, x, y }: PositionedElementParams);
     calculateLayout(_constraints: BoxConstraints, _offset: Offset, ctx: LayoutContext): Size;
     /** Lays the child out at the resolved position inside (or overflowing) the frame box. */
     private placeInFrame;

package/dist/elements/layout/positioned-element.js

@@ -1,8 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PositionedElement = void 0;
-const box_constraints_1 = require("../../layout/box-constraints");
-const pdf_element_1 = require("../pdf-element");
+import { BoxConstraints } from "../../layout/box-constraints.js";
+import { PDFElement } from "../pdf-element.js";
 /**
  * An out-of-flow child, placed relative to the nearest enclosing positioning frame (a `relative`
  * Box). It takes ZERO space in the normal flow - `calculateLayout` returns `Size(0,0)` and instead
@@ -13,45 +10,52 @@ const pdf_element_1 = require("../pdf-element");
  * With no frame in scope the element is a no-op (nothing is drawn) - `Positioned` only makes sense
  * inside a `relative` Box.
  */
-class PositionedElement extends pdf_element_1.PDFElement {
-    constructor({ child, top, right, bottom, left }) {
+export class PositionedElement extends PDFElement {
+    constructor({ child, top, right, bottom, left, h, v, x, y }) {
         super();
         this.child = child;
-        this.insets = { top, right, bottom, left };
+        this.insets = { top, right, bottom, left, h, v, x, y };
     }
     calculateLayout(_constraints, _offset, ctx) {
-        var _a;
         // Defer to the frame: it calls back once it has sized itself. Out of flow either way.
-        (_a = ctx.frame) === null || _a === void 0 ? void 0 : _a.place.push((frame, frameCtx) => this.placeInFrame(frame, frameCtx));
+        ctx.frame?.place.push((frame, frameCtx) => this.placeInFrame(frame, frameCtx));
         return { width: 0, height: 0 };
     }
     /** Lays the child out at the resolved position inside (or overflowing) the frame box. */
     placeInFrame(frame, ctx) {
-        const { top, right, bottom, left } = this.insets;
-        // An axis is PINNED (stretched) only when BOTH of its insets are given; otherwise the child
-        // shrink-wraps its content (unbounded), the CSS rule for an absolutely-positioned element.
+        const { top, right, bottom, left, h, v, x: nudgeX, y: nudgeY } = this.insets;
+        // An axis is PINNED (stretched) only when BOTH of its EDGES are given; otherwise the child
+        // shrink-wraps its content (unbounded), the CSS rule for an absolutely-positioned element. An
+        // anchor never stretches - it positions a content-sized child.
         const width = left !== undefined && right !== undefined
             ? Math.max(0, frame.size.width - left - right)
             : Infinity;
         const height = top !== undefined && bottom !== undefined
             ? Math.max(0, frame.size.height - top - bottom)
             : Infinity;
-        const constraints = box_constraints_1.BoxConstraints.loose(width, height);
-        // Measure first (so right/bottom can resolve against the child's own size).
+        const constraints = BoxConstraints.loose(width, height);
+        // Measure first (so end/center anchors and right/bottom edges resolve against the child's size).
         const measured = this.child.calculateLayout(constraints, { x: 0, y: 0 }, ctx);
-        let x = frame.origin.x + (left !== null && left !== void 0 ? left : 0);
-        if (left === undefined && right !== undefined) {
-            x = frame.origin.x + frame.size.width - measured.width - right;
-        }
-        let y = frame.origin.y + (top !== null && top !== void 0 ? top : 0);
-        if (top === undefined && bottom !== undefined) {
-            y = frame.origin.y + frame.size.height - measured.height - bottom;
-        }
-        // Place it for real at the resolved corner.
+        // Resolve one axis: a near-edge pins to origin, a far-edge pins to the far side; otherwise the
+        // anchor (default `start`) positions the child and the nudge shifts it from there.
+        const place = (origin, frameExtent, childExtent, nearEdge, farEdge, anchor, nudge) => {
+            if (nearEdge !== undefined)
+                return origin + nearEdge;
+            if (farEdge !== undefined)
+                return origin + frameExtent - childExtent - farEdge;
+            const base = anchor === "center"
+                ? (frameExtent - childExtent) / 2
+                : anchor === "end"
+                    ? frameExtent - childExtent
+                    : 0; // start (default)
+            return origin + base + (nudge ?? 0);
+        };
+        const x = place(frame.origin.x, frame.size.width, measured.width, left, right, h, nudgeX);
+        const y = place(frame.origin.y, frame.size.height, measured.height, top, bottom, v, nudgeY);
+        // Place it for real at the resolved position.
         this.child.calculateLayout(constraints, { x, y }, ctx);
     }
     getProps() {
         return { child: this.child };
     }
 }
-exports.PositionedElement = PositionedElement;

package/dist/elements/layout/repeating-header-element.d.ts

@@ -1,6 +1,6 @@
-import { BoxConstraints, Offset, Size } from "../../layout/box-constraints";
-import { Fragmentable, FragmentResult } from "../../layout/fragmentation";
-import { LayoutContext, PDFElement } from "../pdf-element";
+import { BoxConstraints, Offset, Size } from "../../layout/box-constraints.js";
+import { Fragmentable, FragmentResult } from "../../layout/fragmentation.js";
+import { LayoutContext, PDFElement } from "../pdf-element.js";
 /**
  * Stacks a `header` above a `body` and, when it paginates, **repeats the header on every
  * fragment**. Used by `Table` so column headings reappear at the top of each page. Layout

package/dist/elements/layout/repeating-header-element.js

@@ -1,16 +1,13 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RepeatingHeaderElement = void 0;
-const box_constraints_1 = require("../../layout/box-constraints");
-const fragmentation_1 = require("../../layout/fragmentation");
-const pdf_element_1 = require("../pdf-element");
+import { BoxConstraints } from "../../layout/box-constraints.js";
+import { isFragmentable } from "../../layout/fragmentation.js";
+import { PDFElement } from "../pdf-element.js";
 /**
  * Stacks a `header` above a `body` and, when it paginates, **repeats the header on every
  * fragment**. Used by `Table` so column headings reappear at the top of each page. Layout
  * is just header-then-body (like a 2-row Column); the magic is in `fragment`: it splits the
  * body and re-wraps each piece with the same header, so every physical page gets its own.
  */
-class RepeatingHeaderElement extends pdf_element_1.PDFElement {
+export class RepeatingHeaderElement extends PDFElement {
     constructor(header, body, gap = 0) {
         super();
         this.header = header;
@@ -25,16 +22,16 @@ class RepeatingHeaderElement extends pdf_element_1.PDFElement {
         this.x = offset.x;
         this.y = offset.y;
         const width = constraints.hasBoundedWidth ? constraints.maxWidth : 0;
-        const h = this.header.calculateLayout(box_constraints_1.BoxConstraints.loose(width, Infinity), { x: this.x, y: this.y }, ctx);
-        const b = this.body.calculateLayout(box_constraints_1.BoxConstraints.loose(width, Infinity), { x: this.x, y: this.y + h.height + this.gap }, ctx);
+        const h = this.header.calculateLayout(BoxConstraints.loose(width, Infinity), { x: this.x, y: this.y }, ctx);
+        const b = this.body.calculateLayout(BoxConstraints.loose(width, Infinity), { x: this.x, y: this.y + h.height + this.gap }, ctx);
         this.width = width;
         this.height = h.height + this.gap + b.height;
         return { width: this.width, height: this.height };
     }
     fragment(maxHeight, width, ctx) {
         // Reserve the header's height on every page; the body flows in what's left.
-        const headerHeight = this.header.calculateLayout(box_constraints_1.BoxConstraints.loose(width, Infinity), { x: 0, y: 0 }, ctx).height;
-        if (!(0, fragmentation_1.isFragmentable)(this.body))
+        const headerHeight = this.header.calculateLayout(BoxConstraints.loose(width, Infinity), { x: 0, y: 0 }, ctx).height;
+        if (!isFragmentable(this.body))
             return { fitted: this, remainder: null };
         const split = this.body.fragment(Math.max(0, maxHeight - headerHeight - this.gap), width, ctx);
         // Body fits whole → the whole thing fits on this page.
@@ -57,4 +54,3 @@ class RepeatingHeaderElement extends pdf_element_1.PDFElement {
         };
     }
 }
-exports.RepeatingHeaderElement = RepeatingHeaderElement;

package/dist/elements/layout/sized-container-element.d.ts

@@ -1,5 +1,5 @@
-import { SizedElement, WithChildren, SizedPDFElement, LayoutContext } from "../pdf-element";
-import { BoxConstraints, Offset, Size } from "../../layout/box-constraints";
+import { SizedElement, WithChildren, SizedPDFElement, LayoutContext } from "../pdf-element.js";
+import { BoxConstraints, Offset, Size } from "../../layout/box-constraints.js";
 interface ContainerElementParams extends SizedElement, WithChildren {
     color?: [number, number, number];
     backgroundColor?: [number, number, number];

package/dist/elements/layout/sized-container-element.js

@@ -1,15 +1,11 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SizedContainerElement = void 0;
-const pdf_element_1 = require("../pdf-element");
-const box_constraints_1 = require("../../layout/box-constraints");
-class SizedContainerElement extends pdf_element_1.SizedPDFElement {
+import { SizedPDFElement, } from "../pdf-element.js";
+import { BoxConstraints } from "../../layout/box-constraints.js";
+export class SizedContainerElement extends SizedPDFElement {
     constructor({ width, height, children }) {
         super({ x: 0, y: 0, width, height });
         this.children = children;
     }
     calculateLayout(constraints, offset, ctx) {
-        var _a, _b;
         if (constraints.hasBoundedWidth)
             this.width = constraints.maxWidth;
         if (constraints.hasBoundedHeight)
@@ -17,10 +13,10 @@ class SizedContainerElement extends pdf_element_1.SizedPDFElement {
         // Absolute placement from the parent; assignment (not +=) so re-layout is idempotent.
         this.x = offset.x;
         this.y = offset.y;
-        const width = (_a = this.width) !== null && _a !== void 0 ? _a : 0;
-        const height = (_b = this.height) !== null && _b !== void 0 ? _b : 0;
+        const width = this.width ?? 0;
+        const height = this.height ?? 0;
         if (this.children)
-            this.children.forEach((child) => child.calculateLayout(box_constraints_1.BoxConstraints.loose(width, height), { x: this.x, y: this.y }, ctx));
+            this.children.forEach((child) => child.calculateLayout(BoxConstraints.loose(width, height), { x: this.x, y: this.y }, ctx));
         // Top-left coordinates; the Y-flip now happens once at the IR -> backend seam.
         return { width, height };
     }
@@ -34,4 +30,3 @@ class SizedContainerElement extends pdf_element_1.SizedPDFElement {
         };
     }
 }
-exports.SizedContainerElement = SizedContainerElement;

package/dist/elements/line-element.d.ts

@@ -1,6 +1,6 @@
-import { Color } from "../common/color";
-import { BoxConstraints, Offset, Size } from "../layout/box-constraints";
-import { LayoutContext, SizedElement, SizedPDFElement } from "./pdf-element";
+import { Color } from "../common/color.js";
+import { BoxConstraints, Offset, Size } from "../layout/box-constraints.js";
+import { LayoutContext, SizedElement, SizedPDFElement } from "./pdf-element.js";
 interface LineElementParams extends SizedElement {
     color?: Color;
     strokeWidth?: number;

package/dist/elements/line-element.js

@@ -1,10 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LineElement = void 0;
-const color_1 = require("../common/color");
-const pdf_element_1 = require("./pdf-element");
-class LineElement extends pdf_element_1.SizedPDFElement {
-    constructor({ color = new color_1.Color(0, 0, 0), strokeWidth, x, y, xEnd, yEnd }) {
+import { Color } from "../common/color.js";
+import { SizedPDFElement } from "./pdf-element.js";
+export class LineElement extends SizedPDFElement {
+    constructor({ color = new Color(0, 0, 0), strokeWidth, x, y, xEnd, yEnd }) {
         super({ x: x, y: y, width: xEnd, height: y + yEnd });
         this.color = color;
         this.strokeWidth = strokeWidth ? strokeWidth : 1;
@@ -15,7 +12,6 @@ class LineElement extends pdf_element_1.SizedPDFElement {
         this.sizeMemory = { x, y, width: xEnd, height: yEnd };
     }
     calculateLayout(constraints, offset, _ctx) {
-        var _a, _b;
         // Set relative to parent
         this.x = this.sizeMemory.x + offset.x;
         this.y = this.sizeMemory.y + offset.y;
@@ -26,7 +22,7 @@ class LineElement extends pdf_element_1.SizedPDFElement {
         this.xEnd = offset.x + constraints.maxWidth - this.sizeMemory.width;
         this.yEnd = offset.y + this.sizeMemory.height;
         // Top-left coordinates; the Y-flip happens once at the IR -> backend seam.
-        return { width: (_a = this.width) !== null && _a !== void 0 ? _a : 0, height: (_b = this.height) !== null && _b !== void 0 ? _b : 0 };
+        return { width: this.width ?? 0, height: this.height ?? 0 };
     }
     getProps() {
         return {
@@ -41,4 +37,3 @@ class LineElement extends pdf_element_1.SizedPDFElement {
         };
     }
 }
-exports.LineElement = LineElement;

package/dist/elements/page-element.d.ts

@@ -1,11 +1,13 @@
-import { PageSize } from "../constants/page-sizes";
-import { Orientation } from "../renderer/pdf-config";
-import type { ColorMode, DefaultFont, Margin } from "../renderer";
-import { BoxConstraints, Offset, Size } from "../layout/box-constraints";
-import { LayoutContext, PDFElement, WithChildren } from "./pdf-element";
-import { TextElement } from "./text-element";
+import { PageSize } from "../constants/page-sizes.js";
+import { Orientation } from "../renderer/pdf-config.js";
+import type { ColorMode, DefaultFont, Margin } from "../renderer/index.js";
+import { BoxConstraints, Offset, Size } from "../layout/box-constraints.js";
+import { LayoutContext, PDFElement, WithChildren } from "./pdf-element.js";
+import { TextElement } from "./text-element.js";
 export interface PDFPageConfig {
     pageSize?: PageSize;
+    /** Explicit [width, height] in points; overrides `pageSize` (e.g. a custom label format). */
+    customSize?: [number, number];
     orientation?: Orientation;
     margin?: Margin;
     colorMode?: ColorMode;