fullbleed 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fullbleed Contributors
+
+Permission is hereby granted, free of charge, to any person 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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 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.

package/README.md

@@ -0,0 +1,176 @@
+# Fullbleed for Node.js
+
+Generate PDFs from static HTML and CSS in Node.js. The package includes the
+Fullbleed Rust engine compiled to WebAssembly and four font faces, so installing
+it does not require Python, Rust, a browser, or system fonts. MIT licensed.
+
+This is an optional integration around the unchanged **Fullbleed 2.5.5** engine.
+The Node package has its own version, **0.1.1**.
+
+## Install and render
+
+Use Node.js 22 or newer. Install the versioned package from its GitHub release:
+
+```bash
+npm install https://github.com/fullbleed-engine/fullbleed-node/releases/download/v0.1.1/fullbleed-0.1.1.tgz
+```
+
+Save this as `invoice.mjs` and run `node invoice.mjs`:
+
+```javascript
+import { writeFile } from 'node:fs/promises';
+import { renderPdf } from 'fullbleed';
+
+const result = await renderPdf({
+  html: '<h1>Invoice NS-1042</h1><p>Consulting: USD 1,200.00</p>',
+  css: '@page { size: A4; margin: 20mm } h1 { color: #175c52 }',
+  previewDpi: 96,
+});
+
+await writeFile('invoice.pdf', result.pdf);
+await writeFile('invoice.png', result.previews[0]);
+console.log(`${result.pages} page; engine ${result.engineVersion}`);
+```
+
+Inter is the default font. CommonJS also works:
+`const { renderPdf } = require('fullbleed')`. TypeScript declarations are included.
+
+[Try the browser playground](https://docs.fullbleed.dev/playground/) ·
+[Fullbleed documentation](https://docs.fullbleed.dev/) ·
+[CSS coverage](https://docs.fullbleed.dev/css-coverage/) ·
+[Python and Rust engine](https://github.com/fullbleed-engine/fullbleed-official)
+
+## A designed invoice
+
+![Northstar invoice with cream paper, serif typography, green tables, and an orange accent.](https://docs.fullbleed.dev/assets/showcase/invoice-1.png)
+
+The [runnable example](examples/invoice.mjs) uses these same invoice sources and
+the bundled Inter, DM Serif Display, and Bebas Neue families. It escapes the
+customer name before inserting it into HTML. The data is fictional.
+
+From a source checkout, after the build steps below:
+
+```bash
+npm run example
+```
+
+Open `output/invoice/invoice.pdf` and `page-1.png`. The [three-page report
+sources](examples/report.html) demonstrate pagination, tables, and vector artwork.
+
+## Fonts and assets
+
+Supply file bytes explicitly. Additional fonts are registered alongside the
+bundled fonts; use their actual family names in CSS. Asset names are relative to
+the virtual `assets/` directory:
+
+```javascript
+import { readFile } from 'node:fs/promises';
+import { renderPdf } from 'fullbleed';
+
+const result = await renderPdf({
+  html: '<img src="assets/brand/logo.svg"><h1>Quarterly report</h1>',
+  css: "body { font-family: 'Your Font Family', Inter } img { width: 80pt }",
+  fonts: [await readFile('your-font.ttf')],
+  assets: { 'brand/logo.svg': await readFile('logo.svg') },
+});
+```
+
+The WebAssembly engine sees an in-memory filesystem containing the supplied
+inputs and bundled fonts. It does not fetch remote URLs or read application files.
+Use the asset map or data URIs for document images. Render and review previews
+when adapting a template; unsupported CSS or an unavailable asset can affect output.
+
+Use registered font families in CSS. The engine can substitute an unavailable
+family. Its missing-glyph report checks resolved fonts and is not an exhaustive
+font-substitution or visual-validation report.
+
+## API
+
+`await renderPdf(options)` returns `{ pdf, previews, pages, missingGlyphs,
+engineVersion }`. PDF and PNG values are Node `Buffer` objects. Previews are
+generated from the finalized PDF and are empty when disabled.
+
+The report example uses gradient chart fills. Its finalized PDF previews and
+separate linear, translucent, and hard radial fixtures are checked against the
+native engine.
+
+| Option | Behavior |
+| --- | --- |
+| `html` | Required nonempty HTML string. |
+| `css` | CSS string; defaults to empty. The default Inter rule precedes it. |
+| `fonts` | Additional TrueType font bytes as `Uint8Array[]` or `Buffer[]`. |
+| `assets` | Map relative asset names to nonempty byte arrays. |
+| `previewDpi` | `0` disables previews; otherwise an integer from 36 to 300. |
+| `maxPages` | Reject larger documents. Default: 1000. |
+| `timeoutMs` | Deadline including initial engine loading. Default: 30000 ms. |
+| `signal` | An `AbortSignal` to cancel rendering. |
+| `allowMissingGlyphs` | Default `false`: reject engine-reported missing glyphs. |
+
+Rendering runs in a dedicated worker. Concurrent calls use separate workers and
+document state. Bound concurrency in a server according to its available memory;
+each worker's WebAssembly memory has a 512 MiB ceiling. HTML and CSS together are
+limited to 4,000,000 UTF-8 bytes; supplied fonts and assets together to 64 MiB.
+Preview images can use substantially more memory than PDF-only rendering.
+
+```javascript
+import { FullbleedError, renderPdf } from 'fullbleed';
+
+try {
+  const result = await renderPdf({
+    html: '<h1>Monthly statement</h1>',
+    maxPages: 20,
+    timeoutMs: 10_000,
+    signal: AbortSignal.timeout(8_000),
+  });
+  // Return result.pdf from your HTTP handler, or write it to your storage.
+} catch (error) {
+  if (error instanceof FullbleedError) console.error(error.code, error.message);
+  else throw error;
+}
+```
+
+Error codes include `INVALID_INPUT`, `MISSING_GLYPHS`, `PAGE_LIMIT`, `TIMEOUT`,
+`ABORTED`, `ENGINE_LOAD_FAILED`, `ENGINE_LIMIT`, `RENDER_FAILED`,
+`PREVIEW_FAILED`, and `WORKER_FAILED`. Failed or cancelled calls do not return a
+partial PDF. Caller-owned asset buffers are copied when a call starts.
+
+This API covers ordinary document generation and previews. It does not expose
+PDF/A, PDF/UA, PDF/X, template overlays, or compiled VDP. Use the
+[Python or Rust APIs](https://docs.fullbleed.dev/) for those workflows and their
+verification requirements. Unknown options are rejected. Fullbleed uses static
+HTML/CSS for print layout; it does not execute document JavaScript or reproduce
+arbitrary browser pages.
+
+## Build and verify from source
+
+Contributors need Node.js 22+ and Rust 1.97.0 with the WASI target. Package users
+do not need a compiler. Dependencies are pinned in both lockfiles.
+
+```bash
+rustup target add wasm32-wasip1
+npm ci --ignore-scripts
+npm run build
+npm test
+npm run check:types
+npm run verify:native
+npm run verify:pack
+```
+
+The build records engine metadata, licenses, and artifact hashes in `dist/`.
+The verification suite renders actual invoices, a three-page report, custom
+fonts, and image assets; compares native and WebAssembly PDF/PNG bytes; checks
+error recovery; and installs the packed tarball into a separate directory with
+spaces in its path. CI exercises Node 22, 24, and 26 on Windows, Linux, and macOS.
+Retained release evidence describes the verified fixtures and scope.
+
+## License and support
+
+The adapter and Fullbleed engine are MIT licensed. Bundled fonts use SIL OFL 1.1.
+The WASI shim is used under its MIT option. Complete notices ship with the package
+in `dist/THIRD_PARTY_NOTICES.txt` and `assets/fonts/`.
+
+Report reproducible integration bugs in [this repository's
+issues](https://github.com/fullbleed-engine/fullbleed-node/issues). Include the
+package and Node versions, platform, minimal synthetic inputs, and error code.
+For engine behavior and general usage, use the
+[Fullbleed discussion forum](https://github.com/fullbleed-engine/fullbleed-official/discussions).

package/assets/fonts/BebasNeue-OFL.txt

@@ -0,0 +1,93 @@
+Copyright © 2010 by Dharma Type.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment. 
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/fonts/DMSerifDisplay-OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2014-2018 Adobe (http://www.adobe.com/), with Reserved Font Name 'Source'. All Rights Reserved. Source is a trademark of Adobe in the United States and/or other countries. Copyright 2019 Google LLC.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+
+This license is copied below, and is also available with a FAQ at: http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/fonts/Inter-OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.