maplibre-font-maker-node 0.1.0 → 0.2.0

package/README.md

@@ -1,4 +1,4 @@
-# font-maker-node
+# maplibre-font-maker-node
 
 A TypeScript library for generating MapLibre-compatible glyph PBF files in memory from TTF, OTF, WOFF, or WOFF2 font bytes. 
 Variable fonts are supported, but a specific instantiation must be chosen, so you should supply a value for each axis. 
@@ -6,7 +6,7 @@ Variable fonts are supported, but a specific instantiation must be chosen, so yo
 ## Usage
 
 ```ts
-import { generateGlyphPbfFiles, latinRanges } from 'font-maker-node';
+import { generateGlyphPbfFiles, latinRanges } from 'maplibre-font-maker-node';
 
 const files = await generateGlyphPbfFiles({
   fontstack: 'Barlow Regular',
@@ -33,6 +33,46 @@ The result is an array of in-memory files:
 
 The caller is responsible for writing files to disk if desired. The public API does not read font files or write output files. The only filesystem access performed by the library is loading the vendored `maplibre-font-maker/sdfglyph.js` and `maplibre-font-maker/sdfglyph.wasm` runtime files during initialization.
 
+## CLI
+
+The same package ships a thin command-line wrapper around `generateGlyphPbfFiles`. It reads a font file, generates the glyphs, and writes them to disk.
+
+```bash
+npx maplibre-font-maker-node \
+    --font ./fonts/Barlow-Regular.ttf \
+    --fontstack "Barlow Regular" \
+    --output ./dist/fonts \
+    --ranges latin
+```
+
+This writes the MapLibre-ready layout `<output>/<fontstack>/<start>-<end>.pbf`, e.g. `./dist/fonts/Barlow Regular/0-255.pbf` — exactly the `{fontstack}/{range}.pbf` structure MapLibre's `glyphs` URL expects. Output directories are created automatically.
+
+| Option | Description |
+| --- | --- |
+| `--font <path>` | Input font file (TTF, OTF, WOFF, or WOFF2). Required. |
+| `--fontstack <name>` | MapLibre font stack name. Required. |
+| `--output <dir>` | Output directory. Required. |
+| `--ranges <preset>` | Glyph range preset: `basic-latin`, `latin`, or `all-bmp`. Default: `latin`. |
+| `--force` | Overwrite existing output files. Without it, the command fails if any target file already exists. |
+| `--help` | Show usage. |
+| `--version` | Show the package version. |
+
+The CLI exits with code `1` on any failure (missing argument, font not found, invalid preset, generation error), so it fails the surrounding script in CI.
+
+### Use it as a build step
+
+Because npm exposes the binary on `node_modules/.bin`, you can call it by name from a downstream project's lifecycle scripts to generate glyphs into your build output:
+
+```json
+{
+  "scripts": {
+    "prebuild": "maplibre-font-maker-node --font ./fonts/Barlow-Regular.ttf --fontstack \"Barlow Regular\" --output ./dist/fonts --ranges latin --force"
+  }
+}
+```
+
+`prebuild` runs automatically before `build`. Use `--force` so repeated builds don't fail on already-generated files. Each invocation handles one font; chain multiple commands with `&&` for several font stacks.
+
 ## API
 
 ```ts

package/dist/cli/parse-args.d.ts

@@ -0,0 +1,17 @@
+export interface CliOptions {
+    font: string;
+    fontstack: string;
+    output: string;
+    ranges: string;
+    force: boolean;
+}
+export type ParsedArgs = {
+    kind: 'help';
+} | {
+    kind: 'version';
+} | {
+    kind: 'run';
+    options: CliOptions;
+};
+export declare function parseCliArgs(argv: string[]): ParsedArgs;
+//# sourceMappingURL=parse-args.d.ts.map

package/dist/cli/parse-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.d.ts","sourceRoot":"","sources":["../../src/cli/parse-args.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAIzC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA6CvD"}

package/dist/cli/parse-args.js

@@ -0,0 +1,49 @@
+import { parseArgs } from 'node:util';
+import { RANGE_PRESETS } from './resolve-ranges.js';
+const DEFAULT_RANGES = 'latin';
+export function parseCliArgs(argv) {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args: argv,
+            allowPositionals: false,
+            strict: true,
+            options: {
+                font: { type: 'string' },
+                fontstack: { type: 'string' },
+                output: { type: 'string' },
+                ranges: { type: 'string', default: DEFAULT_RANGES },
+                force: { type: 'boolean', default: false },
+                help: { type: 'boolean', default: false },
+                version: { type: 'boolean', default: false },
+            },
+        }));
+    }
+    catch (error) {
+        throw new Error(error instanceof Error ? error.message : String(error));
+    }
+    if (values.help) {
+        return { kind: 'help' };
+    }
+    if (values.version) {
+        return { kind: 'version' };
+    }
+    const font = requireOption(values.font, 'font');
+    const fontstack = requireOption(values.fontstack, 'fontstack');
+    const output = requireOption(values.output, 'output');
+    const ranges = values.ranges ?? DEFAULT_RANGES;
+    if (!RANGE_PRESETS.includes(ranges)) {
+        throw new Error(`Invalid --ranges preset "${ranges}". Valid presets are: ${RANGE_PRESETS.join(', ')}.`);
+    }
+    return {
+        kind: 'run',
+        options: { font, fontstack, output, ranges, force: values.force ?? false },
+    };
+}
+function requireOption(value, name) {
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`Missing required option --${name}.`);
+    }
+    return value;
+}
+//# sourceMappingURL=parse-args.js.map

