@linkiez/dxf-renew 5.3.1 → 7.1.0

package/docs/DIMENSION_SUMMARY.md

@@ -2,7 +2,9 @@
 
 ## Overview
 
-The `DIMENSION` entity has been fully implemented with complete support for the `DIMSTYLE` system, including parsing, storage, and SVG rendering of all 6 DXF dimension types.
+The `DIMENSION` entity is implemented with support for the `DIMSTYLE` system, including parsing, storage, and SVG rendering.
+
+SVG rendering supports DXF dimension types 0/1/2/3/4/5/6.
 
 ## Implementation Status
 
@@ -45,7 +47,7 @@ The `DIMENSION` entity has been fully implemented with complete support for the
 
 ### ✅ Phase 3: Advanced Rendering (100%)
 
-All 6 dimension types implemented with precise geometry:
+Dimension types implemented with precise geometry:
 
 #### 1. Linear Dimension (types 0 and 1)
 
@@ -91,6 +93,8 @@ All 6 dimension types implemented with precise geometry:
 * Text only at textMidpoint position
 * File: `renderFallbackDimension()`
 
+
+
 ### ✅ Phase 4: Colors and Refinements (100%)
 
 #### DIMSTYLE Colors (100%)
@@ -111,19 +115,21 @@ Implementation:
 
 #### Optional Features (Not Implemented)
 
-**Custom Arrow Blocks (⏸️ Low Priority)**
+##### Custom Arrow Blocks (⏸️ Low Priority)
 
 * DIMBLK, DIMBLK1, DIMBLK2 parsed and available
 * Requires complex integration with INSERT renderer
 * Fallback to standard triangular arrows works in most cases
 
-**Tolerances and Alternate Units (⏸️ Low Priority)**
+
+##### Tolerances and Alternate Units (⏸️ Low Priority)
 
 * DIMTOL, DIMALT and related properties parsed
 * Requires complex multi-line text formatting
 * Simple text sufficient for most cases
 
-**XDATA Overrides (⏸️ Rare Edge Case)**
+
+##### XDATA Overrides (⏸️ Rare Edge Case)
 
 * Per-entity DIMSTYLE property overrides via XDATA
 * Not implemented

package/docs/DXF_VERSION_SUPPORT.md

@@ -0,0 +1,45 @@
+# DXF Version Support
+
+## Current Position
+
+The parser is designed around DXF group codes and sections, and does not currently gate behavior on `$ACADVER`.
+
+In practice, this means:
+
+- We aim to **parse and render** supported entities across many DXF versions.
+- We treat `$ACADVER` primarily as a fixture metadata signal and future compatibility hook.
+
+## What “Latest AutoCAD DXF” Means Here
+
+AutoCAD introduces newer DXF versions over time (reflected in `$ACADVER`). Supporting “the latest” is best defined as:
+
+- The library can load DXF files produced by recent AutoCAD versions **without rejecting due to version**, and
+- The library has fixtures that include a recent `$ACADVER` value, validated by ezdxf.
+
+## Recommended Strategy
+
+1. **Track `$ACADVER` in fixture validation**
+   - Use `yarn validate:fixtures` to report `$ACADVER` for every fixture.
+
+2. **Add at least one fixture exported from a recent AutoCAD version**
+   - Keep it small and single-purpose.
+   - Prefer a fixture that includes DIMENSION + text (to exercise newer text encoding and styles).
+
+3. **Add an integration test for that fixture**
+   - The goal is “does not throw + expected key SVG features exist”.
+
+4. **Add a policy (doc + CI)**
+   - Document which `$ACADVER` values are present in fixtures.
+   - Optionally enforce a minimum accepted `$ACADVER` in fixtures if the project wants to keep up with AutoCAD releases.
+
+## Non-Goals
+
+- Guarantee support for every new entity introduced by new DXF versions.
+- Guarantee binary DXF support (unless explicitly added).
+
+## Follow-ups (If Needed)
+
+If we need version-specific behavior later, add:
+
+- A header helper that exposes `$ACADVER` in a typed way.
+- Tests that cover version-specific parsing/rendering differences.

package/docs/ENTITY_SVG_ROADMAP.md

