@lpdfio/lpdf 0.5.0 → 0.7.0

package/LICENSE

@@ -1,6 +1,7 @@
 # Lpdf License
 
 Copyright © 2026 Codesense LLC
+
 License inquiries: license@lpdf.io
 
 ---
@@ -39,13 +40,11 @@ Companies and organizations whose total annual gross revenue exceeded **1,000,00
 
 "Production environment" means any environment in which the Software processes real user data or supports live business operations, including staging environments accessible by end users.
 
-Organizations whose revenue crosses the 1,000,000 USD threshold have a **90-day grace period** following the close of their fiscal year to obtain a Professional or Enterprise license. During this grace period, continued use is permitted.
-
 ### Larger Businesses
 
 Companies and organizations whose total annual gross revenue exceeded **10,000,000 USD** in the most recent 12-month fiscal year must obtain an Enterprise License to use Lpdf in production environments.
 
-Organizations whose revenue crosses the 10,000,000 USD threshold have a **90-day grace period** following the close of their fiscal year to obtain an Enterprise license. During this grace period, continued use under a Professional License is permitted.
+Organizations whose revenue crosses the 10,000,000 USD threshold have a **90-day grace period** following the close of their fiscal year to obtain an Enterprise license. During this grace period, continued use under a Professional License is permitted. The licensee remains subject to the terms of their existing Professional License and does not gain Enterprise rights until an Enterprise License is obtained.
 
 ### Supporting Lpdf
 
@@ -57,17 +56,21 @@ Paid licenses directly fund the continued development, maintenance, and improvem
 
 *Applies to: individuals, open-source projects, non-profit organizations, and companies with annual gross revenue under 1,000,000 USD.*
 
-Permission is hereby granted, free of charge, to any person or qualifying organization obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person or qualifying organization obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. Any redistribution of the Software must be made under the terms of this Community License and may not be sublicensed under different terms.
 
 All modifications to the Software made by the licensee remain the intellectual property of the licensee. Codesense LLC claims no ownership over modifications unless they are voluntarily submitted as contributions to the Lpdf project under a separate Contributor License Agreement.
 
 If your organization's annual gross revenue exceeds 1,000,000 USD, your rights under this Community License are automatically terminated upon expiration of the 90-day grace period described above, and you must obtain a Professional or Enterprise license before continuing to use Lpdf in production.
 
+### Governing Law
+
+This license is governed by and construed in accordance with the laws of the State of Texas, United States, without regard to its conflict of law provisions.
+
 ### Disclaimer of Warranty
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL CODESENSE LLC OR ITS CONTRIBUTORS BE LIABLE FOR ANY CLAIM, DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. IN NO EVENT SHALL CODESENSE LLC'S TOTAL CUMULATIVE LIABILITY TO ANY PARTY EXCEED THE GREATER OF (A) THE FEES PAID BY THAT PARTY TO CODESENSE LLC IN THE TWELVE MONTHS PRECEDING THE CLAIM, OR (B) ONE HUNDRED US DOLLARS (USD 100).
+THE SOFTWARE IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL CODESENSE LLC OR ITS CONTRIBUTORS BE LIABLE FOR ANY CLAIM, DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. IN NO EVENT SHALL CODESENSE LLC'S TOTAL CUMULATIVE LIABILITY TO ANY PARTY EXCEED THE GREATER OF (A) THE FEES PAID BY THAT PARTY TO CODESENSE LLC IN THE TWELVE MONTHS PRECEDING THE CLAIM, OR (B) ONE HUNDRED US DOLLARS (USD 100).
 
 ---
 
@@ -97,7 +100,11 @@ Upon payment, the licensee receives a perpetual license for the version of Lpdf
 
 ### Support
 
-Professional License holders receive email support from Codesense LLC.
+Professional License holders receive email support from Codesense LLC with a target response time of 3 business days for standard inquiries. Support terms are further detailed at lpdf.io/support.
+
+### Audit
+
+Codesense LLC may, upon 30 days' written notice and no more than once per calendar year, request a written certification from the licensee confirming their applicable license tier and annual gross revenue for the most recent fiscal year. The licensee agrees to provide such certification within 15 business days of the request.
 
 ### Ownership and Modifications
 
