@linkiez/dxf-renew 5.3.1

package/docs/IMPLEMENTED-2D-ENTITIES.md

@@ -0,0 +1,54 @@
+# List of DXF 2D Entities
+
+This list was generated based on the AutoCAD 2012 DXF reference documentation. It catalogs 2D entities, indicating whether they have already been implemented in this project.
+
+| Entity | Implemented | Description |
+| :--- | :---: | :--- |
+| **ARC** | ✅ | A circular arc. |
+| **CIRCLE** | ✅ | A circle. |
+| **ELLIPSE** | ✅ | An ellipse or elliptical arc. |
+| **HATCH** | ✅ | Fills a bounded area with a pattern, solid color, or gradient. |
+| **LINE** | ✅ | A straight line segment. |
+| **LWPOLYLINE** | ✅ | A lightweight 2D polyline. |
+| **MTEXT** | ✅ | Multi-line text with advanced formatting. |
+| **POINT** | ✅ | A point entity. |
+| **POLYLINE** | ✅ | A 2D or 3D polyline (with vertices). |
+| **SOLID** | ✅ | A 2D area filled with solid color. |
+| **SPLINE** | ✅ | A spline curve. |
+| **TEXT** | ✅ | A single line of text. |
+| **DIMENSION** | ✅ | Dimension entity (linear, angular, radial, etc.). **Complete implementation**: text and styleName parsing, DIMSTYLE integration (68+ properties), rendering of 6 dimension types with extension lines, arrows, text rotation, color support (DIMCLRD, DIMCLRE, DIMCLRT) and line weights (DIMLWD, DIMLWE). See `docs/DIMENSION_IMPLEMENTATION_PLAN.md` for details. |
+| **INSERT** | ✅ | A block insertion (block reference). |
+| **ATTDEF** | ✅ | Attribute definition for a block. |
+| **ATTRIB** | ✅ | An attribute instance attached to a block. |
+| **OLE2FRAME** | ✅ | An OLE (Object Linking and Embedding) object. |
+| **LEADER** | ❌ | A leader line, used for annotations. Creates a line that connects the annotation to a feature in a drawing. |
+| **MLINE** | ❌ | A multi-line entity with parallel lines. |
+| **RAY** | ❌ | A semi-infinite line that extends infinitely in one direction from its start point. |
+| **SHAPE** | ❌ | A shape from a shape file (.shx). Inserts a named shape from a shape file that has already been loaded using the LOAD command. |
+| **TOLERANCE** | ❌ | A geometric tolerance. Creates geometric tolerances contained in a feature control frame. |
+| **TRACE** | ❌ | A solid 2D line with width. |
+| **WIPEOUT** | ❌ | An area that masks other objects with the background color. |
+| **XLINE** | ❌ | An infinite construction line. |
+
+---
+
+## 3D Entities (For Reference)
+
+| Entity | Implemented | Description |
+| :--- | :---: | :--- |
+| **3DFACE** | ✅ | A three-dimensional face. |
+| **3DSOLID** | ❌ | A 3D ACIS solid object. Displays 3D solids as wireframe or shaded objects. |
+| **BODY** | ❌ | A 3D ACIS body object. |
+| **HELIX** | ❌ | A 3D helix. |
+| **IMAGE** | ❌ | A raster image. |
+| **LIGHT** | ❌ | A light source. |
+| **MESH** | ❌ | A 3D mesh. |
+| **REGION** | ❌ | A closed 2D area (region). |
+| **SECTION** | ❌ | A section object. |
+| **SUN** | ❌ | A sun light object. |
+| **SURFACE** | ❌ | A 3D surface (extruded, loft, etc.). |
+| **TABLE** | ❌ | A table entity. |
+| **UNDERLAY** | ❌ | An underlay (e.g., DWF, DGN, PDF). |
+| **VIEWPORT** | ✅ | A viewport in paper space. |
+
+*Note: The `POLYLINE` implementation may include 3D vertices, but the entity itself is often used for 2D shapes.*

