1.5.8 • Published yesterdayCLI

@mlightcad/cad-html-exporter-cli

Licence

—

Version

1.5.8

Deps

Size

18.7 MB

Vulns

Weekly

Stars

839

Summary Dependency Versions

@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

Vite builds runner/ → dist-runner/ (viewer + workers + viewer-runtime.iife.js).
Playwright serves dist-runner locally and calls window.exportCadToHtml().
The runner uses AcApDocManager → AcApHtmlSnapshotBuilder → packHtml.
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`)