@@ -0,0 +1,96 @@
+# Entity SVG Roadmap (Fixture → ezdxf → SVG Integration)
+
+This roadmap is a **repeatable checklist** for each DXF entity:
+
+1. Confirm/produce a fixture in `test/resources/`
+2. Validate it with ezdxf
+3. Add/extend unit parsing tests
+4. Add final SVG integration tests
+
+The goal is incremental coverage: one entity at a time, with fixtures and tests proving end-to-end behavior.
+
+## Template (Use For Every Entity)
+
+### 1) Fixture
+
+- Add or pick a DXF fixture in `test/resources/<entity>-<scenario>.dxf`.
+- Keep fixtures minimal: only the needed sections/entities.
+
+### 2) ezdxf validation
+
+- Run `yarn validate:fixtures`
+- Confirm:
+  - The file loads in ezdxf
+  - `$ACADVER` is present and sane
+  - Entity type counts include your target entity
+
+### 3) Unit tests
+
+- Add unit parsing tests under `test/unit/`.
+- Assert minimum required fields for the entity type.
+
+### 4) SVG integration tests
+
+- Add `test/integration-browser/<entity>-rendering.browser.spec.js`.
+- Assert:
+  - `<svg ...>` envelope
+  - `viewBox="..."`
+  - Required SVG elements exist
+  - Key attributes exist (markers, transforms, href, etc)
+  - Expected text content (when applicable)
+
+#### Saved PNG per entity (required)
+
+Every browser integration test should save a screenshot to `test/rendered/` for manual review.
+
+- Use deterministic naming tied to the fixture: `test/rendered/<fixture-name>.png`
+- Overwrite is expected (re-running tests updates the same file).
+
+See: `docs/SVG_RENDERING_INTEGRATION_TESTS.md` (Saved Render Artifacts section)
+
+## DIMENSION (Start Here)
+
+### Fixture(s)
+
+- `test/resources/dimension-vertical.dxf`
+- `test/resources/dimensions.dxf` (optional secondary)
+
+### ezdxf validation
+
+- Run `yarn validate:fixtures`
+- Confirm `dimension-vertical.dxf` includes `DIMENSION` in modelspace.
+
+### Unit tests
+
+Already present:
+
+- `test/unit/dimensions.test.js`
+
+### SVG integration test
+
+Implemented:
+
+- `test/integration-browser/dimension-rendering.browser.spec.js`
+
+Assertions:
+
+- Marker definitions exist (prefix-based regex)
+- Dimension line references `marker-start` and `marker-end`
+- Dimension text appears in the SVG (`5.35`)
+
+## Next Entities (Suggested Order)
+
+This order prioritizes entities already in the codebase and/or those that tend to break rendering pipelines.
+
+1. TEXT
+2. MTEXT
+3. LEADER
+4. TOLERANCE
+5. IMAGE / IMAGEDEF
+6. UNDERLAY (DWF/DGN/PDF underlay entities)
+7. INSERT (block expansion)
+8. HATCH
+9. LWPOLYLINE / POLYLINE
+10. SPLINE
+
+For each, create at least one “single entity” fixture and one “mixed scene” fixture.

package/docs/EZDXF_REFERENCE_SITEMAP.md

