@mlightcad/cad-html-exporter-cli

Node.js command-line example that converts a DXF or DWG file into a self-contained offline HTML viewer (same pipeline as the browser Export HTML command).

The CLI drives a headless Chromium instance (Playwright) that runs the same viewer code path as cad-simple-viewer-example, then writes the packaged HTML to disk.

Prerequisites

• Node.js 20+
• Network access on first run (Playwright downloads Chromium; fonts load from CDN during export)

From the monorepo root:

pnpm install
pnpm --filter @mlightcad/cad-html-exporter-cli install-browser
pnpm --filter @mlightcad/cad-html-exporter-cli build

Usage

# From the package directory
node dist/cli.js path/to/drawing.dxf

# Or via the bin name (after pnpm link / workspace install)
pnpm exec cad-html-exporter path/to/drawing.dwg -o out/viewer.html

# Chinese UI in the exported HTML
pnpm exec cad-html-exporter drawing.dxf --locale zh -o drawing.html

Options

| Option | Description | |--------|-------------| | -o, --output <path> | Output HTML file (default: input name with .html) | | --locale <code> | Embedded viewer locale (en, zh, …) | | --title <text> | Title in snapshot metadata / <title> | | --no-export-invisible-layers | Exclude off/frozen layer geometry (default: included) | | --initial-view <fit\|current> | Initial view when opening HTML (fit = zoom extents, default) |

How it works

1. Vite builds runner/ → dist-runner/ (viewer + workers + viewer-runtime.iife.js).
2. Playwright serves dist-runner locally and calls window.exportCadToHtml().
3. The runner uses AcApDocManager → AcApHtmlSnapshotBuilder → packHtml.
4. The CLI writes the returned HTML string to -o.

The generated HTML opens offline in any browser; Node.js is not required to view it.

Project layout

| Path | Role | |------|------| | src/cli.ts | Commander CLI entry | | src/exportToHtml.ts | Playwright orchestration | | runner/ | Browser export harness (Vite input) | | dist-runner/ | Built runner (created by pnpm build) |