@turntrout/subfont 1.0.5 → 1.1.0

package/README.md

@@ -36,20 +36,26 @@ subfont path/to/index.html -i --cache
 
 ## Options
 
-|              Flag | Default | Description                                                  |
-| ----------------: | :-----: | :----------------------------------------------------------- |
-|  `-i, --in-place` |   off   | Modify files in-place                                        |
-|    `-o, --output` |         | Output directory                                             |
-| `-r, --recursive` |   off   | Crawl linked pages                                           |
-|       `--dynamic` |   off   | Trace with headless browser                                  |
-|       `--dry-run` |   off   | Preview without writing                                      |
-|     `--fallbacks` |   on    | Load the full original font for characters not in the subset |
-|  `--font-display` | `swap`  | `auto`/`block`/`swap`/`fallback`/`optional`                  |
-|          `--text` |         | Extra characters for every subset                            |
-|   `--cache [dir]` |   off   | Cache subset results to disk between runs                    |
-| `--concurrency N` |         | Max worker threads for parallel font tracing                 |
-|  `--chrome-flags` |         | Custom Chrome flags for `--dynamic`                          |
-|   `--source-maps` |   off   | Preserve CSS source maps (slower)                            |
+|               Flag | Default | Description                                                  |
+| -----------------: | :-----: | :----------------------------------------------------------- |
+|   `-i, --in-place` |   off   | Modify files in-place                                        |
+|     `-o, --output` |         | Output directory                                             |
+|           `--root` |         | Path to web root (deduced from input files if not specified) |
+| `--canonical-root` |         | URI root where the site will be deployed                     |
+|  `-r, --recursive` |   off   | Crawl linked pages                                           |
+|        `--dynamic` |   off   | Trace with headless browser                                  |
+|        `--dry-run` |   off   | Preview without writing                                      |
+|      `--fallbacks` |   on    | Load the full original font for characters not in the subset |
+|   `--font-display` | `swap`  | `auto`/`block`/`swap`/`fallback`/`optional`                  |
+|           `--text` |         | Extra characters for every subset                            |
+|    `--cache [dir]` |   off   | Cache subset results to disk between runs                    |
+|  `--concurrency N` |         | Max worker threads (capped by available memory, ~50 MB each) |
+|   `--chrome-flags` |         | Custom Chrome flags for `--dynamic`                          |
+|    `--source-maps` |   off   | Preserve CSS source maps (slower)                            |
+|     `-s, --silent` |   off   | Suppress all console output                                  |
+|      `-d, --debug` |   off   | Verbose timing and font glyph detection info                 |
+|  `--relative-urls` |   off   | Emit relative URLs instead of root-relative                  |
+|     `--inline-css` |   off   | Inline the subset @font-face CSS into HTML                   |
 
 Run `subfont --help` for the full list.
 

package/lib/HeadlessBrowser.js

@@ -203,7 +203,13 @@ class HeadlessBrowser {
     const launchPromise = this._launchPromise;
     if (launchPromise) {
       this._launchPromise = undefined;
-      const browser = await launchPromise;
+      let browser;
+      try {
+        browser = await launchPromise;
+      } catch {
+        // Launch failed — nothing to close
+        return;
+      }
       await browser.close();
     }
   }

package/lib/concurrencyLimit.js

@@ -0,0 +1,10 @@
+const os = require('os');
+
+// Approximate memory footprint of each worker thread (jsdom + font-tracer).
+const WORKER_MEMORY_BYTES = 50 * 1024 * 1024; // 50 MB
+
+function getMaxConcurrency() {
+  return Math.max(1, Math.floor(os.totalmem() / WORKER_MEMORY_BYTES));
+}
+
+module.exports = { WORKER_MEMORY_BYTES, getMaxConcurrency };

package/lib/fontTracerWorker.js