@@ -0,0 +1,55 @@
+# ezdxf Reference Sitemap (Stable)
+
+This project uses the official **ezdxf** documentation as the primary, practical reference when implementing DXF parsing behavior.
+
+- Reference home: <https://ezdxf.readthedocs.io/en/stable/reference.html>
+
+## What to use for what
+
+- **High-level DXF structure (sections/tables/blocks/entities/objects):**
+  - Sections index: <https://ezdxf.readthedocs.io/en/stable/sections/index.html>
+  - Tables index: <https://ezdxf.readthedocs.io/en/stable/tables/index.html>
+  - Blocks index: <https://ezdxf.readthedocs.io/en/stable/blocks/index.html>
+
+- **Entity-specific group codes and attributes (our roadmap A.1):**
+  - DXF Entities index: <https://ezdxf.readthedocs.io/en/stable/dxfentities/index.html>
+
+  Common 2D targets:
+  - TEXT: <https://ezdxf.readthedocs.io/en/stable/dxfentities/text.html>
+  - MTEXT: <https://ezdxf.readthedocs.io/en/stable/dxfentities/mtext.html>
+  - DIMENSION: <https://ezdxf.readthedocs.io/en/stable/dxfentities/dimension.html>
+  - LEADER: <https://ezdxf.readthedocs.io/en/stable/dxfentities/leader.html>
+  - MLEADER: <https://ezdxf.readthedocs.io/en/stable/dxfentities/mleader.html>
+  - IMAGE: <https://ezdxf.readthedocs.io/en/stable/dxfentities/image.html>
+  - UNDERLAY: <https://ezdxf.readthedocs.io/en/stable/dxfentities/underlay.html>
+  - WIPEOUT: <https://ezdxf.readthedocs.io/en/stable/dxfentities/wipeout.html>
+  - RAY: <https://ezdxf.readthedocs.io/en/stable/dxfentities/ray.html>
+  - XLINE: <https://ezdxf.readthedocs.io/en/stable/dxfentities/xline.html>
+  - TRACE: <https://ezdxf.readthedocs.io/en/stable/dxfentities/trace.html>
+  - REGION: <https://ezdxf.readthedocs.io/en/stable/dxfentities/region.html>
+  - SHAPE: <https://ezdxf.readthedocs.io/en/stable/dxfentities/shape.html>
+  - MLINE: <https://ezdxf.readthedocs.io/en/stable/dxfentities/mline.html>
+
+- **Objects (our roadmap A.3):**
+  - DXF Objects index: <https://ezdxf.readthedocs.io/en/stable/dxfobjects/index.html>
+
+  Common reference-based objects:
+  - DICTIONARY: <https://ezdxf.readthedocs.io/en/stable/dxfobjects/dictionary.html>
+  - XRECORD: <https://ezdxf.readthedocs.io/en/stable/dxfobjects/xrecord.html>
+  - ImageDef / ImageDefReactor: <https://ezdxf.readthedocs.io/en/stable/dxfobjects/imagedef.html>
+  - UnderlayDefinition: <https://ezdxf.readthedocs.io/en/stable/dxfobjects/underlaydef.html>
+  - MLeaderStyle: <https://ezdxf.readthedocs.io/en/stable/dxfobjects/mleaderstyle.html>
+
+- **Tables (our roadmap A.2):**
+  - Layer: <https://ezdxf.readthedocs.io/en/stable/tables/layer_table_entry.html>
+  - DimStyle: <https://ezdxf.readthedocs.io/en/stable/tables/dimstyle_table_entry.html>
+  - Style: <https://ezdxf.readthedocs.io/en/stable/tables/style_table_entry.html>
+  - Linetype: <https://ezdxf.readthedocs.io/en/stable/tables/linetype_table_entry.html>
+  - View: <https://ezdxf.readthedocs.io/en/stable/tables/view_table_entry.html>
+  - AppID: <https://ezdxf.readthedocs.io/en/stable/tables/appid_table_entry.html>
+  - UCS: <https://ezdxf.readthedocs.io/en/stable/tables/ucs_table_entry.html>
+  - BlockRecord: <https://ezdxf.readthedocs.io/en/stable/tables/blockrecord_table_entry.html>
+
+## Notes
+
+- ezdxf tracks DXF internals closely, but it is still an implementation. When behavior is ambiguous, treat Autodesk’s DXF reference as the authoritative source.

package/docs/FIXTURE_VALIDATION_EZDXF.md

@@ -0,0 +1,62 @@
+# DXF Fixture Validation (ezdxf)
+
+## Goal
+
+Ensure every DXF fixture under `test/resources/` is:
+
+- Readable by **ezdxf** (independent parser), and
+- Free of audit fatal errors (and optionally free of audit errors).
+
+This provides an external sanity check so our test fixtures stay “real DXF” and not just “files our parser happens to accept”.
+
+## How It Works
+
+The project includes a small validator:
+
+- `tools/ezdxf_validate_fixtures.py`
+
+It:
+
+1. Enumerates `test/resources/*.dxf`
+2. Loads each file via `ezdxf.readfile(...)`
+3. Extracts `$ACADVER`
+4. Counts entity types in modelspace
+5. Runs `doc.audit()` and reports counts
+
+## Run Locally
+
+- `yarn validate:fixtures`
+
+Notes:
+
+- If `./.venv-ezdxf/bin/python` exists, the script uses it.
+- Otherwise it falls back to `python3`.
+
+## Failure Policy
+
+By default (current yarn script):
+
+- Fails if any fixture cannot be read by ezdxf
+- Fails if audit reports fatal errors or errors
+
+If you need a “report-only” run, execute the script directly:
+
+- `./.venv-ezdxf/bin/python tools/ezdxf_validate_fixtures.py`
+
+## Using the Report
+
+Use the printed per-file summary to:
+
+- Verify a new fixture’s `$ACADVER` is what you expect
+- Confirm an entity appears in the file (entity type counts)
+- Catch malformed DXF output from generators
+
+## Adding/Updating Fixtures
+
+When adding a new fixture:
+
+1. Add the DXF file under `test/resources/`.
+2. Run `yarn validate:fixtures`.
+3. Add unit tests (parsing) and integration tests (final SVG).
+
+See also: `docs/ENTITY_SVG_ROADMAP.md` (fixture → ezdxf → tests checklist)

