@jasy/pdf 1.0.0-alpha.1 → 1.0.0-alpha.3

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

@@ -0,0 +1,44 @@
+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 {
+}
+/**
+ * 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
+ * registers a placement closure on the frame. The frame runs that closure once it knows its own
+ * size, so `right`/`bottom` resolve against the final box and the child can overflow it (a negative
+ * `top`/`left` makes it poke into / out of the corner, e.g. a badge or tab).
+ *
+ * With no frame in scope the element is a no-op (nothing is drawn) - `Positioned` only makes sense
+ * inside a `relative` Box.
+ */
+export declare class PositionedElement extends PDFElement {
+    private child;
+    private insets;
+    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;
+    getProps(): WithChild;
+}
+export {};

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

@@ -0,0 +1,61 @@
+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
+ * registers a placement closure on the frame. The frame runs that closure once it knows its own
+ * size, so `right`/`bottom` resolve against the final box and the child can overflow it (a negative
+ * `top`/`left` makes it poke into / out of the corner, e.g. a badge or tab).
+ *
+ * With no frame in scope the element is a no-op (nothing is drawn) - `Positioned` only makes sense
+ * inside a `relative` Box.
+ */
+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, h, v, x, y };
+    }
+    calculateLayout(_constraints, _offset, ctx) {
+        // Defer to the frame: it calls back once it has sized itself. Out of flow either way.
+        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, 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 = 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);
+        // 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 };
+    }
+}

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;

package/dist/elements/page-element.js

@@ -1,22 +1,18 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PageElement = void 0;
-exports.resolvePageContentBox = resolvePageContentBox;
-exports.layoutPageBands = layoutPageBands;
-const page_sizes_1 = require("../constants/page-sizes");
-const pdf_config_1 = require("../renderer/pdf-config");
-const box_constraints_1 = require("../layout/box-constraints");
-const pdf_element_1 = require("./pdf-element");
+import { pageFormats } from "../constants/page-sizes.js";
+import { Orientation } from "../renderer/pdf-config.js";
+import { BoxConstraints } from "../layout/box-constraints.js";
+import { PDFElement } from "./pdf-element.js";
 /**
  * The content box of a page (inside the margins, orientation applied) for a fully
  * resolved config. Single source of truth, shared by `PageElement` layout and the page
  * driver so they can never drift.
  */