package/dist/cli/parse-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.js","sourceRoot":"","sources":["../../src/cli/parse-args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAepD,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,IAAI,MAAM,CAAC;IAEX,IAAI,CAAC;QACH,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;YACtB,IAAI,EAAE,IAAI;YACV,gBAAgB,EAAE,KAAK;YACvB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC7B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE;gBACnD,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;gBAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;gBACzC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;aAC7C;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,cAAc,CAAC;IAE/C,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,4BAA4B,MAAM,yBAAyB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACvF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,KAAK,EAAE;KAC3E,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAyB,EAAE,IAAY;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cli/print-summary.d.ts

@@ -0,0 +1,7 @@
+export interface Summary {
+    fontstack: string;
+    fileCount: number;
+    output: string;
+}
+export declare function printSummary({ fontstack, fileCount, output }: Summary): void;
+//# sourceMappingURL=print-summary.d.ts.map

package/dist/cli/print-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-summary.d.ts","sourceRoot":"","sources":["../../src/cli/print-summary.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,GAAG,IAAI,CAM5E"}

package/dist/cli/print-summary.js

@@ -0,0 +1,8 @@
+export function printSummary({ fontstack, fileCount, output }) {
+    console.log('Generated:');
+    console.log(`  Font stack:  ${fontstack}`);
+    console.log(`  Files:       ${fileCount}`);
+    console.log(`  Output:      ${output}`);
+    console.log('Done.');
+}
+//# sourceMappingURL=print-summary.js.map

package/dist/cli/print-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-summary.js","sourceRoot":"","sources":["../../src/cli/print-summary.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,YAAY,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAW;IACpE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC"}

package/dist/cli/resolve-ranges.d.ts

@@ -0,0 +1,4 @@
+import type { GlyphRange } from '../index.js';
+export declare const RANGE_PRESETS: string[];
+export declare function resolveRanges(preset: string): GlyphRange[];
+//# sourceMappingURL=resolve-ranges.d.ts.map

package/dist/cli/resolve-ranges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-ranges.d.ts","sourceRoot":"","sources":["../../src/cli/resolve-ranges.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQ9C,eAAO,MAAM,aAAa,UAAuB,CAAC;AAElD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAU1D"}

package/dist/cli/resolve-ranges.js

@@ -0,0 +1,15 @@
+import { allBmpRanges, basicLatinRanges, latinRanges } from '../index.js';
+const PRESETS = {
+    'basic-latin': basicLatinRanges,
+    latin: latinRanges,
+    'all-bmp': allBmpRanges,
+};
+export const RANGE_PRESETS = Object.keys(PRESETS);
+export function resolveRanges(preset) {
+    const build = PRESETS[preset];
+    if (!build) {
+        throw new Error(`Invalid --ranges preset "${preset}". Valid presets are: ${RANGE_PRESETS.join(', ')}.`);
+    }
+    return build();
+}
+//# sourceMappingURL=resolve-ranges.js.map

package/dist/cli/resolve-ranges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-ranges.js","sourceRoot":"","sources":["../../src/cli/resolve-ranges.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1E,MAAM,OAAO,GAAuC;IAClD,aAAa,EAAE,gBAAgB;IAC/B,KAAK,EAAE,WAAW;IAClB,SAAS,EAAE,YAAY;CACxB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAElD,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,4BAA4B,MAAM,yBAAyB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACvF,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,EAAE,CAAC;AACjB,CAAC"}

package/dist/cli/write-generated-files.d.ts

@@ -0,0 +1,6 @@
+import type { GeneratedGlyphPbfFile } from '../index.js';
+export interface WriteOptions {
+    force: boolean;
+}
+export declare function writeGeneratedFiles(files: GeneratedGlyphPbfFile[], outputDirectory: string, { force }: WriteOptions): Promise<void>;
+//# sourceMappingURL=write-generated-files.d.ts.map

package/dist/cli/write-generated-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-generated-files.d.ts","sourceRoot":"","sources":["../../src/cli/write-generated-files.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,qBAAqB,EAAE,EAC9B,eAAe,EAAE,MAAM,EACvB,EAAE,KAAK,EAAE,EAAE,YAAY,GACtB,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/cli/write-generated-files.js

