@laminapdf/sdk 0.2.0-alpha.2 → 0.2.0-alpha.4

package/dist/font.js

@@ -1,5 +1,6 @@
-import { guard } from "./errors.js";
+import { packageError } from "./errors.js";
 import { baseModule } from "./init.js";
+import { disposable, forget, watch } from "./internal/handle.js";
 /**
  * A font to draw text with: TrueType or OpenType bytes (subset to the glyphs drawn and embedded)
  * or one of the standard 14. Needs the text module (`init({ text: true })`).
@@ -31,8 +32,8 @@ export class Font {
         return new Font(undefined, name);
     }
 }
-function decode(glue, source) {
-    return guard(() => {
+function decode(instance, source) {
+    return instance.call((glue) => {
         switch (source.kind) {
             case "jpeg":
                 return glue.WasmImage.jpeg(source.bytes);
@@ -48,11 +49,13 @@ function decode(glue, source) {
  * The bytes are copied when the image is created. It is decoded once per WASM module, the first
  * time a builder of that module draws it (or `width`/`height` is read), so problems with the
  * data (`invalid-image`, `unsupported-image`, …) surface there. Written once per document however
- * often it is drawn.
+ * often it is drawn. It keeps its bytes, so it outlives `reset()` and decodes again.
  */
 export class Image {
     #source;
+    /** The decoded copy in each module, with the generation of the instance it lives in. */
     #decoded = new Map();
+    #freed = false;
     constructor(source) {
         this.#source = source;
     }
@@ -70,34 +73,61 @@ export class Image {
     }
     /** Width in pixels (decodes the image if no module has yet). @throws {@link LaminaPdfError} as `in`. */
     get width() {
-        return this.#any().width;
+        const [instance, image] = this.#any();
+        return instance.call(() => image.width);
     }
     /** Height in pixels (decodes the image if no module has yet). @throws {@link LaminaPdfError} as `in`. */
     get height() {
-        return this.#any().height;
+        const [instance, image] = this.#any();
+        return instance.call(() => image.height);
     }
+    /** A decoded copy, in any module (the base module when none has one). */
     #any() {
-        for (const image of this.#decoded.values())
-            return image;
-        return this.in(baseModule());
+        for (const [instance, held] of this.#decoded) {
+            instance.live();
+            if (held.generation === instance.generation)
+                return [instance, held.image];
+        }
+        const base = baseModule();
+        return [base, this.in(base)];
     }
-    /** Frees the image's WASM memory now (otherwise when it is garbage-collected). */
+    /**
+     * Frees the image's WASM memory now; without it, the garbage collector frees it later. A second
+     * call does nothing, and any other call afterwards throws `disposed`. Prefer `using`.
+     */
     free() {
-        for (const image of this.#decoded.values())
-            image.free();
+        if (this.#freed)
+            return;
+        this.#freed = true;
+        forget(this);
+        for (const [instance, held] of this.#decoded) {
+            if (instance.owns(held.generation))
+                held.image.free();
+        }
         this.#decoded.clear();
     }
+    /** Frees the image at the end of a `using` block (an alias of `free()`). */
+    [Symbol.dispose]() {
+        this.free();
+    }
     /**
-     * @internal The image in `glue`'s instance, decoded there at first use.
-     * @throws {@link LaminaPdfError} `invalid-image`, `unsupported-image`, `image-too-large`, `image-data-length`.
+     * @internal The image in `instance`, decoded there at first use (and again after a reset).
+     * @throws {@link LaminaPdfError} `disposed`; `invalid-image`, `unsupported-image`,
+     *   `image-too-large`, `image-data-length`.
      */
-    in(glue) {
-        let image = this.#decoded.get(glue);
-        if (image === undefined) {
-            image = decode(glue, this.#source);
-            this.#decoded.set(glue, image);
-        }
+    in(instance) {
+        if (this.#freed)
+            throw packageError("disposed", "the Image was used after free() or its using block");
+        instance.live();
+        const held = this.#decoded.get(instance);
+        if (held !== undefined && held.generation === instance.generation)
+            return held.image;
+        const image = decode(instance, this.#source);
+        if (this.#decoded.size === 0)
+            watch(this, "Image");
+        this.#decoded.set(instance, { generation: instance.generation, image });
         return image;
     }
 }
+disposable(Image);
 //# sourceMappingURL=font.js.map

package/dist/font.js.map

@@ -1 +1 @@
-{"version":3,"file":"font.js","sourceRoot":"","sources":["../src/font.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"font.js","sourceRoot":"","sources":["../src/font.ts"],"names":[],"mappings":"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"}

package/dist/generated/builder-enums.d.ts

@@ -15,15 +15,15 @@ export declare const BLEND_MODES: readonly ["normal", "multiply", "screen", "ove
 /** Blend modes (`/BM`), camelCase. */
 export type BlendMode = (typeof BLEND_MODES)[number];
 /** Every ArtifactKind, as the WASM module names it. */
-export declare const ARTIFACT_KINDS: readonly ["layout", "page", "pagination", "background"];
-/** What kind of artifact (content outside the logical structure). */
+export declare const ARTIFACT_KINDS: readonly ["layout", "page", "pagination", "background", "header", "footer", "watermark"];
+/** What kind of artifact (content outside the logical structure); `header`, `footer` and `watermark` are pagination artifacts that say which. */
 export type ArtifactKind = (typeof ARTIFACT_KINDS)[number];
 /** Every TableScope, as the WASM module names it. */
 export declare const TABLE_SCOPES: readonly ["row", "column", "both"];
 /** Which header cells a `TH` heads (`/Scope`). */
 export type TableScope = (typeof TABLE_SCOPES)[number];
 /** Every TagName, as the WASM module names it. */
-export declare const TAG_NAMES: readonly ["Document", "Part", "Sect", "H1", "H2", "H3", "H4", "H5", "H6", "P", "L", "LI", "Lbl", "LBody", "Table", "TR", "TH", "TD", "Figure", "Caption", "Link", "Span", "Quote", "Note", "Code"];
+export declare const TAG_NAMES: readonly ["Document", "Part", "Sect", "H1", "H2", "H3", "H4", "H5", "H6", "P", "L", "LI", "Lbl", "LBody", "Table", "TR", "TH", "TD", "Figure", "Caption", "Link", "Span", "Quote", "Note", "Code", "THead", "TBody", "TFoot", "TOC", "TOCI", "Reference", "BlockQuote"];
 /** A standard structure type (ISO 32000-1 §14.8.4). */
 export type TagName = (typeof TAG_NAMES)[number];
 //# sourceMappingURL=builder-enums.d.ts.map

package/dist/generated/builder-enums.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder-enums.d.ts","sourceRoot":"","sources":["../../src/generated/builder-enums.ts"],"names":[],"mappings":"AAGA,mDAAmD;AACnD,eAAO,MAAM,UAAU,YACrB,SAAS,EACT,SAAS,CACD,CAAC;AAEX,2DAA2D;AAC3D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,kDAAkD;AAClD,eAAO,MAAM,SAAS,YACpB,MAAM,EACN,OAAO,EACP,QAAQ,CACA,CAAC;AAEX,oCAAoC;AACpC,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,mDAAmD;AACnD,eAAO,MAAM,UAAU,YACrB,OAAO,EACP,OAAO,EACP,OAAO,CACC,CAAC;AAEX,6BAA6B;AAC7B,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,oDAAoD;AACpD,eAAO,MAAM,WAAW,YACtB,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,KAAK,EACL,YAAY,EACZ,OAAO,EACP,YAAY,CACJ,CAAC;AAEX,sCAAsC;AACtC,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,uDAAuD;AACvD,eAAO,MAAM,cAAc,YACzB,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,YAAY,CACJ,CAAC;AAEX,qEAAqE;AACrE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,qDAAqD;AACrD,eAAO,MAAM,YAAY,YACvB,KAAK,EACL,QAAQ,EACR,MAAM,CACE,CAAC;AAEX,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,kDAAkD;AAClD,eAAO,MAAM,SAAS,YACpB,UAAU,EACV,MAAM,EACN,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,GAAG,EACH,IAAI,EACJ,KAAK,EACL,OAAO,EACP,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,MAAM,EACN,MAAM,EACN,OAAO,EACP,MAAM,EACN,MAAM,CACE,CAAC;AAEX,uDAAuD;AACvD,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"builder-enums.d.ts","sourceRoot":"","sources":["../../src/generated/builder-enums.ts"],"names":[],"mappings":"AAGA,mDAAmD;AACnD,eAAO,MAAM,UAAU,YACrB,SAAS,EACT,SAAS,CACD,CAAC;AAEX,2DAA2D;AAC3D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,kDAAkD;AAClD,eAAO,MAAM,SAAS,YACpB,MAAM,EACN,OAAO,EACP,QAAQ,CACA,CAAC;AAEX,oCAAoC;AACpC,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,mDAAmD;AACnD,eAAO,MAAM,UAAU,YACrB,OAAO,EACP,OAAO,EACP,OAAO,CACC,CAAC;AAEX,6BAA6B;AAC7B,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,oDAAoD;AACpD,eAAO,MAAM,WAAW,YACtB,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,KAAK,EACL,YAAY,EACZ,OAAO,EACP,YAAY,CACJ,CAAC;AAEX,sCAAsC;AACtC,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,uDAAuD;AACvD,eAAO,MAAM,cAAc,YACzB,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,WAAW,CACH,CAAC;AAEX,iJAAiJ;AACjJ,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,qDAAqD;AACrD,eAAO,MAAM,YAAY,YACvB,KAAK,EACL,QAAQ,EACR,MAAM,CACE,CAAC;AAEX,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,kDAAkD;AAClD,eAAO,MAAM,SAAS,YACpB,UAAU,EACV,MAAM,EACN,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,GAAG,EACH,IAAI,EACJ,KAAK,EACL,OAAO,EACP,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,MAAM,EACN,MAAM,EACN,OAAO,EACP,MAAM,EACN,MAAM,EACN,OAAO,EACP,OAAO,EACP,OAAO,EACP,KAAK,EACL,MAAM,EACN,WAAW,EACX,YAAY,CACJ,CAAC;AAEX,uDAAuD;AACvD,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/generated/builder-enums.js

@@ -42,6 +42,9 @@ export const ARTIFACT_KINDS = [
     "page",
     "pagination",
     "background",
+    "header",
+    "footer",
+    "watermark",
 ];
 /** Every TableScope, as the WASM module names it. */
 export const TABLE_SCOPES = [
@@ -76,5 +79,12 @@ export const TAG_NAMES = [
     "Quote",
     "Note",
     "Code",
+    "THead",
+    "TBody",
+    "TFoot",
+    "TOC",
+    "TOCI",
+    "Reference",
+    "BlockQuote",
 ];
 //# sourceMappingURL=builder-enums.js.map

package/dist/generated/builder-enums.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder-enums.js","sourceRoot":"","sources":["../../src/generated/builder-enums.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,4HAA4H;AAE5H,mDAAmD;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,SAAS;IACT,SAAS;CACD,CAAC;AAKX,kDAAkD;AAClD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM;IACN,OAAO;IACP,QAAQ;CACA,CAAC;AAKX,mDAAmD;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO;IACP,OAAO;IACP,OAAO;CACC,CAAC;AAKX,oDAAoD;AACpD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,SAAS;IACT,YAAY;IACZ,WAAW;IACX,WAAW;IACX,WAAW;IACX,YAAY;IACZ,WAAW;IACX,KAAK;IACL,YAAY;IACZ,OAAO;IACP,YAAY;CACJ,CAAC;AAKX,uDAAuD;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,QAAQ;IACR,MAAM;IACN,YAAY;IACZ,YAAY;CACJ,CAAC;AAKX,qDAAqD;AACrD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK;IACL,QAAQ;IACR,MAAM;CACE,CAAC;AAKX,kDAAkD;AAClD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU;IACV,MAAM;IACN,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,GAAG;IACH,GAAG;IACH,IAAI;IACJ,KAAK;IACL,OAAO;IACP,OAAO;IACP,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,QAAQ;IACR,SAAS;IACT,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;CACE,CAAC"}
+{"version":3,"file":"builder-enums.js","sourceRoot":"","sources":["../../src/generated/builder-enums.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,4HAA4H;AAE5H,mDAAmD;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,SAAS;IACT,SAAS;CACD,CAAC;AAKX,kDAAkD;AAClD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM;IACN,OAAO;IACP,QAAQ;CACA,CAAC;AAKX,mDAAmD;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO;IACP,OAAO;IACP,OAAO;CACC,CAAC;AAKX,oDAAoD;AACpD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,SAAS;IACT,YAAY;IACZ,WAAW;IACX,WAAW;IACX,WAAW;IACX,YAAY;IACZ,WAAW;IACX,KAAK;IACL,YAAY;IACZ,OAAO;IACP,YAAY;CACJ,CAAC;AAKX,uDAAuD;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,QAAQ;IACR,MAAM;IACN,YAAY;IACZ,YAAY;IACZ,QAAQ;IACR,QAAQ;IACR,WAAW;CACH,CAAC;AAKX,qDAAqD;AACrD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK;IACL,QAAQ;IACR,MAAM;CACE,CAAC;AAKX,kDAAkD;AAClD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU;IACV,MAAM;IACN,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,GAAG;IACH,GAAG;IACH,IAAI;IACJ,KAAK;IACL,OAAO;IACP,OAAO;IACP,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,QAAQ;IACR,SAAS;IACT,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,KAAK;IACL,MAAM;IACN,WAAW;IACX,YAAY;CACJ,CAAC"}

package/dist/generated/codes.d.ts

@@ -1,9 +1,9 @@
 /** The nine kinds of ADR 0026 §2: what the caller can do about an error. */
 export type ErrorKind = "input" | "io" | "unsupported" | "limit" | "security" | "usage" | "state" | "cancelled" | "internal";
 /** Every error code (ADR 0026 §3; `fixtures/codes.json`). */
-export type ErrorCode = "not-pdf" | "missing-root" | "reference-cycle" | "limit-exceeded" | "strict" | "data-pending" | "source" | "type" | "invalid-structure" | "unset-object" | "repaired-base" | "encrypted-base" | "password-required" | "wrong-password" | "unsupported-security-handler" | "unexpected-eof" | "syntax" | "unsupported-filter" | "decompress" | "nested-transaction" | "no-transaction" | "unknown-page" | "direct-page" | "unsupported-version" | "invalid-op-log" | "saved-not-rebased" | "no-pending-save" | "sink" | "not-rebased" | "sink-not-empty" | "would-invalidate-signatures" | "requires-rewrite" | "invalid-font" | "collection-index" | "unknown-axis" | "font-not-embeddable" | "missing-glyph" | "glyph-out-of-range" | "unknown-font" | "subset-failed" | "invalid-axis-value" | "wrong-document" | "invalid-feature" | "invalid-text-range" | "unsupported-layout-option" | "font-mismatch" | "encoding-full" | "font-not-shapable" | "invalid-image" | "unsupported-image" | "image-too-large" | "image-data-length" | "invalid-icc-profile" | "color-components" | "invalid-color" | "invalid-geometry" | "text-overflow" | "page-index-out-of-range" | "unknown-destination" | "invalid-page-labels" | "profile-version-conflict" | "missing-title" | "missing-lang" | "missing-alt-text" | "untagged-content" | "heading-level-skipped" | "unnumbered-heading-misused" | "invalid-structure-nesting" | "link-without-structure" | "link-without-contents" | "font-not-embedded" | "glyph-without-unicode" | "device-color-without-output-intent" | "embedded-file-forbidden" | "embedded-file-without-mime-type" | "render-too-large" | "render-failed" | "render-backend-unavailable" | "cancelled" | "job-finished" | "document-changed" | "builder-finished" | "invalid-argument" | "source-budget-exceeded" | "unknown-option" | "already-initialized" | "extract-module-not-loaded" | "fetch-failed" | "not-initialized" | "source-changed" | "text-module-not-loaded" | "disposed" | "worker-version-mismatch" | "worker-crashed" | "worker-failed";
+export type ErrorCode = "not-pdf" | "missing-root" | "reference-cycle" | "limit-exceeded" | "strict" | "data-pending" | "source" | "type" | "invalid-structure" | "unset-object" | "repaired-base" | "encrypted-base" | "password-required" | "wrong-password" | "unsupported-security-handler" | "unexpected-eof" | "syntax" | "unsupported-filter" | "decompress" | "nested-transaction" | "no-transaction" | "unknown-page" | "direct-page" | "unsupported-version" | "invalid-op-log" | "saved-not-rebased" | "no-pending-save" | "sink" | "not-rebased" | "sink-not-empty" | "would-invalidate-signatures" | "requires-rewrite" | "invalid-font" | "collection-index" | "unknown-axis" | "font-not-embeddable" | "missing-glyph" | "glyph-out-of-range" | "unknown-font" | "subset-failed" | "invalid-axis-value" | "wrong-document" | "invalid-feature" | "invalid-text-range" | "invalid-spans" | "unsupported-layout-option" | "font-mismatch" | "encoding-full" | "font-not-shapable" | "invalid-image" | "unsupported-image" | "image-too-large" | "image-data-length" | "invalid-icc-profile" | "color-components" | "invalid-color" | "invalid-geometry" | "text-overflow" | "page-index-out-of-range" | "unknown-destination" | "invalid-page-labels" | "tag-element-not-open" | "tag-element-unclosed" | "profile-version-conflict" | "missing-title" | "missing-lang" | "missing-alt-text" | "untagged-content" | "heading-level-skipped" | "unnumbered-heading-misused" | "invalid-structure-nesting" | "link-without-structure" | "link-without-contents" | "font-not-embedded" | "glyph-without-unicode" | "device-color-without-output-intent" | "embedded-file-forbidden" | "embedded-file-without-mime-type" | "flow-content-too-large" | "flow-layout-unstable" | "render-too-large" | "render-failed" | "render-backend-unavailable" | "model-failed" | "model-result-unexpected" | "model-needs-host" | "cancelled" | "job-finished" | "document-changed" | "revision-index-out-of-range" | "builder-finished" | "disposed" | "invalid-argument" | "source-budget-exceeded" | "unknown-option" | "already-initialized" | "extract-module-not-loaded" | "fetch-failed" | "not-initialized" | "source-changed" | "text-module-not-loaded" | "worker-version-mismatch" | "worker-crashed" | "worker-failed" | "wasm-trap" | "out-of-memory" | "instance-reset" | "invalid-command-line" | "invalid-page-range" | "binary-output-to-terminal" | "unknown-code" | "overwrite-refused" | "input-unreadable" | "output-unwritable" | "path-outside-roots";
 /** Every warning code (ADR 0026 §3; `fixtures/codes.json`). */
-export type WarningCode = "missing-header" | "xref-repaired" | "xrefstm-ignored" | "stream-length-recovered" | "stale-generation" | "page-tree-node-skipped" | "page-count-mismatch" | "flate-truncated" | "objstm-index-mismatch" | "object-number-out-of-range" | "aes-padding-invalid" | "perms-mismatch" | "warnings-truncated" | "invalid-box" | "invalid-rotate" | "name-tree-node-skipped" | "outline-cycle" | "outline-item-skipped" | "invalid-date" | "invalid-page-label" | "invalid-entry" | "content-unknown-operator" | "content-bad-operands" | "content-unbalanced-q" | "content-unbalanced-bt" | "content-unbalanced-marked" | "content-syntax" | "content-resource-missing" | "inline-image-unterminated" | "xobject-cycle" | "content-path-unpainted" | "font-invalid" | "cmap-invalid" | "unmapped-glyph" | "tounicode-conflict" | "whole-font-rebuilt";
+export type WarningCode = "missing-header" | "xref-repaired" | "xrefstm-ignored" | "stream-length-recovered" | "stale-generation" | "page-tree-node-skipped" | "page-count-mismatch" | "flate-truncated" | "objstm-index-mismatch" | "object-number-out-of-range" | "aes-padding-invalid" | "perms-mismatch" | "warnings-truncated" | "invalid-box" | "invalid-rotate" | "name-tree-node-skipped" | "outline-cycle" | "outline-item-skipped" | "invalid-date" | "invalid-page-label" | "invalid-entry" | "content-unknown-operator" | "content-bad-operands" | "content-unbalanced-q" | "content-unbalanced-bt" | "content-unbalanced-marked" | "content-syntax" | "content-resource-missing" | "inline-image-unterminated" | "xobject-cycle" | "content-path-unpainted" | "font-invalid" | "cmap-invalid" | "unmapped-glyph" | "extract-limit-blocks" | "extract-reading-order-ambiguous" | "extract-table-ambiguous" | "extract-table-limit" | "extract-struct-tree-ignored" | "extract-untagged-content" | "extract-needs-ocr" | "extract-column-order-uncertain" | "tounicode-conflict" | "whole-font-rebuilt" | "flow-keep-broken" | "markdown-html-ignored" | "markdown-image-missing" | "covered-text" | "redaction-not-applied" | "text-in-earlier-revision";
 /** The names of the `Limits` (ADR 0003 §3), as `data.limit` of `limit-exceeded`. */
 export type LimitName = "max_nesting_depth" | "max_stream_decoded" | "max_decoded_total" | "max_filter_chain" | "max_resolve_depth" | "max_page_tree_depth" | "max_tree_depth" | "max_string_length" | "max_content_operators" | "max_xobject_depth" | "max_image_pixels" | "max_read_window";
 /** Every error code, in `codes.json` order. */
@@ -49,6 +49,10 @@ export declare const RAISED_BY_PACKAGE: {
         readonly kind: "state";
         readonly hint: "create a new builder or page: a finished one takes no more drawing, pages, fonts or settings";
     };
+    readonly disposed: {
+        readonly kind: "state";
+        readonly hint: "free a handle only after its last use; to keep working, open the document again or create a new builder";
+    };
     readonly "invalid-argument": {
         readonly kind: "usage";
         readonly hint: "pass the value the type declarations describe; the data field says what was wrong";
@@ -77,10 +81,6 @@ export declare const RAISED_BY_PACKAGE: {
         readonly kind: "state";
         readonly hint: "load the text module with init and the text option, or with loadText, before creating the builder that draws text";
     };
-    readonly disposed: {
-        readonly kind: "state";
-        readonly hint: "free a handle only after its last use; to keep working, open the document again or create a new builder";
-    };
     readonly "worker-version-mismatch": {
         readonly kind: "usage";
         readonly hint: "serve the worker file from the same @laminapdf/sdk build as the page; don't load it from a CDN or an older deploy";
@@ -93,5 +93,17 @@ export declare const RAISED_BY_PACKAGE: {
         readonly kind: "internal";
         readonly hint: "this is a bug in Lamina PDF: report it with the call and the message; the worker keeps running";
     };
+    readonly "wasm-trap": {
+        readonly kind: "internal";
+        readonly hint: "open the document again and retry; report the file and the call if it traps again";
+    };
+    readonly "out-of-memory": {
+        readonly kind: "limit";
+        readonly hint: "open fewer or smaller documents at once and free each when done; lower the open limits so hostile files fail sooner";
+    };
+    readonly "instance-reset": {
+        readonly kind: "state";
+        readonly hint: "open the document again or create a new builder: nothing from the old instance survives";
+    };
 };
 //# sourceMappingURL=codes.d.ts.map

package/dist/generated/codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../src/generated/codes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../src/generated/codes.ts"],"names":[],"mappings":"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"}

package/dist/generated/codes.js

@@ -46,6 +46,7 @@ export const ERROR_CODES = [
     "wrong-document",
     "invalid-feature",
     "invalid-text-range",
+    "invalid-spans",
     "unsupported-layout-option",
     "font-mismatch",
     "encoding-full",
@@ -62,6 +63,8 @@ export const ERROR_CODES = [
     "page-index-out-of-range",
     "unknown-destination",
     "invalid-page-labels",
+    "tag-element-not-open",
+    "tag-element-unclosed",
     "profile-version-conflict",
     "missing-title",
     "missing-lang",
@@ -77,13 +80,20 @@ export const ERROR_CODES = [
     "device-color-without-output-intent",
     "embedded-file-forbidden",
     "embedded-file-without-mime-type",
+    "flow-content-too-large",
+    "flow-layout-unstable",
     "render-too-large",
     "render-failed",
     "render-backend-unavailable",
+    "model-failed",
+    "model-result-unexpected",
+    "model-needs-host",
     "cancelled",
     "job-finished",
     "document-changed",
+    "revision-index-out-of-range",
     "builder-finished",
+    "disposed",
     "invalid-argument",
     "source-budget-exceeded",
     "unknown-option",
@@ -93,10 +103,20 @@ export const ERROR_CODES = [
     "not-initialized",
     "source-changed",
     "text-module-not-loaded",
-    "disposed",
     "worker-version-mismatch",
     "worker-crashed",
     "worker-failed",
+    "wasm-trap",
+    "out-of-memory",
+    "instance-reset",
+    "invalid-command-line",
+    "invalid-page-range",
+    "binary-output-to-terminal",
+    "unknown-code",
+    "overwrite-refused",
+    "input-unreadable",
+    "output-unwritable",
+    "path-outside-roots",
 ];
 /** Every warning code, in `codes.json` order. */
 export const WARNING_CODES = [
@@ -134,8 +154,22 @@ export const WARNING_CODES = [
     "font-invalid",
     "cmap-invalid",
     "unmapped-glyph",
+    "extract-limit-blocks",
+    "extract-reading-order-ambiguous",
+    "extract-table-ambiguous",
+    "extract-table-limit",
+    "extract-struct-tree-ignored",
+    "extract-untagged-content",
+    "extract-needs-ocr",
+    "extract-column-order-uncertain",
     "tounicode-conflict",
     "whole-font-rebuilt",
+    "flow-keep-broken",
+    "markdown-html-ignored",
+    "markdown-image-missing",
+    "covered-text",
+    "redaction-not-applied",
+    "text-in-earlier-revision",
 ];
 /** The kind of every code. */
 export const KINDS = {
@@ -173,6 +207,14 @@ export const KINDS = {
     "font-invalid": "input",
     "cmap-invalid": "input",
     "unmapped-glyph": "input",
+    "extract-limit-blocks": "limit",
+    "extract-reading-order-ambiguous": "unsupported",
+    "extract-table-ambiguous": "unsupported",
+    "extract-table-limit": "limit",
+    "extract-struct-tree-ignored": "input",
+    "extract-untagged-content": "input",
+    "extract-needs-ocr": "unsupported",
+    "extract-column-order-uncertain": "unsupported",
     "not-pdf": "input",
     "missing-root": "input",
     "reference-cycle": "input",
@@ -217,6 +259,7 @@ export const KINDS = {
     "wrong-document": "usage",
     "invalid-feature": "usage",
     "invalid-text-range": "usage",
+    "invalid-spans": "usage",
     "unsupported-layout-option": "unsupported",
     "font-mismatch": "usage",
     "encoding-full": "limit",
@@ -235,6 +278,8 @@ export const KINDS = {
     "page-index-out-of-range": "usage",
     "unknown-destination": "usage",
     "invalid-page-labels": "usage",
+    "tag-element-not-open": "usage",
+    "tag-element-unclosed": "usage",
     "profile-version-conflict": "usage",
     "missing-title": "usage",
     "missing-lang": "usage",
@@ -250,13 +295,26 @@ export const KINDS = {
     "device-color-without-output-intent": "usage",
     "embedded-file-forbidden": "usage",
     "embedded-file-without-mime-type": "usage",
+    "flow-content-too-large": "usage",
+    "flow-layout-unstable": "internal",
+    "flow-keep-broken": "usage",
+    "markdown-html-ignored": "unsupported",
+    "markdown-image-missing": "usage",
     "render-too-large": "limit",
     "render-failed": "input",
     "render-backend-unavailable": "io",
+    "model-failed": "internal",
+    "model-result-unexpected": "usage",
+    "model-needs-host": "usage",
     "cancelled": "cancelled",
     "job-finished": "state",
     "document-changed": "state",
+    "revision-index-out-of-range": "usage",
+    "covered-text": "security",
+    "redaction-not-applied": "security",
+    "text-in-earlier-revision": "security",
     "builder-finished": "state",
+    "disposed": "state",
     "invalid-argument": "usage",
     "source-budget-exceeded": "limit",
     "unknown-option": "usage",
@@ -266,10 +324,20 @@ export const KINDS = {
     "not-initialized": "state",
     "source-changed": "io",
     "text-module-not-loaded": "state",
-    "disposed": "state",
     "worker-version-mismatch": "usage",
     "worker-crashed": "internal",
     "worker-failed": "internal",
+    "wasm-trap": "internal",
+    "out-of-memory": "limit",
+    "instance-reset": "state",
+    "invalid-command-line": "usage",
+    "invalid-page-range": "usage",
+    "binary-output-to-terminal": "usage",
+    "unknown-code": "usage",
+    "overwrite-refused": "state",
+    "input-unreadable": "io",
+    "output-unwritable": "io",
+    "path-outside-roots": "security",
 };
 /** The hint of every code (ADR 0026 §5), with its `{limit}`/`{option}` parameters unfilled. */
 export const HINTS = {
@@ -307,6 +375,14 @@ export const HINTS = {
     "font-invalid": "nothing to do; extracted text or positions for that font may be off",
     "cmap-invalid": "nothing to do; the bad entries were skipped and the rest of the CMap is used",
     "unmapped-glyph": "nothing to do; those glyphs extract as U+FFFD (the file needs a ToUnicode CMap)",
+    "extract-limit-blocks": "raise ExtractLimits::max_blocks_per_page if the page really has that many blocks",
+    "extract-reading-order-ambiguous": "nothing to do; check the order of that page's blocks, or ask for content order",
+    "extract-table-ambiguous": "nothing to do; check that table's cells, whose text may be split across neighbours",
+    "extract-table-limit": "raise ExtractLimits::max_table_cells if the page really has a table that big",
+    "extract-struct-tree-ignored": "nothing to do; ReadingOrder::Tagged uses the tree anyway",
+    "extract-untagged-content": "nothing to do; tag that text in the file to give it a place in the reading order",
+    "extract-needs-ocr": "run OCR or a vision model on this page; the page's textLayer in the JSON says which case it is",
+    "extract-column-order-uncertain": "check the page, or send it to a layout model; the warning's reason says which guess was made",
     "not-pdf": "check that the bytes passed to open are a PDF file",
     "missing-root": "use another copy of the file: this one has no usable catalog",
     "reference-cycle": "use another copy of the file, or repair it with another tool",
@@ -351,6 +427,7 @@ export const HINTS = {
     "wrong-document": "use one FontRegistry per document and finish it with that document",
     "invalid-feature": "write it as liga=0, -liga, smcp or aalt=2 (HarfBuzz syntax without ranges)",
     "invalid-text-range": "take ranges from Lamina PDF's results (line_breaks, itemize, break_lines) and pass the same text",
+    "invalid-spans": "give spans in text order, each starting where the one before ends, from byte 0 to the end of the text, between grapheme clusters, each with at least one font from the list",
     "unsupported-layout-option": "leave the option at its default; justification comes with a later release",
     "font-mismatch": "pass the key of the font the run was shaped with (the font index of each line run maps to your keys)",
     "encoding-full": "embed a font with Font::from_bytes, or split the text across two registrations of the standard font",
@@ -369,6 +446,8 @@ export const HINTS = {
     "page-index-out-of-range": "use a 0-based index below the document's page count",
     "unknown-destination": "define it with Builder::destination before the build finishes, or link to a page",
     "invalid-page-labels": "give ranges sorted by first page, the first at page 0, numbered from 1",
+    "tag-element-not-open": "resume and close only elements this builder's pages opened with open_element, and close each once",
+    "tag-element-unclosed": "close each element from open_element with Builder::close_element once its last page is finished",
     "profile-version-conflict": "leave the version at 1.7 (the default) or lower; PDF 2.0 needs PDF/A-4 or PDF/UA-2, which Lamina PDF doesn't write yet",
     "missing-title": "set a title with Builder::metadata (Metadata::with_title)",
     "missing-lang": "set the language with Builder::lang, such as \"en-GB\"",
@@ -380,17 +459,30 @@ export const HINTS = {
     "link-without-structure": "draw links outside artifacts, so the builder gives each one a Link element",
     "link-without-contents": "pass a description as the link's contents",
     "font-not-embedded": "load a font file with Builder::font instead of Builder::standard_font",
-    "glyph-without-unicode": "use text whose glyphs each stand for characters, or choose PDF/A-2b, which doesn't need Unicode",
+    "glyph-without-unicode": "remove NUL characters (U+0000) from the text, or choose PDF/A-2b, which doesn't need Unicode",
     "device-color-without-output-intent": "use RGB or gray colours, or a CMYK colour with an ICC profile (Color::icc)",
     "embedded-file-forbidden": "choose PDF/A-3b, which allows attached files of any kind",
     "embedded-file-without-mime-type": "pass the file's MIME type, such as text/xml or application/octet-stream",
+    "flow-content-too-large": "make the figure smaller, the text size smaller or the page's margins narrower",
+    "flow-layout-unstable": "report the flow that fails; a page break after the contents block may avoid it until it is fixed",
+    "flow-keep-broken": "split the keep group or drop keep-with-next on a heading chain, or use a taller page",
+    "markdown-html-ignored": "write the content in Markdown instead of HTML, or remove the HTML",
+    "markdown-image-missing": "pass the image's bytes with MarkdownBuildOptions::with_image under the path the Markdown uses",
     "render-too-large": "request smaller tiles (256 to 512 pixels at high zoom) or raise RenderLimits if the larger bitmap is intended",
     "render-failed": "the file may be damaged or use a feature this engine can't draw; try the other backend, or report the file",
     "render-backend-unavailable": "run cargo xtask fetch-pdfium or set LAMINA_PDF_PDFIUM_DIR to the folder holding the PDFium library",
+    "model-failed": "check the plug-in's own logs; extract without the model to get the rules-only result",
+    "model-result-unexpected": "call provide only while request() returns a request, with the result its kind asks for",
+    "model-needs-host": "step an extraction job and hand it each result with provide, or give the plug-in a page renderer",
     "cancelled": "nothing to do: this is the outcome the caller asked for; start a new job to try again",
     "job-finished": "stop stepping a job once a step returned its result or an error; create a new job",
     "document-changed": "pass the document the job was created from, and don't change it while the job runs; create a new job",
+    "revision-index-out-of-range": "ask for an index below the document's revision count",
+    "covered-text": "remove the text itself with a tool that deletes what a redaction covers, then save a full rewrite",
+    "redaction-not-applied": "apply the redactions in a tool that removes what they cover, then save a full rewrite",
+    "text-in-earlier-revision": "save the file as a full rewrite, which keeps only the latest revision",
     "builder-finished": "create a new builder or page: a finished one takes no more drawing, pages, fonts or settings",
+    "disposed": "free a handle only after its last use; to keep working, open the document again or create a new builder",
     "invalid-argument": "pass the value the type declarations describe; the data field says what was wrong",
     "source-budget-exceeded": "raise the source's budget, or open the file with fewer bytes fetched (smaller blocks, no readahead)",
     "unknown-option": "remove the key or correct its spelling; didYouMean lists the closest known names",
@@ -400,10 +492,20 @@ export const HINTS = {
     "not-initialized": "await init() once before calling anything else in @laminapdf/sdk",
     "source-changed": "open the file again; the document already read parts of the old version and can't mix in the new one",
     "text-module-not-loaded": "load the text module with init and the text option, or with loadText, before creating the builder that draws text",
-    "disposed": "free a handle only after its last use; to keep working, open the document again or create a new builder",
     "worker-version-mismatch": "serve the worker file from the same @laminapdf/sdk build as the page; don't load it from a CDN or an older deploy",
     "worker-crashed": "call client.restart() and open the document again; report the file if it keeps happening",
     "worker-failed": "this is a bug in Lamina PDF: report it with the call and the message; the worker keeps running",
+    "wasm-trap": "open the document again and retry; report the file and the call if it traps again",
+    "out-of-memory": "open fewer or smaller documents at once and free each when done; lower the open limits so hostile files fail sooner",
+    "instance-reset": "open the document again or create a new builder: nothing from the old instance survives",
+    "invalid-command-line": "run the command with --help to see its arguments",
+    "invalid-page-range": "write pages as 1-5, z for the last page, r2 for the second from the end, or x3 to leave page 3 out; data.position is the character where the range went wrong",
+    "binary-output-to-terminal": "redirect standard output to a file or a pipe, or write to a file with -o",
+    "unknown-code": "check the spelling against didYouMean, or list every code at the docs URL",
+    "overwrite-refused": "pass --force, or write to a new file with -o",
+    "input-unreadable": "check that the file exists and that you can read it; data.input names it",
+    "output-unwritable": "check that the output's folder exists, that you can write to it and that the disk has room",
+    "path-outside-roots": "use a path inside one of the server's --root folders, or start the server with another --root",
 };
 /** `docsUrl` = base + code + suffix (ADR 0026 §6). */
 export const DOCS_URL = { base: "https://github.com/laudebugs/laminapdf/blob/main/docs/errors/", suffix: ".md" };
@@ -419,14 +521,18 @@ export const ERROR_GROUPS = [
     "textErrors",
     "buildErrors",
     "renderErrors",
+    "extractErrors",
     "facadeErrors",
     "bindingErrors",
     "packageErrors",
+    "cliErrors",
 ];
 /** The groups of `codes.json` that list warnings. */
 export const WARNING_GROUPS = [
     "warnings",
     "textWarnings",
+    "buildWarnings",
+    "facadeWarnings",
 ];
 /** The groups whose codes only `@laminapdf/sdk` raises (not in the Rust enums or the WASM). */
 export const TS_ONLY_GROUPS = [
@@ -438,6 +544,7 @@ export const RAISED_BY_PACKAGE = {
     "no-transaction": { kind: "state", hint: "call begin first, or use transact" },
     "cancelled": { kind: "cancelled", hint: "nothing to do: this is the outcome the caller asked for; start a new job to try again" },
     "builder-finished": { kind: "state", hint: "create a new builder or page: a finished one takes no more drawing, pages, fonts or settings" },
+    "disposed": { kind: "state", hint: "free a handle only after its last use; to keep working, open the document again or create a new builder" },
     "invalid-argument": { kind: "usage", hint: "pass the value the type declarations describe; the data field says what was wrong" },
     "already-initialized": { kind: "state", hint: "call init and loadText with a source once, before the first load; later calls need no source" },
     "extract-module-not-loaded": { kind: "state", hint: "load the extract module (init with the extract option, or loadExtract) or the text module before opening the document" },
@@ -445,9 +552,11 @@ export const RAISED_BY_PACKAGE = {
     "not-initialized": { kind: "state", hint: "await init() once before calling anything else in @laminapdf/sdk" },
     "source-changed": { kind: "io", hint: "open the file again; the document already read parts of the old version and can't mix in the new one" },
     "text-module-not-loaded": { kind: "state", hint: "load the text module with init and the text option, or with loadText, before creating the builder that draws text" },
-    "disposed": { kind: "state", hint: "free a handle only after its last use; to keep working, open the document again or create a new builder" },
     "worker-version-mismatch": { kind: "usage", hint: "serve the worker file from the same @laminapdf/sdk build as the page; don't load it from a CDN or an older deploy" },
     "worker-crashed": { kind: "internal", hint: "call client.restart() and open the document again; report the file if it keeps happening" },
     "worker-failed": { kind: "internal", hint: "this is a bug in Lamina PDF: report it with the call and the message; the worker keeps running" },
+    "wasm-trap": { kind: "internal", hint: "open the document again and retry; report the file and the call if it traps again" },
+    "out-of-memory": { kind: "limit", hint: "open fewer or smaller documents at once and free each when done; lower the open limits so hostile files fail sooner" },
+    "instance-reset": { kind: "state", hint: "open the document again or create a new builder: nothing from the old instance survives" },
 };
 //# sourceMappingURL=codes.js.map