@laminapdf/sdk 0.0.0-stage → 0.2.0-alpha.3

package/docs/api/classes/Font.md

@@ -0,0 +1,74 @@
+---
+version: "0.2.0-alpha.3"
+---
+
+[**@laminapdf/sdk**](../README.md)
+
+***
+
+[@laminapdf/sdk](../README.md) / Font
+
+# Class: Font
+
+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 })`).
+
+## Example
+
+```ts
+const inter = Font.fromBytes(await (await fetch("/Inter.ttf")).arrayBuffer());
+surface.text("Hello", { font: inter, size: 12, at: [72, 72] });
+```
+
+## Properties
+
+### bytes
+
+> `readonly` **bytes**: `Uint8Array`\<`ArrayBufferLike`\> \| `undefined`
+
+The font program, for a font loaded from bytes.
+
+***
+
+### standard
+
+> `readonly` **standard**: [`Standard14`](../type-aliases/Standard14.md) \| `undefined`
+
+The PostScript name, for a standard 14 font.
+
+## Methods
+
+### fromBytes()
+
+> `static` **fromBytes**(`bytes`): `Font`
+
+A font from its bytes (TrueType or OpenType/CFF). The bytes are checked when a builder first
+uses the font (`invalid-font`, `font-not-embeddable`).
+
+#### Parameters
+
+##### bytes
+
+`ArrayBuffer` \| `Uint8Array`\<`ArrayBufferLike`\>
+
+#### Returns
+
+`Font`
+
+***
+
+### standard()
+
+> `static` **standard**(`name`): `Font`
+
+One of the standard 14 fonts.
+
+#### Parameters
+
+##### name
+
+[`Standard14`](../type-aliases/Standard14.md)
+
+#### Returns
+
+`Font`

package/docs/api/classes/Image.md

@@ -0,0 +1,140 @@
+---
+version: "0.2.0-alpha.3"
+---
+
+[**@laminapdf/sdk**](../README.md)
+
+***
+
+[@laminapdf/sdk](../README.md) / Image
+
+# Class: Image
+
+An image to draw: a JPEG (passed through), a PNG (alpha as a soft mask) or raw RGBA pixels.
+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. It keeps its bytes, so it outlives `reset()` and decodes again.
+
+## Accessors
+
+### height
+
+#### Get Signature
+
+> **get** **height**(): `number`
+
+Height in pixels (decodes the image if no module has yet).
+
+##### Throws
+
+[LaminaPdfError](LaminaPdfError.md) as `in`.
+
+##### Returns
+
+`number`
+
+***
+
+### width
+
+#### Get Signature
+
+> **get** **width**(): `number`
+
+Width in pixels (decodes the image if no module has yet).
+
+##### Throws
+
+[LaminaPdfError](LaminaPdfError.md) as `in`.
+
+##### Returns
+
+`number`
+
+## Methods
+
+### \[dispose\]()
+
+> **\[dispose\]**(): `void`
+
+Frees the image at the end of a `using` block (an alias of `free()`).
+
+#### Returns
+
+`void`
+
+***
+
+### free()
+
+> **free**(): `void`
+
+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`.
+
+#### Returns
+
+`void`
+
+***
+
+### jpeg()
+
+> `static` **jpeg**(`bytes`): `Image`
+
+A JPEG.
+
+#### Parameters
+
+##### bytes
+
+`Uint8Array`
+
+#### Returns
+
+`Image`
+
+***
+
+### png()
+
+> `static` **png**(`bytes`): `Image`
+
+A PNG.
+
+#### Parameters
+
+##### bytes
+
+`Uint8Array`
+
+#### Returns
+
+`Image`
+
+***
+
+### rgba()
+
+> `static` **rgba**(`width`, `height`, `pixels`): `Image`
+
+8-bit RGBA pixels, row by row (`image-data-length` at first use for a wrong length).
+
+#### Parameters
+
+##### width
+
+`number`
+
+##### height
+
+`number`
+
+##### pixels
+
+`Uint8Array`
+
+#### Returns
+
+`Image`

package/docs/api/classes/LaminaPdfError.md

