@laminapdf/sdk 0.2.0-alpha.3 → 0.2.0-alpha.5

package/docs/pages/reference/stability.md

@@ -1,7 +1,7 @@
 ---
 title: "Stability policy"
 description: "What a Lamina PDF version number promises, and what stays the same in every version."
-version: "0.2.0-alpha.3"
+version: "0.2.0-alpha.5"
 url: "https://docs.laminapdf.com/reference/stability/"
 ---
 
@@ -17,7 +17,7 @@ Every crate and every npm package shares one version, and they are released toge
 
 ## What a version number tells you
 
-- **Alphas promise nothing to each other.** Anything can change between `0.2.0-alpha.1` and `0.2.0-alpha.2`. While you try an alpha, pin the exact version: `npm install --save-exact @laminapdf/sdk@0.2.0-alpha.3`, and `laminapdf = "=0.2.0-alpha.3"` in `Cargo.toml`.
+- **Alphas promise nothing to each other.** Anything can change between `0.2.0-alpha.1` and `0.2.0-alpha.2`. While you try an alpha, pin the exact version: `npm install --save-exact @laminapdf/sdk@0.2.0-alpha.5`, and `laminapdf = "=0.2.0-alpha.5"` in `Cargo.toml`.
 - **The `alpha` tag names the newest alpha.** `npm install @laminapdf/sdk@alpha` gets it. A plain `npm install @laminapdf/sdk` gets a `0.0.0` placeholder that only reserves the name.
 - **After the alphas, `0.x` versions follow SemVer as Cargo reads it.** A breaking change raises the minor version (`0.2` to `0.3`), and features and fixes raise the patch (`0.2.0` to `0.2.1`). So an upgrade within one `0.x` line never needs a code change.
 
