fullbleed 0.4.1 → 0.5.0

package/README.md

@@ -15,7 +15,7 @@ Using Vue? The [Vue and TypeScript starter](examples/vue) includes editable
 templates, automatic previews, downloads, and a reusable `usePdfPreview` composable.
 
 This is an optional integration around the published **Fullbleed 2.5.22** engine.
-The package has its own version, **0.4.1**. Node applications can use a shared
+The package has its own version, **0.5.0**. Node applications can use a shared
 render queue to bound active renders and waiting requests, include queue time in
 deadlines, cancel waiting jobs, and stop rendering cleanly during shutdown.
 The browser entry renders in a Web Worker, and the Node API supports worker and
@@ -25,7 +25,12 @@ process isolation. See the [browser guide](docs/browser.md),
 [font-family checks](https://github.com/fullbleed-engine/fullbleed-node/blob/main/docs/font-families.md), and
 [embedded-font checks](https://github.com/fullbleed-engine/fullbleed-node/blob/main/docs/font-subsets.md) for the retained fixtures.
 
-Version 0.4.1 brings the engine's recent layout fixes to both JavaScript entries.
+Version 0.5.0 adds `defaultStyles: false` to both JavaScript entries. Use it to
+preserve a template's original CSS, including font inheritance from `html`,
+low-specificity selectors, and cascade layers. Existing calls keep the Inter
+body rule. [Retained styling checks](docs/default-styles.md) cover both choices.
+
+Version 0.4.1 brought the engine's recent layout fixes to both JavaScript entries.
 The [engine update checks](https://github.com/fullbleed-engine/fullbleed-node/blob/main/docs/engine-2.5.22.md)
 cover nested counters, clipped effects, border-image tiling, and floated initials
 with independent text, color, and Chrome print expectations.
@@ -38,7 +43,7 @@ Use Node.js 22 or newer. Install the [npm package](https://www.npmjs.com/package
 npm install fullbleed
 ```
 
-For a version-pinned installation, use `npm install --save-exact fullbleed@0.4.1`.
+For a version-pinned installation, use `npm install --save-exact fullbleed@0.5.0`.
 Package archives and retained PDF/PNG evidence are attached to each
 [GitHub release](https://github.com/fullbleed-engine/fullbleed-node/releases).
 The [installation verification records](https://github.com/fullbleed-engine/fullbleed-node/tree/main/verification)
@@ -208,7 +213,8 @@ native engine.
 | Option | Behavior |
 | --- | --- |
 | `html` | Required nonempty HTML string. |
-| `css` | CSS string; defaults to empty. The default Inter rule precedes it. |
+| `css` | CSS string; defaults to empty. |
+| `defaultStyles` | Default `true`: prepend `body { font-family: Inter; }`. Set `false` to pass CSS unchanged; bundled fonts remain available. |
 | `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. |

package/dist/browser/asset-manifest.json

@@ -1,6 +1,6 @@
 {
   "schema": "fullbleed.browser-assets.v1",
-  "packageVersion": "0.4.1",
+  "packageVersion": "0.5.0",
   "engineVersion": "2.5.22",
   "engineFeatures": [
     "svg_raster"
@@ -8,18 +8,18 @@
   "files": {
     "client.js": {
       "source": "dist/browser/client.js",
-      "bytes": 12043,
-      "sha256": "7cf701296f165f39bec30d992f6e9eacf2f0d09a6fa79bca84a598baa5fc3de9"
+      "bytes": 12323,
+      "sha256": "9a6287ef90efea5efd08f8c7ce5a068eddf612a55fb22d3602d0d12c1a33f65d"
     },
     "worker.js": {
       "source": "dist/browser/worker.js",
       "bytes": 52109,
-      "sha256": "44152f218784ffd37f891ca10681264074d4eb6a08380cd15e3548aead3ad675"
+      "sha256": "7ff41b156cb8b21c66719ab86691e0f31c7e95fd3ca11922e5ee0692b2dcc8b0"
     },
     "engine.wasm": {
       "source": "dist/engine.wasm",
       "bytes": 5640040,
-      "sha256": "508c3dc58b51ec5568610cd5b8a329683f9e6d3677a464d8fc422ea9071b450d"
+      "sha256": "a739438e01e9b52db48e47f1a604b700d98119b40db41361cc1563da059d1cbf"
     },
     "THIRD_PARTY_NOTICES.txt": {
       "source": "dist/THIRD_PARTY_NOTICES.txt",

package/dist/browser/client.js

@@ -68,12 +68,13 @@ var require_render_input = __commonJS({
     var assetLimit = 64 * 1024 * 1024;
     function normalize(options, { browser = false } = {}) {
       if (!options || typeof options !== "object" || Array.isArray(options)) invalid2("Pass an options object with an html string.");
-      const supported = /* @__PURE__ */ new Set(["html", "css", "fonts", "assets", "previewDpi", "timeoutMs", "maxPages", "allowMissingGlyphs", "signal"]);
+      const supported = /* @__PURE__ */ new Set(["html", "css", "defaultStyles", "fonts", "assets", "previewDpi", "timeoutMs", "maxPages", "allowMissingGlyphs", "signal"]);
       if (!browser) supported.add("isolation");
       for (const key of Object.keys(options)) if (!supported.has(key)) invalid2(`Unknown option: ${key}`);
-      const { html, css = "", fonts = [], assets = {}, previewDpi = 0, timeoutMs = 3e4, maxPages = 1e3, allowMissingGlyphs = false, signal, isolation = "worker" } = options;
+      const { html, css = "", defaultStyles = true, fonts = [], assets = {}, previewDpi = 0, timeoutMs = 3e4, maxPages = 1e3, allowMissingGlyphs = false, signal, isolation = "worker" } = options;
       if (typeof html !== "string" || !html.trim()) invalid2("html must be a nonempty string.");
       if (typeof css !== "string") invalid2("css must be a string.");
+      if (typeof defaultStyles !== "boolean") invalid2("defaultStyles must be a boolean.");
       if (new TextEncoder().encode(html).byteLength + new TextEncoder().encode(css).byteLength > sourceLimit) invalid2("HTML and CSS together must not exceed 4,000,000 UTF-8 bytes.");
       if (!Number.isInteger(previewDpi) || previewDpi !== 0 && (previewDpi < 36 || previewDpi > 300)) invalid2("previewDpi must be 0 (disabled) or an integer from 36 to 300.");
       if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 2147483647) invalid2("timeoutMs must be a positive integer no greater than 2147483647.");
@@ -99,9 +100,12 @@ var require_render_input = __commonJS({
         for (let i = 1; i < segments.length; i++) if (fileNames.has(segments.slice(0, i).join("/"))) invalid2(`Asset is both a file and a directory: ${name}`);
         return { name: "assets/" + name, data: bytes(assets[name], `assets[${name}]`) };
       });
-      return { html, css, customFonts, assetFiles, previewDpi, timeoutMs, maxPages, allowMissingGlyphs, signal, isolation };
+      return { html, css, defaultStyles, customFonts, assetFiles, previewDpi, timeoutMs, maxPages, allowMissingGlyphs, signal, isolation };
     }
-    module.exports = { FullbleedError: FullbleedError2, normalize };
+    function stylesheet(job) {
+      return (job.defaultStyles ? "body { font-family: Inter; }\n" : "") + job.css;
+    }
+    module.exports = { FullbleedError: FullbleedError2, normalize, stylesheet };
   }
 });
 
@@ -109,7 +113,7 @@ var require_render_input = __commonJS({
 init_define_FULLBLEED_FONT_NAMES();
 init_define_FULLBLEED_RUNTIME_FILES();
 var import_render_input = __toESM(require_render_input(), 1);
-var version = "0.4.1";
+var version = "0.5.0";
 var engineVersion = "2.5.22";
 var FullbleedError = import_render_input.default.FullbleedError;
 var invalid = (message) => {
@@ -183,7 +187,7 @@ function createRenderer(options) {
             try {
               worker.postMessage({ type: "render", job: {
                 html: job.html,
-                css: "body { font-family: Inter; }\n" + job.css,
+                css: import_render_input.default.stylesheet(job),
                 fonts: job.customFonts,
                 assets: job.assetFiles,
                 previewDpi: job.previewDpi,

package/dist/browser/worker.js

@@ -2,7 +2,7 @@
 var define_FULLBLEED_FONT_NAMES_default = ["Inter-Variable.ttf", "DMSerifDisplay-Regular.ttf", "DMSerifDisplay-Italic.ttf", "BebasNeue-Regular.ttf"];
 
 // <define:__FULLBLEED_RUNTIME_FILES__>
-var define_FULLBLEED_RUNTIME_FILES_default = { "engine.wasm": { bytes: 5640040, sha256: "508c3dc58b51ec5568610cd5b8a329683f9e6d3677a464d8fc422ea9071b450d" }, "fonts/Inter-Variable.ttf": { bytes: 876576, sha256: "29160a80ff49ddcab2c97711247e08b1fab27a484a329ce8b813d820dc559031" }, "fonts/DMSerifDisplay-Regular.ttf": { bytes: 76580, sha256: "8cc3643535edf039aa5d95440a8542735e9197e4f4b8d9303e980fefbf5ab616" }, "fonts/DMSerifDisplay-Italic.ttf": { bytes: 71208, sha256: "df74c0ac387baeaeb0fe4f2324e1668e6a3ed8c09cd9796fe162c71753e19e45" }, "fonts/BebasNeue-Regular.ttf": { bytes: 61400, sha256: "08e4623805102d819f58601e46e345648846075e363b2ceb23313c2d1c83ec73" } };
+var define_FULLBLEED_RUNTIME_FILES_default = { "engine.wasm": { bytes: 5640040, sha256: "a739438e01e9b52db48e47f1a604b700d98119b40db41361cc1563da059d1cbf" }, "fonts/Inter-Variable.ttf": { bytes: 876576, sha256: "29160a80ff49ddcab2c97711247e08b1fab27a484a329ce8b813d820dc559031" }, "fonts/DMSerifDisplay-Regular.ttf": { bytes: 76580, sha256: "8cc3643535edf039aa5d95440a8542735e9197e4f4b8d9303e980fefbf5ab616" }, "fonts/DMSerifDisplay-Italic.ttf": { bytes: 71208, sha256: "df74c0ac387baeaeb0fe4f2324e1668e6a3ed8c09cd9796fe162c71753e19e45" }, "fonts/BebasNeue-Regular.ttf": { bytes: 61400, sha256: "08e4623805102d819f58601e46e345648846075e363b2ceb23313c2d1c83ec73" } };
 
 // node_modules/@bjorn3/browser_wasi_shim/dist/wasi_defs.js
 var CLOCKID_REALTIME = 0;
@@ -1438,7 +1438,7 @@ async function runEngine(job) {
 }
 
 // src/browser-worker.js
-var version = "0.4.1";
+var version = "0.5.0";
 var engineVersion = "2.5.22";
 var files = define_FULLBLEED_RUNTIME_FILES_default;
 var fontNames = define_FULLBLEED_FONT_NAMES_default;

package/dist/build.json

@@ -1,5 +1,5 @@
 {
-  "packageVersion": "0.4.1",
+  "packageVersion": "0.5.0",
   "engineVersion": "2.5.22",
   "engineSource": "https://crates.io/crates/fullbleed/2.5.22",
   "engineFeatures": [
@@ -48,7 +48,7 @@
   "files": {
     "dist/engine.wasm": {
       "bytes": 5640040,
-      "sha256": "508c3dc58b51ec5568610cd5b8a329683f9e6d3677a464d8fc422ea9071b450d"
+      "sha256": "a739438e01e9b52db48e47f1a604b700d98119b40db41361cc1563da059d1cbf"
     },
     "dist/THIRD_PARTY_NOTICES.txt": {
       "bytes": 81572,
@@ -103,16 +103,16 @@
       "sha256": "29160a80ff49ddcab2c97711247e08b1fab27a484a329ce8b813d820dc559031"
     },
     "dist/browser/client.js": {
-      "bytes": 12043,
-      "sha256": "7cf701296f165f39bec30d992f6e9eacf2f0d09a6fa79bca84a598baa5fc3de9"
+      "bytes": 12323,
+      "sha256": "9a6287ef90efea5efd08f8c7ce5a068eddf612a55fb22d3602d0d12c1a33f65d"
     },
     "dist/browser/worker.js": {
       "bytes": 52109,
-      "sha256": "44152f218784ffd37f891ca10681264074d4eb6a08380cd15e3548aead3ad675"
+      "sha256": "7ff41b156cb8b21c66719ab86691e0f31c7e95fd3ca11922e5ee0692b2dcc8b0"
     },
     "dist/browser/asset-manifest.json": {
       "bytes": 2443,
-      "sha256": "211481ebdda0022296dbce43d95b0dd49848c8a4e7298aa075fda1f3701c6a46"
+      "sha256": "8eeccbcac3bc80594f9cbae279c9ad710dc34baaac5996f47ddf36eb93a4d967"
     }
   }
 }

package/dist/index.d.cts

@@ -4,6 +4,8 @@ import type { Buffer } from 'node:buffer';
 export interface RenderOptions {
   html: string;
   css?: string;
+  /** Default true: prepend the package's Inter body rule. False passes CSS unchanged. */
+  defaultStyles?: boolean;
   /** Additional TrueType font files, as bytes. Use their family names in CSS. */
   fonts?: readonly Uint8Array[];
   /** Relative asset names; reference them as assets/name.svg in HTML/CSS. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fullbleed",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Generate PDFs from HTML and CSS in Node.js or a browser worker with the Fullbleed Rust engine, bundled fonts, and optional PNG previews.",
   "type": "module",
   "main": "./src/index.cjs",

package/src/browser.d.ts

@@ -6,6 +6,8 @@ export interface BrowserRendererOptions {
 export interface BrowserRenderOptions {
   html: string;
   css?: string;
+  /** Default true: prepend the package's Inter body rule. False passes CSS unchanged. */
+  defaultStyles?: boolean;
   /** Additional TrueType font bytes; use the font family names in CSS. */
   fonts?: readonly Uint8Array[];
   /** Relative names referenced as assets/name.svg in document HTML/CSS. */

package/src/browser.js

@@ -66,7 +66,7 @@ export function createRenderer(options) {
             ready = true;
             try {
               worker.postMessage({ type: 'render', job: {
-                html: job.html, css: 'body { font-family: Inter; }\n' + job.css,
+                html: job.html, css: input.stylesheet(job),
                 fonts: job.customFonts, assets: job.assetFiles, previewDpi: job.previewDpi,
                 maxPages: job.maxPages, allowMissingGlyphs: job.allowMissingGlyphs,
               } });

package/src/index.cjs

@@ -8,7 +8,7 @@ const { fork } = require('node:child_process');
 const { pathToFileURL } = require('node:url');
 const pkg = require('../package.json');
 
-const { FullbleedError, normalize } = require('./render-input.cjs');
+const { FullbleedError, normalize, stylesheet } = require('./render-input.cjs');
 const { createQueue } = require('./render-queue.cjs');
 const hash = bytes => createHash('sha256').update(bytes).digest('hex');
 const root = join(__dirname, '..');
@@ -136,7 +136,7 @@ function renderProcess(job, remaining) {
       child.send({ type: 'render', options: {
         html: job.html, css: job.css, fonts: job.customFonts.map(font => font.data),
         assets: Object.fromEntries(job.assetFiles.map(file => [file.name.slice('assets/'.length), file.data])),
-        previewDpi: job.previewDpi, maxPages: job.maxPages, allowMissingGlyphs: job.allowMissingGlyphs,
+        previewDpi: job.previewDpi, maxPages: job.maxPages, allowMissingGlyphs: job.allowMissingGlyphs, defaultStyles: job.defaultStyles,
         timeoutMs: remaining,
       } }, error => {
         if (error) stop(new FullbleedError('PROCESS_FAILED', 'Could not send the rendering request.', { cause: error }));
@@ -198,7 +198,7 @@ async function renderJob(job, start) {
         eval: true,
         workerData: {
           module: loaded.module, fonts: [...loaded.fonts, ...job.customFonts], assets: job.assetFiles,
-          html: job.html, css: 'body { font-family: Inter; }\n' + job.css, previewDpi: job.previewDpi, maxPages: job.maxPages,
+          html: job.html, css: stylesheet(job), previewDpi: job.previewDpi, maxPages: job.maxPages,
           allowMissingGlyphs: job.allowMissingGlyphs,
         },
       });

package/src/index.d.ts

@@ -4,6 +4,8 @@ import type { Buffer } from 'node:buffer';
 export interface RenderOptions {
   html: string;
   css?: string;
+  /** Default true: prepend the package's Inter body rule. False passes CSS unchanged. */
+  defaultStyles?: boolean;
   /** Additional TrueType font files, as bytes. Use their family names in CSS. */
   fonts?: readonly Uint8Array[];
   /** Relative asset names; reference them as assets/name.svg in HTML/CSS. */

package/src/render-input.cjs

@@ -14,12 +14,13 @@ const assetLimit = 64 * 1024 * 1024;
 
 function normalize(options, { browser = false } = {}) {
   if (!options || typeof options !== 'object' || Array.isArray(options)) invalid('Pass an options object with an html string.');
-  const supported = new Set(['html', 'css', 'fonts', 'assets', 'previewDpi', 'timeoutMs', 'maxPages', 'allowMissingGlyphs', 'signal']);
+  const supported = new Set(['html', 'css', 'defaultStyles', 'fonts', 'assets', 'previewDpi', 'timeoutMs', 'maxPages', 'allowMissingGlyphs', 'signal']);
   if (!browser) supported.add('isolation');
   for (const key of Object.keys(options)) if (!supported.has(key)) invalid(`Unknown option: ${key}`);
-  const { html, css = '', fonts = [], assets = {}, previewDpi = 0, timeoutMs = 30000, maxPages = 1000, allowMissingGlyphs = false, signal, isolation = 'worker' } = options;
+  const { html, css = '', defaultStyles = true, fonts = [], assets = {}, previewDpi = 0, timeoutMs = 30000, maxPages = 1000, allowMissingGlyphs = false, signal, isolation = 'worker' } = options;
   if (typeof html !== 'string' || !html.trim()) invalid('html must be a nonempty string.');
   if (typeof css !== 'string') invalid('css must be a string.');
+  if (typeof defaultStyles !== 'boolean') invalid('defaultStyles must be a boolean.');
   if (new TextEncoder().encode(html).byteLength + new TextEncoder().encode(css).byteLength > sourceLimit) invalid('HTML and CSS together must not exceed 4,000,000 UTF-8 bytes.');
   if (!Number.isInteger(previewDpi) || (previewDpi !== 0 && (previewDpi < 36 || previewDpi > 300))) invalid('previewDpi must be 0 (disabled) or an integer from 36 to 300.');
   if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 2147483647) invalid('timeoutMs must be a positive integer no greater than 2147483647.');
@@ -45,7 +46,11 @@ function normalize(options, { browser = false } = {}) {
     for (let i = 1; i < segments.length; i++) if (fileNames.has(segments.slice(0, i).join('/'))) invalid(`Asset is both a file and a directory: ${name}`);
     return { name: 'assets/' + name, data: bytes(assets[name], `assets[${name}]`) };
   });
-  return { html, css, customFonts, assetFiles, previewDpi, timeoutMs, maxPages, allowMissingGlyphs, signal, isolation };
+  return { html, css, defaultStyles, customFonts, assetFiles, previewDpi, timeoutMs, maxPages, allowMissingGlyphs, signal, isolation };
 }
 
-module.exports = { FullbleedError, normalize };
+function stylesheet(job) {
+  return (job.defaultStyles ? 'body { font-family: Inter; }\n' : '') + job.css;
+}
+
+module.exports = { FullbleedError, normalize, stylesheet };