@@ -123,9 +130,9 @@ THIS SOFTWARE IS PROVIDED "AS IS," WITHOUT A WARRANTY OF ANY KIND, EXPRESS OR IM
 
 ### Governing Law and Dispute Resolution
 
-This license is governed by and construed in accordance with the laws of the State of Delaware, United States, without regard to its conflict of law provisions.
+This license is governed by and construed in accordance with the laws of the State of Texas, United States, without regard to its conflict of law provisions.
 
-Any dispute arising out of or relating to this license or the Software shall be resolved by binding arbitration administered by the American Arbitration Association under its Commercial Arbitration Rules. The arbitration shall take place in **Plano, Texas**. Judgment on the award rendered by the arbitrator may be entered in any court of competent jurisdiction.
+Any dispute arising out of or relating to this license or the Software shall be resolved by binding arbitration administered by the American Arbitration Association under its Commercial Arbitration Rules. The arbitration shall take place in Plano, Texas. Judgment on the award rendered by the arbitrator may be entered in any court of competent jurisdiction.
 
 Notwithstanding the foregoing, either party may seek injunctive or other equitable relief in any court of competent jurisdiction to prevent the actual or threatened infringement, misappropriation, or violation of a party's intellectual property rights.
 
@@ -139,16 +146,16 @@ Notwithstanding the foregoing, either party may seek injunctive or other equitab
 
 Licensees agree not to make false statements of fact about Lpdf, Codesense LLC, or its contributors that are intended to cause material harm to the reputation of the project or the company. This clause does not restrict good-faith criticism, bug reports, public discussion of software deficiencies, or reviews based on the licensee's genuine experience.
 
-License rights may not be rented, leased, or transferred to any third party.
+License rights may not be rented, leased, or transferred to any third party, except as expressly permitted under the subsidiary grant below.
 
 ### License Grant
 
-Subject to payment of the applicable license fee, Codesense LLC grants the licensee a non-exclusive, worldwide, royalty-free license to:
+Subject to payment of the applicable license fee, Codesense LLC grants the licensee a non-exclusive, worldwide, royalty-free license for an unlimited number of developers within the licensee's organization to:
 
 - Use, copy, modify, and integrate the Software into unlimited applications and projects
 - Distribute the Software as part of compiled or packaged commercial products
 - Deploy the Software across unlimited servers, environments, and infrastructure
-- Issue license keys to wholly owned subsidiaries and controlled entities
+- Extend license rights to wholly owned subsidiaries and entities in which the licensee holds more than 50% ownership or voting control ("Controlled Entities"), provided such Controlled Entities are identified to Codesense LLC upon request and remain subject to the terms of this license
 
 ### License Fees and Evaluation
 
@@ -158,11 +165,15 @@ Upon payment, the licensee receives a perpetual license for the version of Lpdf
 
 ### Support
 
-Enterprise License holders receive priority support with a defined SLA from Codesense LLC.
+Enterprise License holders receive priority support from Codesense LLC. Supported response times and escalation procedures are defined in the Enterprise Support Policy at lpdf.io/support/enterprise. Custom SLA terms may be negotiated as part of a Master Service Agreement.
 
 ### Contract
 
-Enterprise licensees may request a Master Service Agreement (MSA) in place of the standard Terms of Service. Invoice billing is available upon request.
+Enterprise licensees may request a Master Service Agreement (MSA) in place of the standard Terms of Service available at lpdf.io/terms. To initiate an MSA request, contact license@lpdf.io. The standard terms govern until a fully executed MSA is in place. Invoice billing is available upon request.
+
+### Audit
+
+Codesense LLC may, upon 30 days' written notice and no more than once per calendar year, request a written certification from the licensee confirming their applicable license tier and annual gross revenue for the most recent fiscal year, and may request a list of Controlled Entities covered under the subsidiary grant. The licensee agrees to provide such certification within 15 business days of the request. For Enterprise licensees under an MSA, audit rights may be further defined therein.
 
 ### Ownership and Modifications
 
@@ -188,8 +199,14 @@ THIS SOFTWARE IS PROVIDED "AS IS," WITHOUT A WARRANTY OF ANY KIND, EXPRESS OR IM
 
 ### Governing Law and Dispute Resolution
 