package/docs/README.md

@@ -0,0 +1,22 @@
+# Documentation
+
+This folder contains the project documentation. The goal is to keep docs small, focused, and non-overlapping.
+
+## Where to Start
+
+- Entity support overview: `docs/IMPLEMENTED-2D-ENTITIES.md`
+- DXF version support notes: `docs/DXF_VERSION_SUPPORT.md`
+- TEXT / MTEXT / DIMENSION notes: `docs/TEXT-MTEXT-DIMENSION-SUPPORT.md`
+- DIMENSION summary (implementation-specific): `docs/DIMENSION_SUMMARY.md`
+
+## Testing & Fixtures
+
+- End-to-end SVG tests (Playwright): `docs/SVG_RENDERING_INTEGRATION_TESTS.md`
+- Fixture validation via ezdxf: `docs/FIXTURE_VALIDATION_EZDXF.md`
+- Entity-by-entity workflow (fixture → ezdxf → tests): `docs/ENTITY_SVG_ROADMAP.md`
+
+## References
+
+- ezdxf reference sitemap for this repo: `docs/EZDXF_REFERENCE_SITEMAP.md`
+
+Note: `docs/autocad_2012_pdf_dxf-reference_enu.md` is a local reference copy and is not part of the maintained documentation flow.

package/docs/SVG_RENDERING_INTEGRATION_TESTS.md

@@ -0,0 +1,119 @@
+# SVG Rendering Integration Tests
+
+## Goal
+
+Add end-to-end tests that validate the **final SVG output** for real DXF fixtures:
+
+`DXF fixture → parseString() → (optional denormalise) → toSVG() → SVG assertions`
+
+The project already has strong unit tests for geometry and parsing. This document defines a predictable integration-test layer to catch regressions at the “final render” boundary.
+
+## Framework Choice
+
+Run the final rendering integration tests in a **real browser** using **Playwright**.
+
+Rationale:
+
+- Executes the same rendering code path in a browser runtime.
+- Enables future pixel/screenshot tests (if ever needed) without changing frameworks.
+- Still supports stable structural assertions (regex/DOM parsing) for deterministic checks.
+
+## Where Tests Live
+
+- Integration tests: `test/integration/**`
+- Browser integration tests: `test/integration-browser/**`
+- DXF fixtures: `test/resources/*.dxf`
+
+Browser harness:
+
+- `test/browser/harness.html`
+- Served by `tools/browser_test_server.cjs`
+
+Scripts:
+
+- `yarn test:integration` (browser, via Playwright)
+- `yarn test:integration:node` (legacy Node-only integration tests)
+
+## What Integration Tests Should Assert
+
+Integration tests should focus on **stable, user-visible output** and avoid overfitting internal implementation details.
+
+Recommended assertions (in order):
+
+1. **SVG well-formed envelope**
+   - Contains `<svg` and `</svg>`
+   - Includes `viewBox="..."`
+
+2. **Entity-specific rendering markers**
+   - Presence of SVG elements expected for the entity type (`<line>`, `<path>`, `<circle>`, `<text>`, `<image>`)
+
+3. **Critical attributes**
+   - For example: `marker-start/marker-end` for DIMENSION arrows
+   - For example: correct path command type for ARC (`A`) or SPLINE (`C/Q`)
+
+4. **Text content (when applicable)**
+   - Assert the final SVG contains the expected text payload
+
+5. **No crashes on full fixture set**
+   - A single integration test can iterate a curated list of fixtures and ensure rendering does not throw.
+
+### Saved Render Artifacts (PNG)
+
+Browser integration tests should save a screenshot under `test/rendered/` for manual review.
+
+- The file can be overwritten on re-run.
+- Prefer a deterministic filename tied to the fixture name, e.g. `test/rendered/dimension-vertical.png`.
+
+Note: these PNGs are tracked in git. If you regenerate them, include the updated files in your PR.
+
+### Handling Non-Deterministic IDs
+
+Some renderers generate IDs using `Date.now()` (e.g. DIMENSION arrow markers). Integration tests should validate **prefix-based patterns**:
+
+- `dim-arrow-start-\d+`
+- `dim-arrow-end-\d+`
+
+Avoid asserting the full exact ID.
+
+## Golden Files (Optional)
+
+If/when the project wants pixel-perfect or full-SVG snapshots, consider adding a “golden SVG” snapshot layer.
+
+Guidelines:
+
+- Only snapshot **small, stable fixtures**.
+- Normalize dynamic values (e.g. marker IDs) before snapshotting.
+- Keep snapshots per-fixture under `test/snapshots/`.
+
+This is intentionally optional; regex-based structural assertions are the default.
+
+## DIMENSION: First Integration Target
+
+Start with fixtures that include real DIMENSION output:
+
+- `test/resources/dimension-vertical.dxf`
+
+Suggested assertions:
+
+- Markers exist (`<marker id="dim-arrow-start-..."`)
+- Dimension line uses `marker-start/marker-end`
+- Text appears in SVG (fixture includes `5.35`)
+
+See:
+
+- `test/integration-browser/dimension-rendering.browser.spec.js`
+
+## Adding a New Integration Test (Checklist)
+
+1. Pick or create a DXF fixture under `test/resources/`.
+2. (Recommended) Validate it with `yarn validate:fixtures` (see `docs/FIXTURE_VALIDATION_EZDXF.md`).
+3. Add a new `test/integration/*.integration.test.js`.
+   - Or, for browser execution, add `test/integration-browser/*.browser.spec.js`.
+4. Assert:
+   - SVG envelope + viewBox
+   - Entity-specific elements
+   - Critical attributes
+   - Screenshot is saved to `test/rendered/<fixture-name>.png` (overwrite on re-run)
+5. Run:
+   - `yarn test:unit`
+   - `yarn test:integration`