package/docs/IMPLEMENTED-2D-ENTITIES.pt-BR.md

@@ -0,0 +1,54 @@
+# Lista de Entidades DXF 2D
+
+Esta lista foi gerada com base na documentação de referência do AutoCAD 2012 DXF. Ela cataloga as entidades 2D, indicando se já foram implementadas neste projeto.
+
+| Entidade | Implementado | Descrição |
+| :--- | :---: | :--- |
+| **ARC** | ✅ | Um arco circular. |
+| **CIRCLE** | ✅ | Um círculo. |
+| **ELLIPSE** | ✅ | Uma elipse ou um arco elíptico. |
+| **HATCH** | ✅ | Preenche uma área delimitada com um padrão, cor sólida ou gradiente. |
+| **LINE** | ✅ | Um segmento de linha reta. |
+| **LWPOLYLINE** | ✅ | Uma polilinha 2D leve (lightweight). |
+| **MTEXT** | ✅ | Texto de múltiplas linhas com formatação avançada. |
+| **POINT** | ✅ | Uma entidade de ponto. |
+| **POLYLINE** | ✅ | Uma polilinha 2D ou 3D (com vértices). |
+| **SOLID** | ✅ | Uma área 2D preenchida com cor sólida. |
+| **SPLINE** | ✅ | Uma curva spline. |
+| **TEXT** | ✅ | Uma única linha de texto. |
+| **DIMENSION** | ✅ | Entidade de dimensão (linear, angular, radial, etc.). **Implementação completa**: parsing de text e styleName, integração com DIMSTYLE (68+ propriedades), renderização de 6 tipos de dimensão com extension lines, setas, rotação de texto, suporte a cores (DIMCLRD, DIMCLRE, DIMCLRT) e espessuras (DIMLWD, DIMLWE). Ver `docs/DIMENSION_IMPLEMENTATION_PLAN.md` para detalhes. |
+| **INSERT** | ✅ | Uma inserção de bloco (block reference). |
+| **ATTDEF** | ✅ | Definição de atributo para um bloco. |
+| **ATTRIB** | ✅ | Uma instância de atributo anexada a um bloco. |
+| **OLE2FRAME** | ✅ | Um objeto OLE (Object Linking and Embedding). |
+| **LEADER** | ❌ | Uma linha de chamada, usada para anotações. Cria uma linha que conecta a anotação a um recurso em um desenho. |
+| **MLINE** | ❌ | Uma entidade de múltiplas linhas paralelas. |
+| **RAY** | ❌ | Uma linha semi-infinita que se estende infinitamente em uma direção a partir de seu ponto inicial. |
+| **SHAPE** | ❌ | Uma forma de um arquivo de formas (.shx). Insere uma forma nomeada a partir de um arquivo de forma que já tenha sido carregado usando o comando LOAD. |
+| **TOLERANCE** | ❌ | Uma tolerância geométrica. Cria tolerâncias geométricas contidas em um quadro de controle de recurso. |
+| **TRACE** | ❌ | Uma linha 2D sólida com espessura. |
+| **WIPEOUT** | ❌ | Uma área que mascara outros objetos com a cor de fundo. |
+| **XLINE** | ❌ | Uma linha de construção infinita. |
+
+---
+
+## Entidades 3D (Para Referência)
+
+| Entidade | Implementado | Descrição |
+| :--- | :---: | :--- |
+| **3DFACE** | ✅ | Uma face tridimensional. |
+| **3DSOLID** | ❌ | Um objeto sólido ACIS 3D. Exibe sólidos 3D como objetos de arame ou sombreados. |
+| **BODY** | ❌ | Um objeto de corpo ACIS 3D. |
+| **HELIX** | ❌ | Uma hélice 3D. |
+| **IMAGE** | ❌ | Uma imagem raster. |
+| **LIGHT** | ❌ | Uma fonte de luz. |
+| **MESH** | ❌ | Uma malha 3D. |
+| **REGION** | ❌ | Uma área 2D fechada (região). |
+| **SECTION** | ❌ | Um objeto de seção. |
+| **SUN** | ❌ | Um objeto de luz solar. |
+| **SURFACE** | ❌ | Uma superfície 3D (extrudada, loft, etc.). |
+| **TABLE** | ❌ | Uma entidade de tabela. |
+| **UNDERLAY** | ❌ | Uma subjacência (ex: DWF, DGN, PDF). |
+| **VIEWPORT** | ✅ | Uma viewport em paper space. |
+
+*Observação: A implementação de `POLYLINE` pode incluir vértices 3D, mas a entidade em si é frequentemente usada para formas 2D.*

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

