@turntrout/subfont 1.7.1 → 1.8.0

package/lib/parseCommandLineOptions.js

@@ -1,150 +1,146 @@
-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)>'
-    )
-    .options('root', {
-      describe:
-        'Path to your web root (will be deduced from your input files if not specified)',
-      type: 'string',
-    })
-    .options('canonical-root', {
-      describe:
-        'URI root where the site will be deployed. Must be either an absolute, a protocol-relative, or a root-relative url',
-      type: 'string',
-    })
-    .options('output', {
-      alias: 'o',
-      describe: 'Directory where results should be written to',
-      type: 'string',
-    })
-    .options('text', {
-      describe:
-        'Additional characters to include in the subset for every @font-face found on the page',
-      type: 'string',
-    })
-    .options('fallbacks', {
-      describe:
-        'Async-load the full original font as a fallback for dynamic content. Disable with --no-fallbacks',
-      type: 'boolean',
-      default: true,
-    })
-    .options('dynamic', {
-      describe:
-        'Also trace the usage of fonts in a headless browser with JavaScript enabled',
-      type: 'boolean',
-      default: false,
-    })
-    .options('in-place', {
-      alias: 'i',
-      describe: 'Modify HTML-files in-place. Only use on build artifacts',
-      type: 'boolean',
-      default: false,
-    })
-    .options('inline-css', {
-      describe: 'Inline CSS that declares the @font-face for the subset fonts',
-      type: 'boolean',
-      default: false,
-    })
-    .options('font-display', {
-      describe: 'Injects a font-display value into the @font-face CSS',
-      type: 'string',
-      default: 'swap',
-      choices: ['auto', 'block', 'swap', 'fallback', 'optional'],
-    })
-    .options('recursive', {
-      alias: 'r',
-      describe:
-        'Crawl all HTML-pages linked with relative and root relative links. This stays inside your domain',
-      type: 'boolean',
-      default: false,
-    })
-    .options('relative-urls', {
-      describe: 'Issue relative urls instead of root-relative ones',
-      type: 'boolean',
-      default: false,
-    })
-    .options('silent', {
-      alias: 's',
-      describe: `Do not write anything to stdout`,
-      type: 'boolean',
-      default: false,
-    })
-    .options('debug', {
-      alias: 'd',
-      describe: 'Verbose insights into font glyph detection',
-      type: 'boolean',
-      default: false,
-    })
-    .options('dry-run', {
-      describe: `Don't write anything to disk. Shows a preview of files, sizes, and CSS changes that would be made`,
-      type: 'boolean',
-      default: false,
-    })
-    .options('cache', {
-      describe:
-        'Enable disk caching of subset font results between runs. Pass a directory path or use without a value for the default .subfont-cache directory',
-      type: 'string',
-      default: false,
-      coerce(val) {
-        if (val === '' || val === true) return true;
-        return val;
-      },
-    })
-    .options('chrome-flags', {
-      alias: ['chromeFlags'],
-      describe:
-        'Custom flags to pass to the Chrome/Chromium browser for dynamic tracing (comma-separated)',
-      type: 'string',
-      coerce(flags) {
-        if (!flags) return [];
-        return flags.split(',').map((f) => f.trim());
-      },
-    })
-    .options('concurrency', {
-      describe: `Maximum number of worker threads for parallel font tracing. Defaults to the number of CPU cores (max 8). Upper bound: ${maxConcurrency} (based on free memory and CPU count)`,
-      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');
+"use strict";
+const os = require("os");
+// yargs is exported as a callable/chainable singleton; the typings only
+// expose half of that shape, so this union (and the cast below) keeps the
+// runtime API ergonomics without leaking `unknown` everywhere.
+const yargsModule = require("yargs");
+const concurrencyLimit_1 = require("./concurrencyLimit");
+// eslint-disable-next-line no-restricted-syntax
+const yargsLib = yargsModule;
+function parseCommandLineOptions(argv) {
+    let y = yargsLib;
+    if (argv) {
+        y = yargsLib(argv);
+    }
+    const maxConcurrency = (0, concurrencyLimit_1.getMaxConcurrency)();
+    const { version } = require('../package.json');
+    y.usage('Create optimal font subsets from your actual font usage.\n$0 [options] <htmlFile(s) | url(s)>')
+        .version(version)
+        .options('root', {
+        describe: 'Path to your web root (will be deduced from your input files if not specified)',
+        type: 'string',
+    })
+        .options('canonical-root', {
+        describe: 'URI root where the site will be deployed. Must be either an absolute, a protocol-relative, or a root-relative url',
+        type: 'string',
+    })
+        .options('output', {
+        alias: 'o',
+        describe: 'Directory where results should be written to',
+        type: 'string',
+    })
+        .options('text', {
+        describe: 'Additional characters to include in the subset for every @font-face found on the page',
+        type: 'string',
+    })
+        .options('fallbacks', {
+        describe: 'Async-load the full original font as a fallback for dynamic content. Disable with --no-fallbacks',
+        type: 'boolean',
+        default: true,
+    })
+        .options('dynamic', {
+        describe: 'Also trace the usage of fonts in a headless browser with JavaScript enabled',
+        type: 'boolean',
+        default: false,
+    })
+        .options('in-place', {
+        alias: 'i',
+        describe: 'Modify HTML-files in-place. Only use on build artifacts',
+        type: 'boolean',
+        default: false,
+    })
+        .options('inline-css', {
+        describe: 'Inline CSS that declares the @font-face for the subset fonts',
+        type: 'boolean',
+        default: false,
+    })
+        .options('font-display', {
+        describe: 'Injects a font-display value into the @font-face CSS',
+        type: 'string',
+        default: 'swap',
+        choices: ['auto', 'block', 'swap', 'fallback', 'optional'],
+    })
+        .options('recursive', {
+        alias: 'r',
+        describe: 'Crawl all HTML-pages linked with relative and root relative links. This stays inside your domain',
+        type: 'boolean',
+        default: false,
+    })
+        .options('relative-urls', {
+        describe: 'Issue relative urls instead of root-relative ones',
+        type: 'boolean',
+        default: false,
+    })
+        .options('silent', {
+        alias: 's',
+        describe: `Do not write anything to stdout`,
+        type: 'boolean',
+        default: false,
+    })
+        .options('debug', {
+        alias: 'd',
+        describe: 'Verbose insights into font glyph detection',
+        type: 'boolean',
+        default: false,
+    })
+        .options('dry-run', {
+        describe: `Don't write anything to disk. Shows a preview of files, sizes, and CSS changes that would be made`,
+        type: 'boolean',
+        default: false,
+    })
+        .options('cache', {
+        describe: 'Enable disk caching of subset font results between runs. Pass a directory path or use without a value for the default .subfont-cache directory',
+        type: 'string',
+        default: false,
+        coerce(val) {
+            if (val === '' || val === true)
+                return true;
+            return val;
+        },
+    })
+        .options('chrome-flags', {
+        alias: ['chromeFlags'],
+        describe: 'Custom flags to pass to the Chrome/Chromium browser for dynamic tracing (comma-separated)',
+        type: 'string',
+        coerce(flags) {
+            if (!flags)
+                return [];
+            return flags.split(',').map((f) => f.trim());
+        },
+    })
+        .options('concurrency', {
+        describe: `Maximum number of worker threads for parallel font tracing. Defaults to the number of CPU cores (max 8). Upper bound: ${maxConcurrency} (based on free memory and CPU count)`,
+        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; ${Math.round(os.freemem() / (1024 * 1024 * 1024))} GB free, ${os.cpus().length} CPUs)`);
+            }
         }
-        if (argv.concurrency > maxConcurrency) {
-          throw new Error(
-            `--concurrency must not exceed ${maxConcurrency} (each worker uses ~50 MB; ${Math.round(os.freemem() / (1024 * 1024 * 1024))} GB free, ${os.cpus().length} CPUs)`
-          );
-        }
-      }
-      return true;
-    })
-    .options('source-maps', {
-      describe: 'Preserve CSS source maps through subfont processing',
-      type: 'boolean',
-      default: false,
-    })
-    .options('strict', {
-      describe:
-        'Exit with a non-zero status code if any warnings are emitted during the run',
-      type: 'boolean',
-      default: false,
-    })
-    .wrap(require('yargs').terminalWidth());
-
-  const { _: inputFiles, ...rest } = yargs.argv;
-
-  return {
-    yargs,
-    inputFiles,
-    ...rest,
-  };
-};
+        return true;
+    })
+        .options('source-maps', {
+        describe: 'Preserve CSS source maps through subfont processing',
+        type: 'boolean',
+        default: false,
+    })
+        .options('strict', {
+        describe: 'Exit with a non-zero status code if any warnings are emitted during the run',
+        type: 'boolean',
+        default: false,
+    })
+        .wrap(yargsLib.terminalWidth());
+    const parsed = y.argv;
+    const { _: inputFiles, ...rest } = parsed;
+    return {
+        yargs: y,
+        inputFiles,
+        ...rest,
+    };
+}
+module.exports = parseCommandLineOptions;
+//# sourceMappingURL=parseCommandLineOptions.js.map

package/lib/parseCommandLineOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseCommandLineOptions.js","sourceRoot":"","sources":["../src/parseCommandLineOptions.ts"],"names":[],"mappings":"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"}

package/lib/parseFontVariationSettings.d.ts

@@ -0,0 +1,3 @@
+declare function parseFontVariationSettings(value: string): Generator<[string, number], void, void>;
+export = parseFontVariationSettings;
+//# sourceMappingURL=parseFontVariationSettings.d.ts.map

package/lib/parseFontVariationSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseFontVariationSettings.d.ts","sourceRoot":"","sources":["../src/parseFontVariationSettings.ts"],"names":[],"mappings":"AAEA,iBAAU,0BAA0B,CAClC,KAAK,EAAE,MAAM,GACZ,SAAS,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAoCzC;AAED,SAAS,0BAA0B,CAAC"}

package/lib/parseFontVariationSettings.js

@@ -1,39 +1,41 @@
-const postcssValueParser = require('postcss-value-parser');
-
-module.exports = function* parseFontVariationSettings(value) {
-  let state = 'BEFORE_AXIS_NAME';
-  let axisName;
-  for (const token of postcssValueParser(value).nodes) {
-    if (token.type === 'space') {
-      continue;
-    }
-    switch (state) {
-      case 'BEFORE_AXIS_NAME': {
-        if (token.type !== 'string') {
-          return;
-        }
-        axisName = token.value;
-        state = 'AFTER_AXIS_NAME';
-        break;
-      }
-      case 'AFTER_AXIS_NAME': {
-        if (token.type === 'word') {
-          const axisValue = parseFloat(token.value);
-          if (!isNaN(axisValue)) {
-            yield [axisName, axisValue];
-          }
+"use strict";
+const postcssValueParser = require("postcss-value-parser");
+function* parseFontVariationSettings(value) {
+    let state = 'BEFORE_AXIS_NAME';
+    let axisName;
+    for (const token of postcssValueParser(value).nodes) {
+        if (token.type === 'space') {
+            continue;
         }
-        state = 'AFTER_AXIS_VALUE';
-        break;
-      }
-      case 'AFTER_AXIS_VALUE': {
-        if (token.type !== 'div' || token.value !== ',') {
-          return;
+        switch (state) {
+            case 'BEFORE_AXIS_NAME': {
+                if (token.type !== 'string') {
+                    return;
+                }
+                axisName = token.value;
+                state = 'AFTER_AXIS_NAME';
+                break;
+            }
+            case 'AFTER_AXIS_NAME': {
+                if (token.type === 'word') {
+                    const axisValue = parseFloat(token.value);
+                    if (!isNaN(axisValue) && axisName !== undefined) {
+                        yield [axisName, axisValue];
+                    }
+                }
+                state = 'AFTER_AXIS_VALUE';
+                break;
+            }
+            case 'AFTER_AXIS_VALUE': {
+                if (token.type !== 'div' || token.value !== ',') {
+                    return;
+                }
+                axisName = undefined;
+                state = 'BEFORE_AXIS_NAME';
+                break;
+            }
         }
-        axisName = undefined;
-        state = 'BEFORE_AXIS_NAME';
-        break;
-      }
     }
-  }
-};
+}
+module.exports = parseFontVariationSettings;
+//# sourceMappingURL=parseFontVariationSettings.js.map

package/lib/parseFontVariationSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseFontVariationSettings.js","sourceRoot":"","sources":["../src/parseFontVariationSettings.ts"],"names":[],"mappings":";AAAA,2DAA4D;AAE5D,QAAQ,CAAC,CAAC,0BAA0B,CAClC,KAAa;IAEb,IAAI,KAAK,GAAG,kBAAkB,CAAC;IAC/B,IAAI,QAA4B,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;QACpD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC5B,OAAO;gBACT,CAAC;gBACD,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC;gBACvB,KAAK,GAAG,iBAAiB,CAAC;gBAC1B,MAAM;YACR,CAAC;YACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC1B,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBAC1C,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;wBAChD,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;oBAC9B,CAAC;gBACH,CAAC;gBACD,KAAK,GAAG,kBAAkB,CAAC;gBAC3B,MAAM;YACR,CAAC;YACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC;oBAChD,OAAO;gBACT,CAAC;gBACD,QAAQ,GAAG,SAAS,CAAC;gBACrB,KAAK,GAAG,kBAAkB,CAAC;gBAC3B,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,iBAAS,0BAA0B,CAAC"}

package/lib/progress.d.ts

@@ -0,0 +1,27 @@
+export interface ProgressConsole {
+    log?: (...args: unknown[]) => void;
+}
+export interface PhaseHandle {
+    end(extraInfo?: string | null): number;
+}
+export interface PageProgress {
+    enabled: boolean;
+    banner(msg: string): void;
+    tick(): number;
+    done(): void;
+}
+interface CreatePageProgressOptions {
+    total: number;
+    console?: ProgressConsole | Console | null;
+    label: string;
+    minTotal?: number;
+}
+export declare function createPageProgress({ total, console, label, minTotal, }: CreatePageProgressOptions): PageProgress;
+interface TraceablePageAsset {
+    urlOrDescription: string;
+}
+export declare function logTracedPage(console: ProgressConsole | Console | null | undefined, debug: boolean, index: number, total: number, asset: TraceablePageAsset, startMs: number): void;
+export declare function logPhaseStart(console: ProgressConsole | Console | null | undefined, debug: boolean, label: string): PhaseHandle;
+export declare function makePhaseTracker(console: ProgressConsole | Console | null | undefined, debug: boolean): (label: string) => PhaseHandle;
+export {};
+//# sourceMappingURL=progress.d.ts.map

package/lib/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,eAAe;IAI9B,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,IAAI,MAAM,CAAC;IACf,IAAI,IAAI,IAAI,CAAC;CACd;AAED,UAAU,yBAAyB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,GAAG,IAAI,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAeD,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,OAAO,EACP,KAAK,EACL,QAAY,GACb,EAAE,yBAAyB,GAAG,YAAY,CAsB1C;AAED,UAAU,kBAAkB;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAID,wBAAgB,aAAa,CAC3B,OAAO,EAAE,eAAe,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACrD,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,MAAM,GACd,IAAI,CAKN;AAUD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,eAAe,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACrD,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,WAAW,CAoBb;AASD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACrD,KAAK,EAAE,OAAO,GACb,CAAC,KAAK,EAAE,MAAM,KAAK,WAAW,CAEhC"}

package/lib/progress.js

@@ -1,3 +1,4 @@
+"use strict";
 // Helpers for surfacing phase progress to the console.
 //
 // Two audiences:
@@ -7,53 +8,54 @@
 //      goes silent. Paired "→ starting" / "← finished in Nms" markers
 //      around each slow phase mean the last line printed is always the
 //      currently-running phase.
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPageProgress = createPageProgress;
+exports.logTracedPage = logTracedPage;
+exports.logPhaseStart = logPhaseStart;
+exports.makePhaseTracker = makePhaseTracker;
 // Pick a progress step that gives roughly 10 updates across the run,
 // clamped to [1, 10]. For a 500-page run this prints every 50; for 30,
 // every 3. Avoids long silent stretches on large runs and per-page spam
 // on small ones.
 function progressStep(total) {
-  return Math.max(1, Math.min(10, Math.ceil(total / 10)));
+    return Math.max(1, Math.min(10, Math.ceil(total / 10)));
 }
-
 // Reporter for a phase that iterates `total` items.
 //   banner(msg): optional one-line header printed immediately.
 //   tick(): call once per completed item; returns the running count.
 //   done(): prints "<label>: <total>/<total> pages done." footer.
 // All methods no-op when disabled (missing console or below minTotal).
-function createPageProgress({ total, console, label, minTotal = 5 }) {
-  const enabled = Boolean(console) && total >= minTotal;
-  const step = progressStep(total);
-  let count = 0;
-  return {
-    enabled,
-    banner(msg) {
-      if (enabled) console.log(msg);
-    },
-    tick() {
-      count++;
-      if (enabled && count % step === 0 && count < total) {
-        console.log(`  ${label}: ${count}/${total} pages...`);
-      }
-      return count;
-    },
-    done() {
-      if (enabled) {
-        console.log(`  ${label}: ${total}/${total} pages done.`);
-      }
-    },
-  };
+function createPageProgress({ total, console, label, minTotal = 5, }) {
+    const enabled = Boolean(console) && total >= minTotal;
+    const step = progressStep(total);
+    let count = 0;
+    return {
+        enabled,
+        banner(msg) {
+            if (enabled && console?.log)
+                console.log(msg);
+        },
+        tick() {
+            count++;
+            if (enabled && count % step === 0 && count < total && console?.log) {
+                console.log(`  ${label}: ${count}/${total} pages...`);
+            }
+            return count;
+        },
+        done() {
+            if (enabled && console?.log) {
+                console.log(`  ${label}: ${total}/${total} pages done.`);
+            }
+        },
+    };
 }
-
 // Per-page debug line emitted right after a page finishes tracing.
 // When a run hangs, the last-printed page identifies which page stalled.
 function logTracedPage(console, debug, index, total, asset, startMs) {
-  if (!debug || !console) return;
-  console.log(
-    `[subfont timing]   traced [${index}/${total}] ${asset.urlOrDescription} in ${Date.now() - startMs}ms`
-  );
+    if (!debug || !console || !console.log)
+        return;
+    console.log(`[subfont timing]   traced [${index}/${total}] ${asset.urlOrDescription} in ${Date.now() - startMs}ms`);
 }
-
 // Start/end markers for a debug phase. The "→ label..." line is printed
 // *before* the work begins, so if the work hangs the user sees exactly
 // which phase is in flight. The returned end() logs elapsed ms and
@@ -63,26 +65,26 @@ function logTracedPage(console, debug, index, total, asset, startMs) {
 //   await getSubsetsForFontUsage(...);
 //   timings.x = phase.end();
 function logPhaseStart(console, debug, label) {
-  if (!debug || !console) {
+    const log = console?.log;
+    if (!debug || !log) {
+        const start = Date.now();
+        return {
+            end() {
+                return Date.now() - start;
+            },
+        };
+    }
     const start = Date.now();
+    log(`[subfont timing] → ${label}...`);
     return {
-      end() {
-        return Date.now() - start;
-      },
+        end(extraInfo) {
+            const ms = Date.now() - start;
+            const suffix = extraInfo ? ` (${extraInfo})` : '';
+            log(`[subfont timing] ← ${label}: ${ms}ms${suffix}`);
+            return ms;
+        },
     };
-  }
-  const start = Date.now();
-  console.log(`[subfont timing] → ${label}...`);
-  return {
-    end(extraInfo) {
-      const ms = Date.now() - start;
-      const suffix = extraInfo ? ` (${extraInfo})` : '';
-      console.log(`[subfont timing] ← ${label}: ${ms}ms${suffix}`);
-      return ms;
-    },
-  };
 }
-
 // Bind a (console, debug) pair once at the top of a function, then use
 // the returned tracker to open phases with a single short call:
 //
@@ -91,11 +93,6 @@ function logPhaseStart(console, debug, label) {
 //   ...work...
 //   timings.x = p.end();
 function makePhaseTracker(console, debug) {
-  return (label) => logPhaseStart(console, debug, label);
+    return (label) => logPhaseStart(console, debug, label);
 }
-
-module.exports = {
-  createPageProgress,
-  logTracedPage,
-  makePhaseTracker,
-};
+//# sourceMappingURL=progress.js.map

package/lib/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"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"}

package/lib/sfntCache.d.ts

@@ -0,0 +1,4 @@
+type FontBuffer = Buffer | Uint8Array;
+export declare function toSfnt(buffer: FontBuffer): Promise<FontBuffer>;
+export {};
+//# sourceMappingURL=sfntCache.d.ts.map

package/lib/sfntCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfntCache.d.ts","sourceRoot":"","sources":["../src/sfntCache.ts"],"names":[],"mappings":"AAGA,KAAK,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;AAItC,wBAAgB,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CA2B9D"}