-This license is governed by and construed in accordance with the laws of the State of Delaware, United States, without regard to its conflict of law provisions.
+This license is governed by and construed in accordance with the laws of the State of Texas, United States, without regard to its conflict of law provisions.
 
-Any dispute arising out of or relating to this license or the Software shall be resolved by binding arbitration administered by the American Arbitration Association under its Commercial Arbitration Rules. The arbitration shall take place in **Plano, Texas**. Judgment on the award rendered by the arbitrator may be entered in any court of competent jurisdiction.
+Any dispute arising out of or relating to this license or the Software shall be resolved by binding arbitration administered by the American Arbitration Association under its Commercial Arbitration Rules. The arbitration shall take place in Plano, Texas. Judgment on the award rendered by the arbitrator may be entered in any court of competent jurisdiction.
 
 Notwithstanding the foregoing, either party may seek injunctive or other equitable relief in any court of competent jurisdiction to prevent the actual or threatened infringement, misappropriation, or violation of a party's intellectual property rights.
+
+---
+
+For license purchases and inquiries: license@lpdf.io
+
+Privacy Policy: lpdf.io/privacy | Terms of Service: lpdf.io/terms | Support: lpdf.io/support

package/README.md

@@ -2,7 +2,9 @@
 
 # @lpdfio/lpdf
 