@@ -0,0 +1,241 @@
+# TEXT, MTEXT and DIMENSION - SVG Rendering Support# TEXT, MTEXT e DIMENSION - Suporte de Renderização SVG
+
+## Summary of Changes## Resumo das Mudanças
+
+Added complete support for rendering TEXT, MTEXT, and DIMENSION entities in SVG.Adicionado suporte completo para renderização de entidades TEXT, MTEXT e DIMENSION em SVG.
+
+## Supported Entities## Entidades Suportadas
+
+### TEXT### TEXT
+
+- Basic text rendering- Renderização básica de texto
+
+- Rotation support (code 50)- Suporte para rotação (código 50)
+
+- Positioning support (codes 10, 20, 30)- Suporte para posicionamento (códigos 10, 20, 30)
+
+- Text height support (code 40)- Suporte para altura do texto (código 40)
+
+- Horizontal and vertical alignment (codes 72, 73)- Alinhamento horizontal e vertical (códigos 72, 73)
+
+### MTEXT### MTEXT
+
+- Multi-line text rendering- Renderização de texto multilinha
+
+- Rotation support via X-axis direction (codes 11, 21)- Suporte para rotação via direção do eixo X (códigos 11, 21)
+
+- Reference rectangle width support (code 41)- Suporte para largura do retângulo de referência (código 41)
+
+- Nominal text height (code 40)- Altura nominal do texto (código 40)
+
+- Attachment point (code 71)- Ponto de fixação (código 71)
+
+### DIMENSION### DIMENSION
+
+Support for all dimension types:Suporte para todos os tipos de dimensão:
+
+#### Type 0 - Rotated, horizontal or vertical#### Tipo 0 - Rotated, horizontal ou vertical
+
+- Extension lines- Linhas de extensão
+
+- Dimension line- Linha de dimensão
+
+- Dimension text- Texto de dimensão
+
+#### Type 1 - Aligned#### Tipo 1 - Aligned (alinhada)
+
+- Dimension line aligned with measured points- Linha de dimensão alinhada com os pontos medidos
+
+- Perpendicular extension lines- Linhas de extensão perpendiculares
+
+#### Type 2 - Angular#### Tipo 2 - Angular (angular)
+
+- Angle dimension between two lines- Dimensão de ângulo entre duas linhas
+
+#### Type 3 - Diameter#### Tipo 3 - Diameter (diâmetro)
+
+- Radial dimension line for diameters- Linha de dimensão radial para diâmetros
+
+- Text with diameter symbol- Texto com símbolo de diâmetro
+
+#### Type 4 - Radius#### Tipo 4 - Radius (raio)
+
+- Radial dimension line- Linha de dimensão radial
+
+- Text with R prefix- Texto com prefixo R
+
+#### Type 5 - Angular 3 point#### Tipo 5 - Angular 3 point (angular 3 pontos)
+
+- Angular dimension defined by 3 points- Dimensão angular definida por 3 pontos
+
+#### Type 6 - Ordinate#### Tipo 6 - Ordinate (ordenada)
+
+- X or Y coordinate dimension- Dimensão de coordenada X ou Y
+
+- Simple extension line- Linha de extensão simples
+
+## Implemented DXF Codes## Códigos DXF Implementados
+
+### TEXT
+
+| Code | Description || Código | Descrição |
+
+|------|-------------||--------|-----------|
+
+| 1 | Text content || 1 | Conteúdo do texto |
+
+| 10, 20, 30 | Insertion point (x, y, z) || 10, 20, 30 | Ponto de inserção (x, y, z) |
+
+| 11, 21, 31 | Second alignment point || 11, 21, 31 | Segundo ponto de alinhamento |
+
+| 40 | Text height || 40 | Altura do texto |
+
+| 41 | Relative X scale || 41 | Escala relativa X |
+
+| 50 | Rotation in degrees || 50 | Rotação em graus |
+
+| 51 | Oblique angle || 51 | Ângulo oblíquo |
+
+| 72 | Horizontal alignment || 72 | Alinhamento horizontal |
+
+| 73 | Vertical alignment || 73 | Alinhamento vertical |
+
+### MTEXT### MTEXT
+
+| Code | Description || Código | Descrição |
+
+|------|-------------||--------|-----------|
+
+| 1, 3 | Text content || 1, 3 | Conteúdo do texto |
+
+| 10, 20, 30 | Insertion point || 10, 20, 30 | Ponto de inserção |
+
+| 11, 21, 31 | X-axis direction || 11, 21, 31 | Direção do eixo X |
+
+| 40 | Nominal text height || 40 | Altura nominal do texto |
+
+| 41 | Reference rectangle width || 41 | Largura do retângulo de referência |
+
+| 71 | Attachment point || 71 | Ponto de fixação |
+
+| 72 | Drawing direction || 72 | Direção do desenho |
+
+### DIMENSION### DIMENSION
+
+| Code | Description || Código | Descrição |
+
+|------|-------------||--------|-----------|
+
+| 2 | Block name || 2 | Nome do bloco |
+
+| 10, 20, 30 | Definition point || 10, 20, 30 | Ponto de definição |
+
+| 11, 21, 31 | Text midpoint || 11, 21, 31 | Ponto médio do texto |
+
+| 13, 23, 33 | Measurement start point || 13, 23, 33 | Ponto inicial da medida |
+
+| 14, 24, 34 | Measurement end point || 14, 24, 34 | Ponto final da medida |
+
+| 50 | Rotation angle || 50 | Ângulo de rotação |
+
+| 70 | Dimension type || 70 | Tipo de dimensão |
+
+## Usage Example## Exemplo de Uso
+
+```javascript```javascript
+
+import { Helper } from '@linkiez/dxf-renew'
+
+const dxfString = `... DXF content ...`const dxfString = `... conteúdo DXF ...`
+
+const helper = new Helper(dxfString)const helper = new Helper(dxfString)
+
+// Convert to SVG (now includes TEXT, MTEXT and DIMENSION)// Converter para SVG (agora inclui TEXT, MTEXT e DIMENSION)
+
+const svg = helper.toSVG()const svg = helper.toSVG()
+
+``````
+
+
+
+## Tests## Testes
+
+
+
+Unit tests have been added in `test/unit/text-mtext-dimension-rendering.js` that verify:Foram adicionados testes unitários em `test/unit/text-mtext-dimension-rendering.js` que verificam:
+
+
+
+- Basic TEXT rendering- Renderização básica de TEXT
+
+- Basic MTEXT rendering- Renderização básica de MTEXT
+
+- DIMENSION rendering- Renderização de DIMENSION
+
+- TEXT rotation- Rotação de TEXT
+
+- MTEXT rotation via X-axis direction- Rotação de MTEXT via direção do eixo X
+
+- Different DIMENSION types- Diferentes tipos de DIMENSION
+
+
+
+Run tests with:Execute os testes com:
+
+
+
+```bash```bash
+
+npm testnpm test
+
+``````
+
+## Visual Example## Exemplo Visual
+
+An interactive visual example is available at `examples/text-dimension-viewer.html`.Um exemplo visual interativo está disponível em `examples/text-dimension-viewer.html`.
+
+To view:Para visualizar:
+
+1. Run `npm run build` to generate the bundle1. Execute `npm run build` para gerar o bundle
+
+2. Open `examples/text-dimension-viewer.html` in a browser2. Abra `examples/text-dimension-viewer.html` em um navegador
+
+3. Load a DXF file or use the provided test files3. Carregue um arquivo DXF ou use os arquivos de teste fornecidos
+
+## Known Limitations## Limitações Conhecidas
+
+1. **TEXT and MTEXT**:1. **TEXT e MTEXT**:
+
+   - Font is not respected (uses browser default font)   - Fonte não é respeitada (usa fonte padrão do navegador)
+
+   - Complex MTEXT formatting is not fully supported   - Formatação complexa de MTEXT não é totalmente suportada
+
+   - Bounding box calculation is approximate   - Cálculo de bounding box é aproximado
+
+2. **DIMENSION**:2. **DIMENSION**:
+
+   - Custom dimension blocks are not rendered   - Blocos de dimensão personalizados não são renderizados
+
+   - Only basic dimension lines are drawn   - Apenas linhas básicas de dimensão são desenhadas
+
+   - Dimension text is not displayed (needs to be extracted from block)   - Texto de dimensão não é exibido (precisa ser extraído do bloco)
+
+   - Arrows are not rendered   - Setas não são renderizadas
+
+## Modified Files## Arquivos Modificados
+
+- `src/toSVG.js`: Added `text()`, `mtext()`, `dimension()` and `createDimensionPaths()` functions- `src/toSVG.js`: Adicionadas funções `text()`, `mtext()`, `dimension()` e `createDimensionPaths()`
+
+- `test/unit/text-mtext-dimension-rendering.js`: New unit tests- `test/unit/text-mtext-dimension-rendering.js`: Novos testes unitários
+
+- `examples/text-dimension-viewer.html`: Interactive visual example
+
+## Next Steps
+
+To further improve support:
+
+1. Implement dimension arrow rendering
+2. Extract and render dimension text from blocks
+3. Support custom text styles
+4. Improve bounding box calculation for text
+5. Support advanced MTEXT formatting (colors, bold, etc.)

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