package/docs/TEXT-MTEXT-DIMENSION-SUPPORT.md

@@ -154,7 +154,7 @@ const helper = new Helper(dxfString)const helper = new Helper(dxfString)
 
 const svg = helper.toSVG()const svg = helper.toSVG()
 
-``````
+```
 
 
 

package/lib/Helper.cjs

@@ -79,8 +79,8 @@ class Helper {
     }
     return this._groups;
   }
-  toSVG() {
-    return (0, import_toSVG.default)(this.parsed);
+  toSVG(options) {
+    return (0, import_toSVG.default)(this.parsed, options);
   }
   toPolylines() {
     return (0, import_toPolylines.default)(this.parsed);

package/lib/Helper.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/Helper.ts"],
-  "sourcesContent": ["import denormalise from './denormalise'\nimport groupEntitiesByLayer from './groupEntitiesByLayer'\nimport parseString from './parseString'\nimport toPolylines from './toPolylines'\nimport toSVG from './toSVG'\nimport logger from './util/logger'\n\nimport type { Entity, LayerGroups, ParsedDXF } from './types'\n\nexport default class Helper {\n  private readonly _contents: string\n  private _parsed: ParsedDXF | null\n  private _denormalised: Entity[] | null\n  private _groups: LayerGroups | null\n\n  constructor(contents: string) {\n    if (typeof contents !== 'string') {\n      throw new TypeError('Helper constructor expects a DXF string')\n    }\n    this._contents = contents\n    this._parsed = null\n    this._denormalised = null\n    this._groups = null\n  }\n\n  parse(): ParsedDXF {\n    this._parsed = parseString(this._contents)\n    logger.info('parsed:', this.parsed)\n    return this._parsed\n  }\n\n  get parsed(): ParsedDXF {\n    if (this._parsed === null) {\n      this.parse()\n    }\n    return this._parsed as ParsedDXF\n  }\n\n  denormalise(): Entity[] {\n    this._denormalised = denormalise(this.parsed)\n    logger.info('denormalised:', this._denormalised)\n    return this._denormalised\n  }\n\n  get denormalised(): Entity[] {\n    if (!this._denormalised) {\n      this.denormalise()\n    }\n    return this._denormalised as Entity[]\n  }\n\n  group(): LayerGroups {\n    this._groups = groupEntitiesByLayer(this.denormalised)\n    return this._groups\n  }\n\n  get groups(): LayerGroups {\n    if (!this._groups) {\n      this.group()\n    }\n    return this._groups as LayerGroups\n  }\n\n  toSVG(): string {\n    return toSVG(this.parsed)\n  }\n\n  toPolylines(): ReturnType<typeof toPolylines> {\n    return toPolylines(this.parsed)\n  }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAwB;AACxB,kCAAiC;AACjC,yBAAwB;AACxB,yBAAwB;AACxB,mBAAkB;AAClB,oBAAmB;AAInB,MAAO,OAAqB;AAAA,EAM1B,YAAY,UAAkB;AAC5B,QAAI,OAAO,aAAa,UAAU;AAChC,YAAM,IAAI,UAAU,yCAAyC;AAAA,IAC/D;AACA,SAAK,YAAY;AACjB,SAAK,UAAU;AACf,SAAK,gBAAgB;AACrB,SAAK,UAAU;AAAA,EACjB;AAAA,EAEA,QAAmB;AACjB,SAAK,cAAU,mBAAAA,SAAY,KAAK,SAAS;AACzC,kBAAAC,QAAO,KAAK,WAAW,KAAK,MAAM;AAClC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,SAAoB;AACtB,QAAI,KAAK,YAAY,MAAM;AACzB,WAAK,MAAM;AAAA,IACb;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,cAAwB;AACtB,SAAK,oBAAgB,mBAAAC,SAAY,KAAK,MAAM;AAC5C,kBAAAD,QAAO,KAAK,iBAAiB,KAAK,aAAa;AAC/C,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,eAAyB;AAC3B,QAAI,CAAC,KAAK,eAAe;AACvB,WAAK,YAAY;AAAA,IACnB;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,QAAqB;AACnB,SAAK,cAAU,4BAAAE,SAAqB,KAAK,YAAY;AACrD,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,SAAsB;AACxB,QAAI,CAAC,KAAK,SAAS;AACjB,WAAK,MAAM;AAAA,IACb;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,QAAgB;AACd,eAAO,aAAAC,SAAM,KAAK,MAAM;AAAA,EAC1B;AAAA,EAEA,cAA8C;AAC5C,eAAO,mBAAAC,SAAY,KAAK,MAAM;AAAA,EAChC;AACF;",
+  "sourcesContent": ["import denormalise from './denormalise'\nimport groupEntitiesByLayer from './groupEntitiesByLayer'\nimport parseString from './parseString'\nimport toPolylines from './toPolylines'\nimport toSVG from './toSVG'\nimport logger from './util/logger'\n\nimport type { Entity, LayerGroups, ParsedDXF, ToSVGOptions } from './types'\n\nexport default class Helper {\n  private readonly _contents: string\n  private _parsed: ParsedDXF | null\n  private _denormalised: Entity[] | null\n  private _groups: LayerGroups | null\n\n  constructor(contents: string) {\n    if (typeof contents !== 'string') {\n      throw new TypeError('Helper constructor expects a DXF string')\n    }\n    this._contents = contents\n    this._parsed = null\n    this._denormalised = null\n    this._groups = null\n  }\n\n  parse(): ParsedDXF {\n    this._parsed = parseString(this._contents)\n    logger.info('parsed:', this.parsed)\n    return this._parsed\n  }\n\n  get parsed(): ParsedDXF {\n    if (this._parsed === null) {\n      this.parse()\n    }\n    return this._parsed as ParsedDXF\n  }\n\n  denormalise(): Entity[] {\n    this._denormalised = denormalise(this.parsed)\n    logger.info('denormalised:', this._denormalised)\n    return this._denormalised\n  }\n\n  get denormalised(): Entity[] {\n    if (!this._denormalised) {\n      this.denormalise()\n    }\n    return this._denormalised as Entity[]\n  }\n\n  group(): LayerGroups {\n    this._groups = groupEntitiesByLayer(this.denormalised)\n    return this._groups\n  }\n\n  get groups(): LayerGroups {\n    if (!this._groups) {\n      this.group()\n    }\n    return this._groups as LayerGroups\n  }\n\n  toSVG(options?: ToSVGOptions): string {\n    return toSVG(this.parsed, options)\n  }\n\n  toPolylines(): ReturnType<typeof toPolylines> {\n    return toPolylines(this.parsed)\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAwB;AACxB,kCAAiC;AACjC,yBAAwB;AACxB,yBAAwB;AACxB,mBAAkB;AAClB,oBAAmB;AAInB,MAAO,OAAqB;AAAA,EAM1B,YAAY,UAAkB;AAC5B,QAAI,OAAO,aAAa,UAAU;AAChC,YAAM,IAAI,UAAU,yCAAyC;AAAA,IAC/D;AACA,SAAK,YAAY;AACjB,SAAK,UAAU;AACf,SAAK,gBAAgB;AACrB,SAAK,UAAU;AAAA,EACjB;AAAA,EAEA,QAAmB;AACjB,SAAK,cAAU,mBAAAA,SAAY,KAAK,SAAS;AACzC,kBAAAC,QAAO,KAAK,WAAW,KAAK,MAAM;AAClC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,SAAoB;AACtB,QAAI,KAAK,YAAY,MAAM;AACzB,WAAK,MAAM;AAAA,IACb;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,cAAwB;AACtB,SAAK,oBAAgB,mBAAAC,SAAY,KAAK,MAAM;AAC5C,kBAAAD,QAAO,KAAK,iBAAiB,KAAK,aAAa;AAC/C,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,eAAyB;AAC3B,QAAI,CAAC,KAAK,eAAe;AACvB,WAAK,YAAY;AAAA,IACnB;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,QAAqB;AACnB,SAAK,cAAU,4BAAAE,SAAqB,KAAK,YAAY;AACrD,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,SAAsB;AACxB,QAAI,CAAC,KAAK,SAAS;AACjB,WAAK,MAAM;AAAA,IACb;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,SAAgC;AACpC,eAAO,aAAAC,SAAM,KAAK,QAAQ,OAAO;AAAA,EACnC;AAAA,EAEA,cAA8C;AAC5C,eAAO,mBAAAC,SAAY,KAAK,MAAM;AAAA,EAChC;AACF;",
   "names": ["parseString", "logger", "denormalise", "groupEntitiesByLayer", "toSVG", "toPolylines"]
 }

package/lib/Helper.js

@@ -46,8 +46,8 @@ class Helper {
     }
     return this._groups;
   }
-  toSVG() {
-    return toSVG(this.parsed);
+  toSVG(options) {
+    return toSVG(this.parsed, options);
   }
   toPolylines() {
     return toPolylines(this.parsed);

package/lib/Helper.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/Helper.ts"],
-  "sourcesContent": ["import denormalise from './denormalise'\nimport groupEntitiesByLayer from './groupEntitiesByLayer'\nimport parseString from './parseString'\nimport toPolylines from './toPolylines'\nimport toSVG from './toSVG'\nimport logger from './util/logger'\n\nimport type { Entity, LayerGroups, ParsedDXF } from './types'\n\nexport default class Helper {\n  private readonly _contents: string\n  private _parsed: ParsedDXF | null\n  private _denormalised: Entity[] | null\n  private _groups: LayerGroups | null\n\n  constructor(contents: string) {\n    if (typeof contents !== 'string') {\n      throw new TypeError('Helper constructor expects a DXF string')\n    }\n    this._contents = contents\n    this._parsed = null\n    this._denormalised = null\n    this._groups = null\n  }\n\n  parse(): ParsedDXF {\n    this._parsed = parseString(this._contents)\n    logger.info('parsed:', this.parsed)\n    return this._parsed\n  }\n\n  get parsed(): ParsedDXF {\n    if (this._parsed === null) {\n      this.parse()\n    }\n    return this._parsed as ParsedDXF\n  }\n\n  denormalise(): Entity[] {\n    this._denormalised = denormalise(this.parsed)\n    logger.info('denormalised:', this._denormalised)\n    return this._denormalised\n  }\n\n  get denormalised(): Entity[] {\n    if (!this._denormalised) {\n      this.denormalise()\n    }\n    return this._denormalised as Entity[]\n  }\n\n  group(): LayerGroups {\n    this._groups = groupEntitiesByLayer(this.denormalised)\n    return this._groups\n  }\n\n  get groups(): LayerGroups {\n    if (!this._groups) {\n      this.group()\n    }\n    return this._groups as LayerGroups\n  }\n\n  toSVG(): string {\n    return toSVG(this.parsed)\n  }\n\n  toPolylines(): ReturnType<typeof toPolylines> {\n    return toPolylines(this.parsed)\n  }\n}\n"],
-  "mappings": "AAAA,OAAO,iBAAiB;AACxB,OAAO,0BAA0B;AACjC,OAAO,iBAAiB;AACxB,OAAO,iBAAiB;AACxB,OAAO,WAAW;AAClB,OAAO,YAAY;AAInB,MAAO,OAAqB;AAAA,EAM1B,YAAY,UAAkB;AAC5B,QAAI,OAAO,aAAa,UAAU;AAChC,YAAM,IAAI,UAAU,yCAAyC;AAAA,IAC/D;AACA,SAAK,YAAY;AACjB,SAAK,UAAU;AACf,SAAK,gBAAgB;AACrB,SAAK,UAAU;AAAA,EACjB;AAAA,EAEA,QAAmB;AACjB,SAAK,UAAU,YAAY,KAAK,SAAS;AACzC,WAAO,KAAK,WAAW,KAAK,MAAM;AAClC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,SAAoB;AACtB,QAAI,KAAK,YAAY,MAAM;AACzB,WAAK,MAAM;AAAA,IACb;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,cAAwB;AACtB,SAAK,gBAAgB,YAAY,KAAK,MAAM;AAC5C,WAAO,KAAK,iBAAiB,KAAK,aAAa;AAC/C,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,eAAyB;AAC3B,QAAI,CAAC,KAAK,eAAe;AACvB,WAAK,YAAY;AAAA,IACnB;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,QAAqB;AACnB,SAAK,UAAU,qBAAqB,KAAK,YAAY;AACrD,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,SAAsB;AACxB,QAAI,CAAC,KAAK,SAAS;AACjB,WAAK,MAAM;AAAA,IACb;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,QAAgB;AACd,WAAO,MAAM,KAAK,MAAM;AAAA,EAC1B;AAAA,EAEA,cAA8C;AAC5C,WAAO,YAAY,KAAK,MAAM;AAAA,EAChC;AACF;",
+  "sourcesContent": ["import denormalise from './denormalise'\nimport groupEntitiesByLayer from './groupEntitiesByLayer'\nimport parseString from './parseString'\nimport toPolylines from './toPolylines'\nimport toSVG from './toSVG'\nimport logger from './util/logger'\n\nimport type { Entity, LayerGroups, ParsedDXF, ToSVGOptions } from './types'\n\nexport default class Helper {\n  private readonly _contents: string\n  private _parsed: ParsedDXF | null\n  private _denormalised: Entity[] | null\n  private _groups: LayerGroups | null\n\n  constructor(contents: string) {\n    if (typeof contents !== 'string') {\n      throw new TypeError('Helper constructor expects a DXF string')\n    }\n    this._contents = contents\n    this._parsed = null\n    this._denormalised = null\n    this._groups = null\n  }\n\n  parse(): ParsedDXF {\n    this._parsed = parseString(this._contents)\n    logger.info('parsed:', this.parsed)\n    return this._parsed\n  }\n\n  get parsed(): ParsedDXF {\n    if (this._parsed === null) {\n      this.parse()\n    }\n    return this._parsed as ParsedDXF\n  }\n\n  denormalise(): Entity[] {\n    this._denormalised = denormalise(this.parsed)\n    logger.info('denormalised:', this._denormalised)\n    return this._denormalised\n  }\n\n  get denormalised(): Entity[] {\n    if (!this._denormalised) {\n      this.denormalise()\n    }\n    return this._denormalised as Entity[]\n  }\n\n  group(): LayerGroups {\n    this._groups = groupEntitiesByLayer(this.denormalised)\n    return this._groups\n  }\n\n  get groups(): LayerGroups {\n    if (!this._groups) {\n      this.group()\n    }\n    return this._groups as LayerGroups\n  }\n\n  toSVG(options?: ToSVGOptions): string {\n    return toSVG(this.parsed, options)\n  }\n\n  toPolylines(): ReturnType<typeof toPolylines> {\n    return toPolylines(this.parsed)\n  }\n}\n"],
+  "mappings": "AAAA,OAAO,iBAAiB;AACxB,OAAO,0BAA0B;AACjC,OAAO,iBAAiB;AACxB,OAAO,iBAAiB;AACxB,OAAO,WAAW;AAClB,OAAO,YAAY;AAInB,MAAO,OAAqB;AAAA,EAM1B,YAAY,UAAkB;AAC5B,QAAI,OAAO,aAAa,UAAU;AAChC,YAAM,IAAI,UAAU,yCAAyC;AAAA,IAC/D;AACA,SAAK,YAAY;AACjB,SAAK,UAAU;AACf,SAAK,gBAAgB;AACrB,SAAK,UAAU;AAAA,EACjB;AAAA,EAEA,QAAmB;AACjB,SAAK,UAAU,YAAY,KAAK,SAAS;AACzC,WAAO,KAAK,WAAW,KAAK,MAAM;AAClC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,SAAoB;AACtB,QAAI,KAAK,YAAY,MAAM;AACzB,WAAK,MAAM;AAAA,IACb;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,cAAwB;AACtB,SAAK,gBAAgB,YAAY,KAAK,MAAM;AAC5C,WAAO,KAAK,iBAAiB,KAAK,aAAa;AAC/C,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,eAAyB;AAC3B,QAAI,CAAC,KAAK,eAAe;AACvB,WAAK,YAAY;AAAA,IACnB;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,QAAqB;AACnB,SAAK,UAAU,qBAAqB,KAAK,YAAY;AACrD,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,SAAsB;AACxB,QAAI,CAAC,KAAK,SAAS;AACjB,WAAK,MAAM;AAAA,IACb;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,SAAgC;AACpC,WAAO,MAAM,KAAK,QAAQ,OAAO;AAAA,EACnC;AAAA,EAEA,cAA8C;AAC5C,WAAO,YAAY,KAAK,MAAM;AAAA,EAChC;AACF;",
   "names": []
 }