-Node.js adapter for [Lpdf](https://lpdf.io) — an accurate, efficient, and cross-platform PDF engine.
+**Node.js SDK for [Lpdf](https://lpdf.io) — PDF as Code on every platform**
+
+You describe a document as code or XML. Lpdf renders a compact, pixel-perfect PDF — identical across platforms.
 
 ## Installation
 
@@ -13,48 +15,41 @@ npm install @lpdfio/lpdf
 ## Usage — Node.js
 
 ```ts
-import { LpdfEngine } from '@lpdfio/lpdf';
-import { readFileSync, writeFileSync } from 'node:fs';
-
-const engine = new LpdfEngine('');
-
-engine.loadFont('montserrat', readFileSync('fonts/Montserrat-Regular.ttf'));
-engine.loadImage('logo', readFileSync('images/logo.png'));
-
-const xml = readFileSync('document.xml', 'utf8');
-const pdf = await engine.renderPdf(xml);
-
-writeFileSync('output.pdf', pdf);
+import { L, NoAttr } from 'lpdf'
+
+const engine = L.engine()
+
+const doc = L.document({ size: 'letter', margin: '48pt' }, [
+    L.section(NoAttr, [
+        L.layout(NoAttr, [
+            L.stack({ gap: '24pt' }, [
+                L.split(NoAttr, [
+                    L.text({ fontSize: '8pt', color: '#888888' }, ['ACME CORP']),
+                    L.text({ fontSize: '22pt', bold: 'true' }, ['Project Proposal']),
+                ]),
+                L.divider({ thickness: 'xs' }),
+                L.text({ fontSize: '13pt', bold: 'true' }, ['Scope of Work']),
+                L.flank({ gap: '12pt', align: 'start' }, [
+                    L.text({ color: '#888888', width: '24pt' }, ['01']),
+                    L.text(NoAttr, ['Discovery & Research']),
+                ]),
+            ]),
+        ]),
+    ]),
+])
+
+const pdf = await engine.render(doc)
 ```
 
-## Usage — Browser
-
-```ts
-import { LpdfEngine } from '@lpdfio/lpdf/browser';
-
-const engine = new LpdfEngine('');
-
-const xml = `<stack><text>Hello, Lpdf</text></stack>`;
-const pdf = await engine.renderPdf(xml);
+## Requirements
 
-const blob = new Blob([pdf], { type: 'application/pdf' });
-window.open(URL.createObjectURL(blob));
-```
-
-## XML format
+- Node.js 16+
+- No external runtime dependencies — the WASM engine is embedded in the package.
 
-Documents are defined in a layout XML format. See the [Lpdf documentation](https://lpdf.io/docs) and [examples](https://github.com/lpdfio/lpdf/tree/main/docs/examples) for the full schema.
+## Docs
 
-```xml
-<stack spacing="m" padding="l">
-  <text font-size="xl" font="Montserrat-Bold">Invoice #1001</text>
-  <grid columns="2">
-    <text>Date</text>      <text>2026-04-25</text>
-    <text>Due</text>       <text>2026-05-25</text>
-  </grid>
-</stack>
-```
+[lpdf.io/docs/js](https://lpdf.io/docs/js)
 
-## License
+--
 
 Dual-licensed: Community License (free) and Commercial License (paid). See [LICENSE](LICENSE) for full terms.

package/dist/_shared.d.ts

@@ -1,13 +1,10 @@
 /**
  * Shared types used by both the Node.js and browser entry points.
  */
+/** Construction-time configuration for {@link PdfEngine}. Node has no infra options. */
+export interface EngineOptions {
+}
 export interface RenderOptions {
-    /**
-     * Pre-loaded font bytes for custom fonts referenced via <fonts src="…">.
-     * Keys are the font names used in the document; values are raw TTF/OTF bytes.
-     * @deprecated Pass font bytes via `LpdfEngine.loadFont()` instead.
-     */
-    fontBytes?: Record<string, Uint8Array>;
     /**
      * Optional ISO 8601 creation timestamp (e.g. `"2024-06-01T12:00:00"`).
      * When provided, written as `/CreationDate` in the PDF info dictionary.

package/dist/browser.js

@@ -378,63 +378,12 @@ async function __wbg_init(module_or_path) {
   return __wbg_finalize_init(instance, module);
 }
 
-// src/kit.ts
-function attrKey(camel) {
-  return camel.replace(/[A-Z]/g, (c) => "-" + c.toLowerCase());
-}
-function buildAttrs(options) {
-  const result = {};
-  for (const [key, val] of Object.entries(options)) {
-    if (val !== void 0) {
-      result[attrKey(key)] = val;
-    }
-  }
-  return result;
-}
-function layout(nodes = []) {
-  return { type: "layout", nodes };
-}
-function canvas(layers = []) {
-  return { type: "canvas", nodes: layers };
-}
-function section(input = {}) {
-  return {
-    type: "section",
-    attrs: buildAttrs(input.options ?? {}),
-    nodes: input.nodes ?? []
-  };
-}
-function document(input = {}) {
-  const { tokens, meta, ...restOpts } = input.options ?? {};
-  const attrs = {
-    ...buildAttrs(restOpts)
-  };
-  if (tokens !== void 0) attrs["tokens"] = tokens;
-  if (meta !== void 0) attrs["meta"] = meta;
-  return {
-    version: 1,
-    type: "document",
-    attrs,
-    nodes: input.sections ?? []
-  };
-}
-var LpdfKit = Object.freeze({
-  layout,
-  canvas,
-  section,
-  document
-});
-
 // src/browser.ts
-async function initLpdf(wasmSource, licenseKey = "", initOptions = {}) {
+var NoAttr = null;
+async function initLpdf(wasmSource, licenseKey = "") {
   await __wbg_init(wasmSource);
   const fontMap = /* @__PURE__ */ new Map();
   const imageMap = /* @__PURE__ */ new Map();
-  if (initOptions.fontBytes) {
-    for (const [name, bytes] of Object.entries(initOptions.fontBytes)) {
-      fontMap.set(name, bytes);
-    }
-  }
   return {
     loadFont(name, bytes) {
       fontMap.set(name, bytes);
@@ -442,27 +391,37 @@ async function initLpdf(wasmSource, licenseKey = "", initOptions = {}) {
     loadImage(name, bytes) {
       imageMap.set(name, bytes);
     },
-    async renderPdf(xml, callOptions = {}) {
+    async render(input, callOptions = {}) {
       const engine = new LpdfEngine(licenseKey);
       for (const [name, bytes] of fontMap) {
         engine.load_font(name, bytes);
       }
-      if (callOptions.fontBytes) {
-        for (const [name, bytes] of Object.entries(callOptions.fontBytes)) {
-          if (!fontMap.has(name)) engine.load_font(name, bytes);
-        }
-      }
       for (const [name, bytes] of imageMap) {
         engine.load_image(name, bytes);
       }
-      const dataJson = callOptions.data != null ? JSON.stringify(callOptions.data) : null;
-      const pdf = engine.render_pdf(xml, dataJson);
+      if (callOptions.createdOn) {
+        engine.set_created_on(callOptions.createdOn);
+      }
+      let pdf;
+      if (typeof input === "string") {
+        const dataJson = callOptions.data != null ? JSON.stringify(callOptions.data) : null;
+        pdf = engine.render_pdf(input, dataJson);
+      } else {
+        const wasmExt = engine;
+        if (typeof wasmExt.render_tree_pdf === "function") {
+          pdf = wasmExt.render_tree_pdf(JSON.stringify(input));
+        } else {
+          const mod = engine;
+          const xml = mod.constructor.kit_to_xml?.(JSON.stringify(input)) ?? "";
+          pdf = engine.render_pdf(xml, null);
+        }
+      }
       engine.free();
       return pdf;
     }
   };
 }
 export {
-  LpdfKit,
+  NoAttr,
   initLpdf
 };

package/dist/canvas.d.ts

@@ -100,7 +100,9 @@ export interface LpdfCanvasImgNode {
     attrs: Record<string, string>;
 }
 export type LpdfCanvasPrimitiveNode = LpdfCanvasRectNode | LpdfCanvasLineNode | LpdfCanvasEllipseNode | LpdfCanvasCircleNode | LpdfCanvasPathNode | LpdfCanvasTextNode | LpdfCanvasImgNode;
-export interface CanvasLayerOptions {
+/** @deprecated Use {@link LayerAttr} */
+export type CanvasLayerOptions = LayerAttr;
+export interface LayerAttr {
     page?: PageScope | string;
     opacity?: number;
     transform?: CanvasTransform;
@@ -115,17 +117,17 @@ declare function line(x1: number, y1: number, x2: number, y2: number, style?: Ca
 declare function ellipse(cx: number, cy: number, rx: number, ry: number, style?: CanvasEllipseStyle): LpdfCanvasEllipseNode;
 declare function circle(cx: number, cy: number, r: number, style?: CanvasEllipseStyle): LpdfCanvasCircleNode;
 declare function path(d: string, style?: CanvasPathStyle): LpdfCanvasPathNode;
-declare function canvasText(x: number, y: number, content: string, style?: CanvasTextStyle, runs?: CanvasRun[]): LpdfCanvasTextNode;
-declare function img(x: number, y: number, w: number, h: number, name: string): LpdfCanvasImgNode;
-declare function layer(nodes: LpdfCanvasPrimitiveNode[], options?: CanvasLayerOptions): LpdfCanvasLayerNode;
+declare function textAt(x: number, y: number, content: string, style?: CanvasTextStyle, runs?: CanvasRun[]): LpdfCanvasTextNode;
+declare function imgAt(x: number, y: number, w: number, h: number, name: string): LpdfCanvasImgNode;
+declare function layer(attrs: LayerAttr | null, nodes: LpdfCanvasPrimitiveNode[]): LpdfCanvasLayerNode;
 export declare const LpdfCanvas: Readonly<{
     rect: typeof rect;
     line: typeof line;
     ellipse: typeof ellipse;
     circle: typeof circle;
     path: typeof path;
-    text: typeof canvasText;
-    img: typeof img;
+    textAt: typeof textAt;
+    imgAt: typeof imgAt;
     layer: typeof layer;
 }>;
 export {};

package/dist/canvas.js

@@ -124,7 +124,7 @@ function path(d, style) {
         attrs['line-join'] = style.lineJoin;
     return { type: 'canvas-path', attrs };
 }
-function canvasText(x, y, content, style, runs) {
+function textAt(x, y, content, style, runs) {
     const attrs = { x: String(x), y: String(y) };
     if (style?.font !== undefined)
         attrs['font'] = style.font;
@@ -153,21 +153,21 @@ function canvasText(x, y, content, style, runs) {
     }
     return node;
 }
-function img(x, y, w, h, name) {
+function imgAt(x, y, w, h, name) {
     return {
         type: 'canvas-img',
         attrs: { x: String(x), y: String(y), w: String(w), h: String(h), name },
     };
 }
-function layer(nodes, options) {
-    const attrs = {};
-    if (options?.page !== undefined)
-        attrs['page'] = options.page;
-    if (options?.opacity !== undefined)
-        attrs['opacity'] = String(options.opacity);
-    if (options?.transform !== undefined)
-        attrs['transform'] = options.transform.toString();
-    return { type: 'canvas-layer', attrs, nodes };
+function layer(attrs, nodes) {
+    const a = {};
+    if (attrs?.page !== undefined)
+        a['page'] = attrs.page;
+    if (attrs?.opacity !== undefined)
+        a['opacity'] = String(attrs.opacity);
+    if (attrs?.transform !== undefined)
+        a['transform'] = attrs.transform.toString();
+    return { type: 'canvas-layer', attrs: a, nodes };
 }
 exports.LpdfCanvas = Object.freeze({
     rect,
@@ -175,7 +175,7 @@ exports.LpdfCanvas = Object.freeze({
     ellipse,
     circle,
     path,
-    text: canvasText,
-    img,
+    textAt,
+    imgAt,
     layer,
 });

package/dist/engine.d.ts

@@ -1,5 +1,5 @@
 import type { RenderOptions } from './_shared';
-import type { LpdfDocument } from './kit';
+import type { PdfDocument } from './kit';
 /** Thrown when the lpdf engine returns a layout or parse error. */
 export declare class LpdfRenderError extends Error {
     constructor(message: string);
@@ -15,7 +15,7 @@ export interface EncryptPermissions {
     assemble?: boolean;
     print_hq?: boolean;
 }
-/** RC4-128 encryption options passed to {@link LpdfEngine.setEncryption}. */
+/** RC4-128 encryption options passed to {@link PdfEngine.setEncryption}. */
 export interface EncryptOptions {
     /** Open password shown to readers. Empty string = no open password required. */
     userPassword: string;
@@ -24,26 +24,29 @@ export interface EncryptOptions {
     /** Permission flags applied to the document. Omitted flags default to `true`. */
     permissions?: EncryptPermissions;
 }
-export declare class LpdfEngine {
-    private readonly _licenseKey;
-    private readonly _opts;
+export declare class PdfEngine {
+    private _licenseKey;
     private readonly _fonts;
     private readonly _images;
     private _disposed;
     private _encrypt;
-    constructor(licenseKey: string, options?: RenderOptions);
+    constructor();
+    /**
+     * Set the license key. Returns `this` for chaining.
+     */
+    setLicenseKey(key: string): this;
     /**
      * Register raw TTF/OTF bytes for a custom font name used in `<font src="…">`.
-     * Call before `renderPdf`. Returns `this` for chaining.
+     * Call before `render`. Returns `this` for chaining.
      */
     loadFont(name: string, bytes: Uint8Array): this;
     /**
      * Register raw image bytes (PNG or JPEG) for an image name used in `<img name="…">`.
-     * Call before `renderPdf`. Returns `this` for chaining.
+     * Call before `render`. Returns `this` for chaining.
      */
     loadImage(name: string, bytes: Uint8Array): this;
     /**
-     * Configure RC4-128 encryption for all subsequent `renderPdf` calls.
+     * Configure RC4-128 encryption for all subsequent `render` calls.
      * Returns `this` for chaining.
      */
     setEncryption(options: EncryptOptions): this;
@@ -53,7 +56,7 @@ export declare class LpdfEngine {
      */
     clearEncryption(): this;
     /**
-     * Release held resources. Idempotent. Subsequent `renderPdf` / `loadFont`
+     * Release held resources. Idempotent. Subsequent `render` / `loadFont`
      * calls after disposal will throw.
      */
     dispose(): void;
@@ -62,9 +65,9 @@ export declare class LpdfEngine {
     /**
      * Render an lpdf XML string to PDF bytes (Node.js).
      */
-    renderPdf(input: string, callOptions?: RenderOptions): Promise<Uint8Array>;
+    render(input: string, callOptions?: RenderOptions): Promise<Uint8Array>;
     /**
-     * Render an `LpdfDocument` tree (built with `LpdfKit`) to PDF bytes (Node.js).
+     * Render a `PdfDocument` tree (built with `Pdf.document`) to PDF bytes (Node.js).
      */
-    renderPdf(input: LpdfDocument, callOptions?: RenderOptions): Promise<Uint8Array>;
+    render(input: PdfDocument, callOptions?: RenderOptions): Promise<Uint8Array>;
 }

package/dist/engine.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LpdfEngine = exports.LpdfRenderError = void 0;
+exports.PdfEngine = exports.LpdfRenderError = void 0;
 const node_fs_1 = require("node:fs");
 // require() path is relative to the compiled output at dist/engine.js.
 // In the published package, wasm-pack artifacts live in dist/wasm/.
@@ -16,18 +16,25 @@ class LpdfRenderError extends Error {
     }
 }
 exports.LpdfRenderError = LpdfRenderError;
-class LpdfEngine {
-    constructor(licenseKey, options = {}) {
+class PdfEngine {
+    constructor() {
+        this._licenseKey = '';
         this._fonts = new Map();
         this._images = new Map();
         this._disposed = false;
         this._encrypt = null;
-        this._licenseKey = licenseKey;
-        this._opts = options;
+    }
+    /**
+     * Set the license key. Returns `this` for chaining.
+     */
+    setLicenseKey(key) {
+        this._throwIfDisposed();
+        this._licenseKey = key;
+        return this;
     }
     /**
      * Register raw TTF/OTF bytes for a custom font name used in `<font src="…">`.
-     * Call before `renderPdf`. Returns `this` for chaining.
+     * Call before `render`. Returns `this` for chaining.
      */
     loadFont(name, bytes) {
         this._throwIfDisposed();
@@ -36,7 +43,7 @@ class LpdfEngine {
     }
     /**
      * Register raw image bytes (PNG or JPEG) for an image name used in `<img name="…">`.
-     * Call before `renderPdf`. Returns `this` for chaining.
+     * Call before `render`. Returns `this` for chaining.
      */
     loadImage(name, bytes) {
         this._throwIfDisposed();
@@ -44,7 +51,7 @@ class LpdfEngine {
         return this;
     }
     /**
-     * Configure RC4-128 encryption for all subsequent `renderPdf` calls.
+     * Configure RC4-128 encryption for all subsequent `render` calls.
      * Returns `this` for chaining.
      */
     setEncryption(options) {
@@ -62,7 +69,7 @@ class LpdfEngine {
         return this;
     }
     /**
-     * Release held resources. Idempotent. Subsequent `renderPdf` / `loadFont`
+     * Release held resources. Idempotent. Subsequent `render` / `loadFont`
      * calls after disposal will throw.
      */
     dispose() {
@@ -71,28 +78,20 @@ class LpdfEngine {
     [Symbol.dispose]() { this.dispose(); }
     _throwIfDisposed() {
         if (this._disposed)
-            throw new Error('LpdfEngine has been disposed.');
+            throw new Error('PdfEngine has been disposed.');
     }
-    async renderPdf(input, callOptions = {}) {
+    async render(input, callOptions = {}) {
         this._throwIfDisposed();
-        // Merge fonts: instance-level loadFont() calls take precedence over the
-        // deprecated fontBytes option, which is kept for one-version compat.
-        const allFonts = new Map(this._fonts);
-        const extraBytes = { ...this._opts.fontBytes, ...callOptions.fontBytes };
-        for (const [name, bytes] of Object.entries(extraBytes)) {
-            if (!allFonts.has(name))
-                allFonts.set(name, bytes);
-        }
         const engine = new WasmEngine(this._licenseKey);
-        const createdOn = callOptions.createdOn ?? this._opts.createdOn;
-        if (createdOn) {
-            engine.set_created_on(createdOn);
+        if (callOptions.createdOn) {
+            engine.set_created_on(callOptions.createdOn);
         }
         let pdf;
         try {
             if (typeof input === 'string') {
                 // XML path — auto-load fonts and images declared via src="…".
                 const xml = input;
+                const allFonts = new Map(this._fonts);
                 for (const [key, src] of extractAssetSrcs(xml, 'font')) {
                     if (!allFonts.has(key)) {
                         try {
@@ -126,6 +125,7 @@ class LpdfEngine {
             else {
                 // JSON (Kit tree) path — pass JSON directly to render_tree_pdf.
                 const json = JSON.stringify(input);
+                const allFonts = new Map(this._fonts);
                 for (const [key, src] of extractFontSrcsFromJson(json)) {
                     if (!allFonts.has(key)) {
                         try {
@@ -156,7 +156,7 @@ class LpdfEngine {
         return pdf;
     }
 }
-exports.LpdfEngine = LpdfEngine;
+exports.PdfEngine = PdfEngine;
 // ── Helpers ───────────────────────────────────────────────────────────────────
 /** Extract `ref??name → src` pairs from `<font>` or `<image>` tags in XML. */
 function extractAssetSrcs(xml, tag) {