-function resolvePageContentBox(config) {
+export function resolvePageContentBox(config) {
     const margin = config.margin;
-    let width = page_sizes_1.pageFormats[config.pageSize][0] - margin.left - margin.right;
-    let height = page_sizes_1.pageFormats[config.pageSize][1] - margin.top - margin.bottom;
-    if (config.orientation === pdf_config_1.Orientation.landscape) {
+    const [pageW, pageH] = config.customSize ?? pageFormats[config.pageSize];
+    let width = pageW - margin.left - margin.right;
+    let height = pageH - margin.top - margin.bottom;
+    if (config.orientation === Orientation.landscape) {
         [width, height] = [height, width];
     }
     return { origin: { x: margin.left, y: margin.top }, width, height };
@@ -29,17 +25,17 @@ function resolvePageContentBox(config) {
  * no header/footer the bands are zero and the body equals the full content box - identical
  * to a page without them.
  */
-function layoutPageBands(config, header, footer, ctx) {
+export function layoutPageBands(config, header, footer, ctx) {
     const { origin, width, height } = resolvePageContentBox(config);
     let headerHeight = 0;
     if (header) {
-        headerHeight = header.calculateLayout(box_constraints_1.BoxConstraints.loose(width, Infinity), origin, ctx).height;
+        headerHeight = header.calculateLayout(BoxConstraints.loose(width, Infinity), origin, ctx).height;
     }
     let footerHeight = 0;
     if (footer) {
         // Measure first to learn its height, then place it flush against the bottom edge.
-        footerHeight = footer.calculateLayout(box_constraints_1.BoxConstraints.loose(width, Infinity), origin, ctx).height;
-        footer.calculateLayout(box_constraints_1.BoxConstraints.loose(width, Infinity), { x: origin.x, y: origin.y + height - footerHeight }, ctx);
+        footerHeight = footer.calculateLayout(BoxConstraints.loose(width, Infinity), origin, ctx).height;
+        footer.calculateLayout(BoxConstraints.loose(width, Infinity), { x: origin.x, y: origin.y + height - footerHeight }, ctx);
     }
     return {
         bodyOrigin: { x: origin.x, y: origin.y + headerHeight },
@@ -49,11 +45,11 @@ function layoutPageBands(config, header, footer, ctx) {
         footerHeight,
     };
 }
-class PageElement extends pdf_element_1.PDFElement {
+export class PageElement extends PDFElement {
     constructor({ children, config, header, footer }) {
         super();
         this.children = children;
-        this.config = config !== null && config !== void 0 ? config : {};
+        this.config = config ?? {};
         this.header = header;
         this.footer = footer;
     }
@@ -61,16 +57,29 @@ class PageElement extends pdf_element_1.PDFElement {
         // Merge the document defaults (carried in the context) with this page's overrides,
         // then hand descendants a context bound to THIS page's geometry. This is what
         // fixes the old last-page-wins global page-config bug.
-        this.config = Object.assign(Object.assign({}, ctx.pageConfig), this.config);
+        this.config = { ...ctx.pageConfig, ...this.config };
         const pageCtx = {
             metrics: ctx.metrics,
             pageConfig: this.config,
+            textStyle: ctx.textStyle,
+            onOverflow: ctx.onOverflow,
         };
         // Place the header/footer bands; the body gets the region left in between (the whole
         // content box when there is neither - byte-identical to a plain page).
         const bands = layoutPageBands(this.config, this.header, this.footer, pageCtx);
-        const childConstraints = box_constraints_1.BoxConstraints.loose(bands.bodyWidth, bands.bodyHeight);
-        this.children.forEach((child) => child.calculateLayout(childConstraints, bands.bodyOrigin, pageCtx));
+        const childConstraints = BoxConstraints.loose(bands.bodyWidth, bands.bodyHeight);
+        // The page body is itself a positioning frame: a `Positioned` with no `relative` ancestor
+        // resolves against the content box (a `relative` Box overrides it for its own subtree). Drained
+        // after the body is laid out, so a page-level Positioned isn't a silent no-op.
+        const frame = {
+            origin: bands.bodyOrigin,
+            size: { width: bands.bodyWidth, height: bands.bodyHeight },
+            place: [],
+        };
+        const bodyCtx = { ...pageCtx, frame };
+        this.children.forEach((child) => child.calculateLayout(childConstraints, bands.bodyOrigin, bodyCtx));
+        for (const place of frame.place)
+            place(frame, pageCtx);
         const { width, height } = resolvePageContentBox(this.config);
         return { width, height };
     }
@@ -87,4 +96,3 @@ class PageElement extends pdf_element_1.PDFElement {
         return this;
     }
 }
-exports.PageElement = PageElement;

package/dist/elements/pdf-document-element.d.ts

@@ -1,12 +1,18 @@
-import { PageElement } from "./page-element";
-import { BoxConstraints, Offset, Size } from "../layout/box-constraints";
-import { LayoutContext, PDFElement, WithChildren } from "./pdf-element";
+import { PageElement } from "./page-element.js";
+import { BoxConstraints, Offset, Size } from "../layout/box-constraints.js";
+import { LayoutContext, PDFElement, WithChildren } from "./pdf-element.js";
+import type { ResolvedTextStyle } from "../text/text-style.js";
 interface PDFDocumentParams extends WithChildren {
     children: PageElement[];
+    /** Document-level text defaults descendants inherit (seeded into the layout-context root). */
+    defaultTextStyle?: Partial<ResolvedTextStyle>;
 }
 export declare class PDFDocumentElement extends PDFElement {
     private children;
-    constructor({ children }: PDFDocumentParams);
+    private defaultTextStyle?;
+    constructor({ children, defaultTextStyle }: PDFDocumentParams);
+    /** The document-level text defaults; the renderer merges them into the cascade root. */
+    getDefaultTextStyle(): Partial<ResolvedTextStyle> | undefined;
     calculateLayout(_constraints: BoxConstraints, _offset: Offset, ctx: LayoutContext): Size;
     getProps(): PDFDocumentParams;
 }

package/dist/elements/pdf-document-element.js

@@ -1,22 +1,23 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PDFDocumentElement = void 0;
-const box_constraints_1 = require("../layout/box-constraints");
-const pdf_element_1 = require("./pdf-element");
-class PDFDocumentElement extends pdf_element_1.PDFElement {
-    constructor({ children }) {
+import { BoxConstraints } from "../layout/box-constraints.js";
+import { PDFElement } from "./pdf-element.js";
+export class PDFDocumentElement extends PDFElement {
+    constructor({ children, defaultTextStyle }) {
         super();
         this.children = children;
+        this.defaultTextStyle = defaultTextStyle;
+    }
+    /** The document-level text defaults; the renderer merges them into the cascade root. */
+    getDefaultTextStyle() {
+        return this.defaultTextStyle;
     }
     calculateLayout(_constraints, _offset, ctx) {
         // The document is the root: each page derives its own geometry, so it ignores the
         // incoming constraints/offset. It has no size of its own.
         const origin = { x: 0, y: 0 };
-        this.children.forEach((child) => child.calculateLayout(new box_constraints_1.BoxConstraints(), origin, ctx));
+        this.children.forEach((child) => child.calculateLayout(new BoxConstraints(), origin, ctx));
         return { width: 0, height: 0 };
     }
     getProps() {
-        return { children: this.children };
+        return { children: this.children, defaultTextStyle: this.defaultTextStyle };
     }
 }
-exports.PDFDocumentElement = PDFDocumentElement;

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

@@ -1,15 +1,40 @@
-import type { FontMetrics } from "../utils/font-metrics";
-import type { PDFPageConfig } from "./page-element";
-import type { BoxConstraints, Offset, Size } from "../layout/box-constraints";
+import type { FontMetrics } from "../utils/font-metrics.js";
+import type { PDFPageConfig } from "./page-element.js";
+import type { ResolvedTextStyle } from "../text/text-style.js";
+import type { OverflowPolicy } from "../layout/fragmentation.js";
+import type { BoxConstraints, Offset, Size } from "../layout/box-constraints.js";
 /**
  * Everything the layout pass needs, threaded explicitly (no global singleton):
  * font metrics for measuring, and the geometry of the page currently being laid out.
  * `PageElement` sets `pageConfig` for its subtree, so each page flips against its own
  * height. The PDF byte writer is deliberately absent - layout must not touch it.
  */
+/**
+ * A positioning frame - the CSS "containing block" that `Positioned` children resolve their
+ * offsets against. A `relative` Box (later the page) creates one and threads it to its subtree;
+ * `Positioned` descendants register a placement closure in `place`, which the frame drains once it
+ * has finished sizing itself (so `right`/`bottom` can resolve against the final box).
+ */
+export interface PositioningFrame {
+    origin: Offset;
+    size: Size;
+    place: Array<(frame: {
+        origin: Offset;
+        size: Size;
+    }, ctx: LayoutContext) => void>;
+}
 export interface LayoutContext {
     metrics: FontMetrics;
     pageConfig: PDFPageConfig;
+    /** The nearest enclosing positioning frame, if any (set by a `relative` Box). */
+    frame?: PositioningFrame;
+    /** The cascaded text style descendants inherit (CSS/Flutter-style). Seeded at the document root
+     *  from the built-in defaults + the `Document` defaults, and carried through page contexts; a
+     *  `Text` resolves its own unset properties against it. Absent falls back to the built-in defaults. */
+    textStyle?: ResolvedTextStyle;
+    /** What to do when an element overflows a page region and cannot break (set from the render option;
+     *  absent = clip silently). Evaluated in `packChildren` where the forced placement happens. */
+    onOverflow?: OverflowPolicy;
 }
 export declare abstract class PDFElement {
     abstract getProps(): unknown;

package/dist/elements/pdf-element.js

@@ -1,13 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VerticalAlignment = exports.HorizontalAlignment = exports.FlexiblePDFElement = exports.SizedPDFElement = exports.PDFElement = void 0;
-exports.isSizedElement = isSizedElement;
-exports.hasChildrenProp = hasChildrenProp;
-exports.hasChildProp = hasChildProp;
-class PDFElement {
+export class PDFElement {
 }
-exports.PDFElement = PDFElement;
-class SizedPDFElement extends PDFElement {
+export class SizedPDFElement extends PDFElement {
     constructor(data) {
         super();
         this.x = data.x;
@@ -19,8 +12,7 @@ class SizedPDFElement extends PDFElement {
         return { x: this.x, y: this.y, width: this.width, height: this.height };
     }
 }
-exports.SizedPDFElement = SizedPDFElement;
-class FlexiblePDFElement extends PDFElement {
+export class FlexiblePDFElement extends PDFElement {
     constructor(data) {
         super();
         this.flex = data.flex;
@@ -30,26 +22,25 @@ class FlexiblePDFElement extends PDFElement {
         return this.flex;
     }
 }
-exports.FlexiblePDFElement = FlexiblePDFElement;
-var HorizontalAlignment;
+export var HorizontalAlignment;
 (function (HorizontalAlignment) {
     HorizontalAlignment["left"] = "LEFT";
     HorizontalAlignment["right"] = "RIGHT";
     HorizontalAlignment["center"] = "CENTER";
     HorizontalAlignment["block"] = "BLOCK";
-})(HorizontalAlignment || (exports.HorizontalAlignment = HorizontalAlignment = {}));
-var VerticalAlignment;
+})(HorizontalAlignment || (HorizontalAlignment = {}));
+export var VerticalAlignment;
 (function (VerticalAlignment) {
     VerticalAlignment["top"] = "TOP";
     VerticalAlignment["middle"] = "MIDDLE";
     VerticalAlignment["bottom"] = "BOTTOM";
-})(VerticalAlignment || (exports.VerticalAlignment = VerticalAlignment = {}));
-function isSizedElement(obj) {
+})(VerticalAlignment || (VerticalAlignment = {}));
+export function isSizedElement(obj) {
     return typeof obj === "object" && obj !== null && "x" in obj && "y" in obj;
 }
-function hasChildrenProp(obj) {
+export function hasChildrenProp(obj) {
     return "children" in obj;
 }
-function hasChildProp(obj) {
+export function hasChildProp(obj) {
     return "child" in obj;
 }