@@ -40,7 +40,7 @@ Four promises hold across every version, `0.x` and alphas included:
 - **Error and warning codes are never renamed or reused** for another meaning. A retired code stays in the [code reference](../../errors/README.md) with the version that retired it, and keeps its page. New codes can appear in any release, so handle a code you don't know.
 - **The error object only grows.** Each error names its schema, `laminapdf.error/1`. Within one schema, a field can be added, but never removed or given another type.
 - **Saved edit logs keep loading.** A log names its format version (`{ v: 1, ops }`, as [Edit a PDF](../../pages/guides/edit-a-pdf.md#replay-edits-stored-as-json) shows). A new op or optional field keeps the version. A changed or removed one raises it, and every older version still loads.
-- **The same input gives the same bytes everywhere.** With the same input, options and version, Rust and every JavaScript runtime write identical files.
+- **The same input gives the same bytes everywhere.** With the same input, options and version, Rust and every JavaScript runtime write identical files, so you can [test your PDFs against reference PDFs](../../pages/guides/test-generated-pdfs.md).
 
 ## How the promises are checked
 

package/docs/pages/start/coding-agents.md

@@ -1,7 +1,7 @@
 ---
 title: "Use Lamina PDF with coding agents"
 description: "Point a coding agent at the docs inside the installed package, so its answers match the version you use."
-version: "0.2.0-alpha.3"
+version: "0.2.0-alpha.5"
 url: "https://docs.laminapdf.com/start/coding-agents/"
 ---
 

package/docs/pages/start/first-pdf.md

@@ -1,7 +1,7 @@
 ---
 title: "Your first PDF"
 description: "Write hello.pdf from Node in five minutes."
-version: "0.2.0-alpha.3"
+version: "0.2.0-alpha.5"
 url: "https://docs.laminapdf.com/start/first-pdf/"
 ---
 
@@ -18,7 +18,7 @@ You need Node 24.2 or newer, which runs `.ts` files directly. Create a folder an
 ```sh
 mkdir hello-pdf && cd hello-pdf
 npm init -y && npm pkg set type=module
-npm install @laminapdf/sdk@0.2.0-alpha.3
+npm install @laminapdf/sdk@0.2.0-alpha.5
 ```
 
 Lamina PDF is in alpha, so the install names the version these docs describe. `@laminapdf/sdk` brings its WebAssembly modules, `@laminapdf/wasm`, with it. [Install](../../pages/install.md) covers other package managers and Rust.
@@ -27,6 +27,8 @@ Lamina PDF is in alpha, so the install names the version these docs describe. `@
 
 Save this app as `hello.ts`. It loads Lamina PDF, builds the page and writes it to `hello.pdf`:
 
+**TypeScript**
+
 `packages/sdk/examples/quick-start/node.ts`:
 
 ```ts
@@ -62,6 +64,8 @@ export async function hello(
 if (import.meta.main) await hello();
 ```
 
+**Result:** [hello.pdf](https://docs.laminapdf.com/examples/pdf/hello.pdf)
+
 ## Run it
 
 ```sh

package/docs/pages/troubleshooting.md

@@ -1,7 +1,7 @@
 ---
 title: "Troubleshooting"
 description: "The problems people hit with Lamina PDF, from a missing init() to a signed file that won't save, with the cause and the fix of each."
-version: "0.2.0-alpha.3"
+version: "0.2.0-alpha.5"
 url: "https://docs.laminapdf.com/troubleshooting/"
 ---
 

package/docs/schemas/error.schema.json

@@ -49,6 +49,7 @@
             "wrong-document",
             "invalid-feature",
             "invalid-text-range",
+            "invalid-spans",
             "unsupported-layout-option",
             "font-mismatch",
             "encoding-full",
@@ -65,6 +66,8 @@
             "page-index-out-of-range",
             "unknown-destination",
             "invalid-page-labels",
+            "tag-element-not-open",
+            "tag-element-unclosed",
             "profile-version-conflict",
             "missing-title",
             "missing-lang",
@@ -80,12 +83,18 @@
             "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",
@@ -250,8 +259,16 @@
             "extract-table-limit",
             "extract-struct-tree-ignored",
             "extract-untagged-content",
+            "extract-needs-ocr",
+            "extract-column-order-uncertain",
             "tounicode-conflict",
-            "whole-font-rebuilt"
+            "whole-font-rebuilt",
+            "flow-keep-broken",
+            "markdown-html-ignored",
+            "markdown-image-missing",
+            "covered-text",
+            "redaction-not-applied",
+            "text-in-earlier-revision"
           ]
         },
         "data": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laminapdf/sdk",
-  "version": "0.2.0-alpha.3",
+  "version": "0.2.0-alpha.5",
   "description": "Create, read, edit and save PDFs from TypeScript: Lamina PDF's Rust core as WebAssembly, synchronous after init(), in browsers, Node, Deno, Bun and Cloudflare Workers.",
   "license": "MIT OR Apache-2.0",
   "homepage": "https://laminapdf.com",
@@ -65,7 +65,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@laminapdf/wasm": "0.2.0-alpha.3"
+    "@laminapdf/wasm": "0.2.0-alpha.5"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.5",
@@ -82,7 +82,9 @@
     "vite": "8.3.5",
     "vitest": "5.0.5",
     "wrangler": "4.152.0",
-    "@laminapdf/test-utils": "0.0.0"
+    "@laminapdf/render": "0.2.0-alpha.5",
+    "@laminapdf/test-utils": "0.0.0",
+    "@laminapdf/render-hayro": "0.2.0-alpha.5"
   },
   "publishConfig": {
     "access": "public"

package/schemas/error.schema.json

@@ -49,6 +49,7 @@
             "wrong-document",
             "invalid-feature",
             "invalid-text-range",
+            "invalid-spans",
             "unsupported-layout-option",
             "font-mismatch",
             "encoding-full",
@@ -65,6 +66,8 @@
             "page-index-out-of-range",
             "unknown-destination",
             "invalid-page-labels",
+            "tag-element-not-open",
+            "tag-element-unclosed",
             "profile-version-conflict",
             "missing-title",
             "missing-lang",
@@ -80,12 +83,18 @@
             "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",
@@ -250,8 +259,16 @@
             "extract-table-limit",
             "extract-struct-tree-ignored",
             "extract-untagged-content",
+            "extract-needs-ocr",
+            "extract-column-order-uncertain",
             "tounicode-conflict",
-            "whole-font-rebuilt"
+            "whole-font-rebuilt",
+            "flow-keep-broken",
+            "markdown-html-ignored",
+            "markdown-image-missing",
+            "covered-text",
+            "redaction-not-applied",
+            "text-in-earlier-revision"
           ]
         },
         "data": {