@@ -28,11 +28,11 @@ parentPort.on('message', (msg) => {
   }
 
   if (msg.type === 'trace') {
+    const { taskId, htmlText, stylesheetsWithPredicates: serialized } = msg;
+    let dom;
     try {
-      const { taskId, htmlText, stylesheetsWithPredicates: serialized } = msg;
-
       // Re-parse HTML with jsdom to get a DOM document
-      const dom = new JSDOM(htmlText);
+      dom = new JSDOM(htmlText);
       const document = dom.window.document;
 
       // Re-parse CSS from serialized text — asset objects with PostCSS
@@ -50,9 +50,6 @@ parentPort.on('message', (msg) => {
         getCssRulesByProperty: memoizedGetCssRulesByProperty,
       });
 
-      // Clean up jsdom to free memory
-      dom.window.close();
-
       // Strip any non-serializable data from results
       const serializableResults = textByProps.map((entry) => ({
         text: entry.text,
@@ -71,6 +68,9 @@ parentPort.on('message', (msg) => {
         error: err.message,
         stack: err.stack,
       });
+    } finally {
+      // Clean up jsdom to free memory — must run even if fontTracer throws
+      if (dom) dom.window.close();
     }
   }
 });

package/lib/parseCommandLineOptions.js

@@ -1,8 +1,13 @@
 module.exports = function parseCommandLineOptions(argv) {
+  const os = require('os');
+  const { getMaxConcurrency } = require('./concurrencyLimit');
   let yargs = require('yargs');
   if (argv) {
     yargs = yargs(argv);
   }
+
+  const maxConcurrency = getMaxConcurrency();
+
   yargs
     .usage(
       'Create optimal font subsets from your actual font usage.\n$0 [options] <htmlFile(s) | url(s)>'
@@ -106,10 +111,22 @@ module.exports = function parseCommandLineOptions(argv) {
       },
     })
     .options('concurrency', {
-      describe:
-        'Maximum number of worker threads for parallel font tracing. Defaults to the number of CPU cores (max 8)',
+      describe: `Maximum number of worker threads for parallel font tracing. Defaults to the number of CPU cores (max 8). Upper bound: ${maxConcurrency} (based on available memory)`,
       type: 'number',
     })
+    .check((argv) => {
+      if (argv.concurrency !== undefined) {
+        if (!Number.isInteger(argv.concurrency) || argv.concurrency < 1) {
+          throw new Error('--concurrency must be a positive integer');
+        }
+        if (argv.concurrency > maxConcurrency) {
+          throw new Error(
+            `--concurrency must not exceed ${maxConcurrency} (each worker uses ~50 MB; system has ${Math.round(os.totalmem() / (1024 * 1024 * 1024))} GB total)`
+          );
+        }
+      }
+      return true;
+    })
     .options('source-maps', {
       describe: 'Preserve CSS source maps through subfont processing',
       type: 'boolean',

package/lib/subfont.js

@@ -1,5 +1,7 @@
 const fsPromises = require('fs/promises');
+const os = require('os');
 const pathModule = require('path');
+const { getMaxConcurrency } = require('./concurrencyLimit');
 const AssetGraph = require('assetgraph');
 const prettyBytes = require('pretty-bytes');
 const urlTools = require('urltools');
@@ -43,6 +45,12 @@ module.exports = async function subfont(
   ) {
     throw new UsageError('--concurrency must be a positive integer');
   }
+  const maxConcurrency = getMaxConcurrency();
+  if (concurrency !== undefined && concurrency > maxConcurrency) {
+    throw new UsageError(
+      `--concurrency must not exceed ${maxConcurrency} (each worker uses ~50 MB; system has ${Math.round(os.totalmem() / (1024 * 1024 * 1024))} GB total)`
+    );
+  }
 
   const formats = ['woff2'];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@turntrout/subfont",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "Automatically subset web fonts to only the characters used on your pages. Fork of Munter/subfont with modern defaults.",
   "engines": {
     "node": ">=18.0.0"