@@ -0,0 +1,32 @@
+import { access, mkdir, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+export async function writeGeneratedFiles(files, outputDirectory, { force }) {
+    const destinations = files.map((file) => ({
+        bytes: file.bytes,
+        path: join(outputDirectory, file.filename),
+    }));
+    if (!force) {
+        const existing = await findExisting(destinations.map((destination) => destination.path));
+        if (existing.length > 0) {
+            throw new Error(`Refusing to overwrite ${existing.length} existing file(s). Pass --force to overwrite:\n` +
+                existing.map((path) => `  ${path}`).join('\n'));
+        }
+    }
+    for (const destination of destinations) {
+        await mkdir(dirname(destination.path), { recursive: true });
+        await writeFile(destination.path, destination.bytes);
+    }
+}
+async function findExisting(paths) {
+    const checks = await Promise.all(paths.map(async (path) => {
+        try {
+            await access(path);
+            return path;
+        }
+        catch {
+            return undefined;
+        }
+    }));
+    return checks.filter((path) => path !== undefined);
+}
+//# sourceMappingURL=write-generated-files.js.map

package/dist/cli/write-generated-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-generated-files.js","sourceRoot":"","sources":["../../src/cli/write-generated-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQ1C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAA8B,EAC9B,eAAuB,EACvB,EAAE,KAAK,EAAgB;IAEvB,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC;KAC3C,CAAC,CAAC,CAAC;IAEJ,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAEzF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,yBAAyB,QAAQ,CAAC,MAAM,iDAAiD;gBACvF,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACjD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,KAAe;IACzC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AACrE,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAgCA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAcvD"}

package/dist/cli.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { readFile } from 'node:fs/promises';
+import { pathToFileURL } from 'node:url';
+import { generateGlyphPbfFiles } from './index.js';
+import { parseCliArgs } from './cli/parse-args.js';
+import { printSummary } from './cli/print-summary.js';
+import { resolveRanges } from './cli/resolve-ranges.js';
+import { writeGeneratedFiles } from './cli/write-generated-files.js';
+const HELP_TEXT = `maplibre-font-maker-node
+
+Generate MapLibre glyph PBF files from TTF, OTF, WOFF, or WOFF2 fonts.
+
+Usage:
+  maplibre-font-maker-node \\
+      --font <file.ttf> \\
+      --fontstack "Barlow Regular" \\
+      --output ./fonts
+
+Options:
+  --font        Input font file (required)
+  --fontstack   MapLibre font stack name (required)
+  --output      Output directory (required)
+  --ranges      Glyph range preset: basic-latin | latin | all-bmp (default: latin)
+  --force       Overwrite existing files
+  --help        Show this help
+  --version     Show version
+`;
+export async function run(argv) {
+    const parsed = parseCliArgs(argv);
+    if (parsed.kind === 'help') {
+        console.log(HELP_TEXT);
+        return;
+    }
+    if (parsed.kind === 'version') {
+        console.log(await readVersion());
+        return;
+    }
+    await generate(parsed.options);
+}
+async function generate(options) {
+    const fontBytes = await readFontFile(options.font);
+    const ranges = resolveRanges(options.ranges);
+    const files = await generateGlyphPbfFiles({
+        fontstack: options.fontstack,
+        fonts: [{ name: options.fontstack, bytes: fontBytes }],
+        ranges,
+    });
+    await writeGeneratedFiles(files, options.output, { force: options.force });
+    printSummary({
+        fontstack: options.fontstack,
+        fileCount: files.length,
+        output: options.output,
+    });
+}
+async function readFontFile(path) {
+    try {
+        return new Uint8Array(await readFile(path));
+    }
+    catch (error) {
+        if (isErrnoException(error) && error.code === 'ENOENT') {
+            throw new Error(`Font file not found: ${path}`);
+        }
+        throw new Error(`Failed to read font file "${path}": ${formatError(error)}`);
+    }
+}
+async function readVersion() {
+    const packageUrl = new URL('../package.json', import.meta.url);
+    const manifest = JSON.parse(await readFile(packageUrl, 'utf8'));
+    return manifest.version ?? 'unknown';
+}
+function isErrnoException(error) {
+    return error instanceof Error && 'code' in error;
+}
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+const invokedPath = process.argv[1];
+if (invokedPath && pathToFileURL(invokedPath).href === import.meta.url) {
+    run(process.argv.slice(2)).catch((error) => {
+        console.error(formatError(error));
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maplibre-font-maker-node",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Generate MapLibre-compatible glyph PBF files in memory from TTF, OTF, WOFF, or WOFF2 font bytes.",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,6 +11,9 @@
       "import": "./dist/index.js"
     }
   },
+  "bin": {
+    "maplibre-font-maker-node": "./dist/cli.js"
+  },
   "files": [
     "dist",
     "maplibre-font-maker",