@@ -0,0 +1,169 @@
+# TEXT, MTEXT e DIMENSION - Suporte de Renderização SVG
+
+## Resumo das Mudanças
+
+Adicionado suporte completo para renderização de entidades TEXT, MTEXT e DIMENSION em SVG.
+
+## Entidades Suportadas
+
+### TEXT
+
+- Renderização básica de texto
+- Suporte para rotação (código 50)
+- Suporte para posicionamento (códigos 10, 20, 30)
+- Suporte para altura do texto (código 40)
+- Alinhamento horizontal e vertical (códigos 72, 73)
+
+### MTEXT
+
+- Renderização de texto multilinha
+- Suporte para rotação via direção do eixo X (códigos 11, 21)
+- Suporte para largura do retângulo de referência (código 41)
+- Altura nominal do texto (código 40)
+- Ponto de fixação (código 71)
+
+### DIMENSION
+
+Suporte para todos os tipos de dimensão:
+
+#### Tipo 0 - Rotated, horizontal ou vertical
+
+- Linhas de extensão
+- Linha de dimensão
+- Texto de dimensão
+
+#### Tipo 1 - Aligned (alinhada)
+
+- Linha de dimensão alinhada com os pontos medidos
+- Linhas de extensão perpendiculares
+
+#### Tipo 2 - Angular (angular)
+
+- Dimensão de ângulo entre duas linhas
+
+#### Tipo 3 - Diameter (diâmetro)
+
+- Linha de dimensão radial para diâmetros
+- Texto com símbolo de diâmetro
+
+#### Tipo 4 - Radius (raio)
+
+- Linha de dimensão radial
+- Texto com prefixo R
+
+#### Tipo 5 - Angular 3 point (angular 3 pontos)
+
+- Dimensão angular definida por 3 pontos
+
+#### Tipo 6 - Ordinate (ordenada)
+
+- Dimensão de coordenada X ou Y
+- Linha de extensão simples
+
+## Códigos DXF Implementados
+
+### TEXT
+
+| Código | Descrição |
+|--------|-----------|
+| 1 | Conteúdo do texto |
+| 10, 20, 30 | Ponto de inserção (x, y, z) |
+| 11, 21, 31 | Segundo ponto de alinhamento |
+| 40 | Altura do texto |
+| 41 | Escala relativa X |
+| 50 | Rotação em graus |
+| 51 | Ângulo oblíquo |
+| 72 | Alinhamento horizontal |
+| 73 | Alinhamento vertical |
+
+### MTEXT
+
+| Código | Descrição |
+|--------|-----------|
+| 1, 3 | Conteúdo do texto |
+| 10, 20, 30 | Ponto de inserção |
+| 11, 21, 31 | Direção do eixo X |
+| 40 | Altura nominal do texto |
+| 41 | Largura do retângulo de referência |
+| 71 | Ponto de fixação |
+| 72 | Direção do desenho |
+
+### DIMENSION
+
+| Código | Descrição |
+|--------|-----------|
+| 2 | Nome do bloco |
+| 10, 20, 30 | Ponto de definição |
+| 11, 21, 31 | Ponto médio do texto |
+| 13, 23, 33 | Ponto inicial da medida |
+| 14, 24, 34 | Ponto final da medida |
+| 50 | Ângulo de rotação |
+| 70 | Tipo de dimensão |
+
+## Exemplo de Uso
+
+```javascript
+import { Helper } from '@linkiez/dxf-renew'
+
+const dxfString = `... conteúdo DXF ...`
+const helper = new Helper(dxfString)
+
+// Converter para SVG (agora inclui TEXT, MTEXT e DIMENSION)
+const svg = helper.toSVG()
+```
+
+## Testes
+
+Foram adicionados testes unitários em `test/unit/text-mtext-dimension-rendering.js` que verificam:
+
+- Renderização básica de TEXT
+- Renderização básica de MTEXT
+- Renderização de DIMENSION
+- Rotação de TEXT
+- Rotação de MTEXT via direção do eixo X
+- Diferentes tipos de DIMENSION
+
+Execute os testes com:
+
+```bash
+npm test
+```
+
+## Exemplo Visual
+
+Um exemplo visual interativo está disponível em `examples/text-dimension-viewer.html`.
+
+Para visualizar:
+
+1. Execute `npm run build` para gerar o bundle
+2. Abra `examples/text-dimension-viewer.html` em um navegador
+3. Carregue um arquivo DXF ou use os arquivos de teste fornecidos
+
+## Limitações Conhecidas
+
+1. **TEXT e MTEXT**:
+   - Fonte não é respeitada (usa fonte padrão do navegador)
+   - Formatação complexa de MTEXT não é totalmente suportada
+   - Cálculo de bounding box é aproximado
+
+2. **DIMENSION**:
+   - Blocos de dimensão personalizados não são renderizados
+   - Apenas linhas básicas de dimensão são desenhadas
+   - Texto de dimensão não é exibido (precisa ser extraído do bloco)
+   - Setas não são renderizadas
+
+## Arquivos Modificados
+
+- `src/toSVG.js`: Adicionadas funções `text()`, `mtext()`, `dimension()` e `createDimensionPaths()`
+- `test/unit/text-mtext-dimension-rendering.js`: Novos testes unitários
+- `examples/text-dimension-viewer.html`: Exemplo visual interativo
+
+## Próximos Passos
+
+Para melhorar ainda mais o suporte:
+
+1. Implementar renderização de setas de dimensão
+2. Extrair e renderizar texto de dimensão dos blocos
+3. Suportar estilos de texto personalizados
+4. Melhorar cálculo de bounding box para texto
+5. Suportar formatação avançada de MTEXT (cores, negrito, etc.)