@@ -0,0 +1,189 @@
+---
+version: "0.2.0-alpha.3"
+---
+
+[**@laminapdf/sdk**](../README.md)
+
+***
+
+[@laminapdf/sdk](../README.md) / LaminaPdfError
+
+# Class: LaminaPdfError\<C\>
+
+The one error class of `@laminapdf/sdk` (ADR 0026 §7). `message`, `hint` and `didYouMean` never
+hold document text (ADR 0026 §4); that goes in `data`, marked untrusted on the code's page at
+`docsUrl`.
+
+## Example
+
+```ts
+try {
+  Document.open(bytes, { password: "secret" });
+} catch (e) {
+  if (isLaminaPdfError(e, "wrong-password")) askAgain();
+  else throw e;
+}
+```
+
+## Extends
+
+- `Error`
+
+## Type Parameters
+
+### C
+
+`C` *extends* [`ErrorCode`](../type-aliases/ErrorCode.md) = [`ErrorCode`](../type-aliases/ErrorCode.md)
+
+## Constructors
+
+### Constructor
+
+> **new LaminaPdfError**\<`C`\>(`diagnostic`, `options?`): `LaminaPdfError`\<`C`\>
+
+#### Parameters
+
+##### diagnostic
+
+[`Diagnostic`](../interfaces/Diagnostic.md)\<`C`\>
+
+the ADR 0026 §1 object.
+
+##### options?
+
+`cause`, when wrapping another error.
+
+###### cause?
+
+`unknown`
+
+#### Returns
+
+`LaminaPdfError`\<`C`\>
+
+#### Overrides
+
+`Error.constructor`
+
+## Properties
+
+### cause?
+
+> `optional` **cause?**: `unknown`
+
+#### Inherited from
+
+`Error.cause`
+
+***
+
+### code
+
+> `readonly` **code**: `C`
+
+The stable code (`fixtures/codes.json`).
+
+***
+
+### data?
+
+> `readonly` `optional` **data?**: `Readonly`\<`Record`\<`string`, `unknown`\>\>
+
+Code-specific fields, documented on the code's page (the only place document text appears).
+
+***
+
+### didYouMean?
+
+> `readonly` `optional` **didYouMean?**: readonly `string`[]
+
+For `usage` errors: the closest known names (Lamina PDF's own vocabulary).
+
+***
+
+### docsUrl
+
+> `readonly` **docsUrl**: `string`
+
+The code's page.
+
+***
+
+### hint?
+
+> `readonly` `optional` **hint?**: `string`
+
+One actionable sentence for this code.
+
+***
+
+### kind
+
+> `readonly` **kind**: [`ErrorKind`](../type-aliases/ErrorKind.md)
+
+What the caller can do about it.
+
+***
+
+### location?
+
+> `readonly` `optional` **location?**: [`Location`](../interfaces/Location.md)
+
+Where in the input or the document.
+
+***
+
+### message
+
+> **message**: `string`
+
+#### Inherited from
+
+`Error.message`
+
+***
+
+### name
+
+> `readonly` **name**: `"LaminaPdfError"` = `"LaminaPdfError"`
+
+#### Overrides
+
+`Error.name`
+
+***
+
+### stack?
+
+> `optional` **stack?**: `string`
+
+#### Inherited from
+
+`Error.stack`
+
+## Accessors
+
+### ranges
+
+#### Get Signature
+
+> **get** **ranges**(): readonly `object`[] \| `undefined`
+
+For `data-pending`: the byte ranges a range document needs fetched before the call can
+succeed (`data.ranges`); `undefined` for other codes. [Document.ensure](Document.md#ensure) fetches them.
+
+##### Returns
+
+readonly `object`[] \| `undefined`
+
+## Methods
+
+### toJSON()
+
+> **toJSON**(): [`Diagnostic`](../interfaces/Diagnostic.md)\<`C`\>
+
+The ADR 0026 §1 object (for logs, workers and `--json` output); optional fields omitted.
+
+#### Returns
+
+[`Diagnostic`](../interfaces/Diagnostic.md)\<`C`\>

package/docs/api/classes/Page.md

@@ -0,0 +1,178 @@
+---
+version: "0.2.0-alpha.3"
+---
+
+[**@laminapdf/sdk**](../README.md)
+
+***
+
+[@laminapdf/sdk](../README.md) / Page
+
+# Class: Page
+
+A page being drawn: its boxes and rotation, its [Surface](Surface.md), then [Page.finish](#finish). Freed
+with its builder; `using` or [Page.free](#free) drops it without writing it.
+
+## Methods
+
+### \[dispose\]()
+
+> **\[dispose\]**(): `void`
+
+Drops the page at the end of a `using` block (an alias of `free()`).
+
+#### Returns
+
+`void`
+
+***
+
+### artBox()
+
+> **artBox**(`rect`): `this`
+
+`/ArtBox`.
+
+#### Parameters
+
+##### rect
+
+[`Rect`](../type-aliases/Rect.md)
+
+#### Returns
+
+`this`
+
+***
+
+### bleedBox()
+
+> **bleedBox**(`rect`): `this`
+
+`/BleedBox`.
+
+#### Parameters
+
+##### rect
+
+[`Rect`](../type-aliases/Rect.md)
+
+#### Returns
+
+`this`
+
+***
+
+### cropBox()
+
+> **cropBox**(`rect`): `this`
+
+`/CropBox` (the visible region), in the media box's page space.
+
+#### Parameters
+
+##### rect
+
+[`Rect`](../type-aliases/Rect.md)
+
+#### Returns
+
+`this`
+
+***
+
+### finish()
+
+> **finish**(): `string`
+
+Writes the page into its builder and frees the page's WASM side; the page takes no more
+drawing afterwards (`builder-finished`).
+
+#### Returns
+
+`string`
+
+the page's ID.
+
+#### Throws
+
+[LaminaPdfError](LaminaPdfError.md) `invalid-geometry`, `builder-finished`.
+
+***
+
+### free()
+
+> **free**(): `void`
+
+Drops the page without writing it and frees its WASM side; a second call does nothing, and
+any other call afterwards throws `disposed`.
+
+#### Returns
+
+`void`
+
+***
+
+### rotate()
+
+> **rotate**(`degrees`): `this`
+
+`/Rotate`: 0, 90, 180 or 270 degrees.
+
+#### Parameters
+
+##### degrees
+
+`0` \| `90` \| `180` \| `270`
+
+#### Returns
+
+`this`
+
+***
+
+### surface()
+
+> **surface**(): [`Surface`](Surface.md)
+
+What the page is drawn with (the same object on every call).
+
+#### Returns
+
+[`Surface`](Surface.md)
+
+***
+
+### trimBox()
+
+> **trimBox**(`rect`): `this`
+
+`/TrimBox`.
+
+#### Parameters
+
+##### rect
+
+[`Rect`](../type-aliases/Rect.md)
+
+#### Returns
+
+`this`
+
+***
+
+### userUnit()
+
+> **userUnit**(`unit`): `this`
+
+`/UserUnit`, for pages larger than 14,400 units.
+
+#### Parameters
+
+##### unit
+
+`number`
+
+#### Returns
+
+`this`