@linkiez/dxf-renew 7.0.0 → 7.1.0

package/tools/ezdxf_validate_fixtures.py

@@ -0,0 +1,165 @@
+#!/usr/bin/env python3
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+from dataclasses import asdict, dataclass
+from pathlib import Path
+from typing import Any
+
+
+@dataclass
+class FixtureResult:
+    file: str
+    acadver: str | None
+    entities_total: int
+    entity_types: dict[str, int]
+    audit_errors: int
+    audit_fixes: int
+    audit_warnings: int
+    audit_has_fatal_error: bool
+
+
+def _get_acadver(doc: Any) -> str | None:
+    try:
+        return str(doc.header.get("$ACADVER"))
+    except Exception:
+        return None
+
+
+def _count_entity_types(doc: Any) -> tuple[int, dict[str, int]]:
+    counts: dict[str, int] = {}
+    total = 0
+
+    try:
+        msp = doc.modelspace()
+    except Exception:
+        return 0, {}
+
+    for e in msp:
+        total += 1
+        t = getattr(e, "dxftype", None)
+        if callable(t):
+            t = t()
+        t = str(t) if t is not None else "UNKNOWN"
+        counts[t] = counts.get(t, 0) + 1
+
+    return total, dict(sorted(counts.items(), key=lambda kv: kv[0]))
+
+
+def _audit(doc: Any) -> tuple[int, int, int, bool]:
+    # ezdxf audit returns an auditor object with attributes.
+    auditor = doc.audit()
+
+    errors = len(getattr(auditor, "errors", []) or [])
+    fixes = len(getattr(auditor, "fixes", []) or [])
+    warnings = len(getattr(auditor, "warnings", []) or [])
+
+    has_fatal = False
+    # Some ezdxf versions expose fatal_error as bool/str.
+    fatal_error = getattr(auditor, "fatal_error", None)
+    if fatal_error:
+        has_fatal = True
+
+    return errors, fixes, warnings, has_fatal
+
+
+def validate_fixture(path: Path) -> FixtureResult:
+    import ezdxf  # type: ignore
+
+    doc = ezdxf.readfile(str(path))
+
+    acadver = _get_acadver(doc)
+    entities_total, entity_types = _count_entity_types(doc)
+    audit_errors, audit_fixes, audit_warnings, audit_has_fatal_error = _audit(doc)
+
+    return FixtureResult(
+        file=str(path),
+        acadver=acadver,
+        entities_total=entities_total,
+        entity_types=entity_types,
+        audit_errors=audit_errors,
+        audit_fixes=audit_fixes,
+        audit_warnings=audit_warnings,
+        audit_has_fatal_error=audit_has_fatal_error,
+    )
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(
+        description="Validate DXF fixtures in test/resources using ezdxf"
+    )
+    parser.add_argument(
+        "--resources",
+        default=str(Path(__file__).resolve().parents[1] / "test" / "resources"),
+        help="Path to test/resources directory",
+    )
+    parser.add_argument(
+        "--json",
+        action="store_true",
+        help="Output machine-readable JSON",
+    )
+    parser.add_argument(
+        "--fail-on-audit-errors",
+        action="store_true",
+        help="Exit non-zero if ezdxf audit reports errors or fatal errors",
+    )
+
+    args = parser.parse_args()
+
+    resources_dir = Path(args.resources)
+    if not resources_dir.exists() or not resources_dir.is_dir():
+        raise SystemExit(f"resources dir not found: {resources_dir}")
+
+    dxf_files = sorted(resources_dir.glob("*.dxf"))
+
+    results: list[FixtureResult] = []
+    failures: list[str] = []
+
+    for f in dxf_files:
+        try:
+            results.append(validate_fixture(f))
+        except Exception as e:
+            failures.append(f"{f.name}: {e}")
+
+    if args.json:
+        payload = {
+            "resources": str(resources_dir),
+            "count": len(results),
+            "results": [asdict(r) for r in results],
+            "read_failures": failures,
+        }
+        print(json.dumps(payload, indent=2, sort_keys=True))
+    else:
+        print(f"Validated {len(results)} fixture(s) from {resources_dir}")
+        if failures:
+            print("\nRead failures:")
+            for msg in failures:
+                print(f"- {msg}")
+
+        # Print a compact per-file summary, sorted by filename.
+        for r in sorted(results, key=lambda x: os.path.basename(x.file)):
+            base = os.path.basename(r.file)
+            print(
+                f"{base}: acadver={r.acadver} entities={r.entities_total} "
+                f"audit(errors={r.audit_errors}, fixes={r.audit_fixes}, warnings={r.audit_warnings}, fatal={r.audit_has_fatal_error})"
+            )
+
+    # Failure policy:
+    # - Always fail if any file cannot be read by ezdxf.
+    # - Optionally fail on audit errors/fatal errors.
+    if failures:
+        return 2
+
+    if args.fail_on_audit_errors:
+        for r in results:
+            if r.audit_has_fatal_error or r.audit_errors > 0:
+                return 3
+
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/docs/DIMENSION_SUMMARY.pt-BR.md

@@ -1,248 +0,0 @@
-# Resumo da Implementação de DIMENSION
-
-## Visão Geral
-
-A entidade `DIMENSION` foi completamente implementada com suporte total ao sistema de estilos `DIMSTYLE`, incluindo parsing, armazenamento e renderização SVG de todos os 6 tipos de dimensão do DXF.
-
-## Status de Implementação
-
-### ✅ Fase 1: Parsing e Armazenamento de DIMSTYLE (100%)
-
-* **Handler de DIMSTYLE**: `src/handlers/tables.ts`
-  * 68+ propriedades parseadas via group codes
-  * Propriedades principais: DIMASZ (41), DIMTXT (140), DIMEXO (176), DIMEXE (177)
-  * Cores: DIMCLRD (176), DIMCLRE (177), DIMCLRT (178)
-  * Espessuras: DIMLWD (371), DIMLWE (372)
-  * Blocos de seta: DIMBLK (342), DIMBLK1 (343), DIMBLK2 (344)
-  * Tolerâncias: DIMTOL (71), DIMTOLJ (283)
-  * Unidades alternativas: DIMALT (170), DIMALTF (143), DIMALTD (171)
-
-* **Interfaces TypeScript**:
-  * `DimStyleInternal` em `src/types/tables.ts` (armazenamento interno)
-  * `DimStyleTable` em `src/types/dxf.ts` (API pública)
-
-* **Integração**:
-  * DIMSTYLE armazenado em `parsed.tables.dimStyles`
-  * Entidade DIMENSION vinculada ao estilo via `styleName`
-
-### ✅ Fase 2: Arquitetura Modular (100%)
-
-* **Módulo dedicado**: `src/dimensionToSVG.ts` (428 linhas)
-  * Dispatcher baseado em `entity.dimensionType`
-  * 6 funções especializadas de renderização
-  * Sistema de markers SVG para setas
-  * Funções helper para cores e geometria
-
-* **Funções principais**:
-  * `dimensionToSVG()`: Dispatcher principal
-  * `createArrowMarker()`: Criação de markers SVG com IDs únicos
-  * `colorNumberToSVG()`: Conversão de cores DXF (0-255) para RGB
-  * `getDimensionColors()`: Extração de cores do DIMSTYLE
-
-* **Integração com toSVG.ts**:
-  * `dimension()` chama `dimensionToSVG()` com DIMSTYLE correto
-  * Aplicação de transforms às dimensões
-
-### ✅ Fase 3: Renderização Avançada (100%)
-
-Todos os 6 tipos de dimensão implementados com geometria precisa:
-
-#### 1. Dimensão Linear (tipos 0 e 1)
-
-* Extension lines com offset (DIMEXO) e extensão (DIMEXE)
-* Cálculo de geometria perpendicular (angle + π/2)
-* Dimension line com setas nas extremidades
-* Texto rotacionado alinhado à dimensão
-* Arquivo: `renderLinearDimension()`
-
-#### 2. Dimensão Angular (tipo 2)
-
-* Extension lines radiais a partir do centro
-* Dimension line como arco SVG
-* Cálculo de large-arc flag para arcos > 180°
-* Setas nas extremidades do arco
-* Texto rotacionado no ângulo médio
-* Arquivo: `renderAngularDimension()`
-
-#### 3. Dimensão de Diâmetro (tipo 3)
-
-* Linha através do círculo
-* Símbolo ⌀ (Unicode U+2300) no texto
-* Seta única na extremidade
-* Arquivo: `renderDiameterDimension()`
-
-#### 4. Dimensão de Raio (tipo 4)
-
-* Linha do centro até a circunferência
-* Prefixo "R" no texto
-* Seta única na extremidade
-* Arquivo: `renderRadialDimension()`
-
-#### 5. Dimensão Ordenada (tipo 6)
-
-* Linha de chamada simples
-* Sem setas (conforme especificação DXF)
-* Texto com coordenada X ou Y
-* Arquivo: `renderOrdinateDimension()`
-
-#### 6. Fallback
-
-* Renderização mínima para tipos não suportados
-* Apenas texto na posição textMidpoint
-* Arquivo: `renderFallbackDimension()`
-
-### ✅ Fase 4: Cores e Refinamentos (100%)
-
-#### Cores DIMSTYLE (100%)
-
-* **DIMCLRD**: Cor das dimension lines
-* **DIMCLRE**: Cor das extension lines
-* **DIMCLRT**: Cor do texto
-* **DIMLWD**: Espessura das dimension lines
-* **DIMLWE**: Espessura das extension lines
-
-Implementação:
-
-* Tabela de cores DXF: `src/util/colors.ts` (267 cores)
-* Conversão DXF → RGB: `colorNumberToSVG()`
-* Casos especiais: 0 (ByBlock), 256 (ByLayer), 7 (white/black) → currentColor
-* Aplicado em todas as funções de renderização
-* Markers de seta herdam cor da dimension line
-
-#### Funcionalidades Opcionais (Não Implementadas)
-
-**Custom Arrow Blocks (⏸️ Baixa Prioridade)**
-
-* DIMBLK, DIMBLK1, DIMBLK2 parseados e disponíveis
-* Requer integração complexa com renderizador de INSERT
-* Fallback para setas triangulares padrão funciona na maioria dos casos
-
-**Tolerâncias e Unidades Alternativas (⏸️ Baixa Prioridade)**
-
-* DIMTOL, DIMALT e propriedades relacionadas parseadas
-* Requer formatação complexa de texto com múltiplas linhas
-* Texto simples suficiente para maioria dos casos
-
-  **XDATA Overrides (⏸️ Edge Case Raro)**
-
-* Overrides de propriedades DIMSTYLE por entidade via XDATA
-* Não implementado
-* DIMSTYLE padrão funciona na maioria dos casos
-
-## Arquivos Modificados
-
-### Criados
-
-* `src/dimensionToSVG.ts`: Módulo completo de renderização (428 linhas)
-* `docs/DIMENSION_IMPLEMENTATION_PLAN.md`: Plano detalhado de implementação
-* `docs/DIMENSION_SUMMARY.md`: Este arquivo
-
-### Modificados
-
-* `src/handlers/entity/dimension.ts`: Adicionado parsing de text (1) e styleName (3)
-* `src/types/dimension-entity.ts`: Adicionadas propriedades text e styleName
-* `src/handlers/tables.ts`: Handler completo de DIMSTYLE (68 propriedades)
-* `src/types/tables.ts`: Interface DimStyleInternal
-* `src/types/dxf.ts`: Interface DimStyleTable (API pública)
-* `src/toSVG.ts`: Integração com dimensionToSVG, passa dimStyles
-* `docs/ENTIDADES-2D-IMPLEMENTADAS.md`: Atualizada entrada de DIMENSION
-
-## Commits
-
-### Commit 1: Phases 1 & 2
-
-```text
-feat: adicionar parsing completo de DIMSTYLE e arquitetura modular para DIMENSION
-
-Fase 1: Parsing e Armazenamento de DIMSTYLE
-- Criar handler completo de DIMSTYLE com 68+ propriedades
-- Processar group codes: DIMASZ (41), DIMTXT (140), DIMEXO (176), DIMEXE (177), etc.
-- Adicionar interfaces DimStyleInternal e DimStyleTable
-- Integrar dimStyles no parsed.tables
-- Vincular DIMENSION entities ao seu DIMSTYLE via styleName
-
-Fase 2: Arquitetura Modular de Renderização
-- Criar módulo dedicado src/dimensionToSVG.ts
-- Implementar dispatcher baseado em dimensionType
-- Criar 6 funções especializadas de renderização
-- Adicionar createArrowMarker para SVG markers
-- Integrar dimensionToSVG com toSVG.ts
-```
-
-9 arquivos modificados, 874 inserções(+), 10 deleções(-)
-
-### Commit 2: Phase 3
-
-```text
-feat: implementar renderização avançada de dimensões com extension lines e setas
-
-Fase 3: Renderização Avançada
-- Implementar extension lines com DIMEXO (offset) e DIMEXE (extension)
-- Adicionar cálculo de geometria perpendicular para extension lines
-- Criar markers SVG para setas com IDs únicos (timestamp-based)
-- Implementar rotação de texto alinhada à dimensão
-- Adicionar dimensões angulares com arcos SVG
-- Implementar símbolos ⌀ e R para diâmetro/raio
-- Suportar dimensões de ordenada sem setas
-- Aplicar espessuras de linha configuráveis
-```
-
-2 arquivos modificados, 145 inserções(+), 30 deleções(-)
-
-### Commit 3: Phase 4 (Este Commit)
-
-```text
-feat: adicionar suporte completo a cores DIMSTYLE e documentação
-
-Fase 4: Cores e Refinamentos
-- Adicionar função colorNumberToSVG para conversão DXF → RGB
-- Implementar getDimensionColors para extrair cores do DIMSTYLE
-- Aplicar DIMCLRD (cor dimension lines) em todas as renderizações
-- Aplicar DIMCLRE (cor extension lines) em todas as renderizações
-- Aplicar DIMCLRT (cor texto) em todas as renderizações
-- Aplicar DIMLWD e DIMLWE (espessuras) em linhas
-- Adicionar propriedades dimBlk, dimBlk1, dimBlk2 no DimStyleTable
-- Atualizar plano de implementação com status completo
-- Atualizar documentação de entidades com implementação detalhada
-- Criar resumo completo da implementação
-```
-
-## Testes e Validação
-
-### Compilação
-
-* ✅ Build ESM: 21-24ms
-* ✅ Build CJS: 18-19ms
-* ✅ 0 erros TypeScript
-* ⚠️ 1 warning (import.meta em es2015 - não relacionado)
-
-### Arquivos Gerados
-
-* `lib/dimensionToSVG.js`: 14.6kb (ESM)
-* `lib/dimensionToSVG.cjs`: 16.4kb (CJS)
-* `lib/handlers/tables.js`: 15.3kb (ESM)
-* `lib/handlers/tables.cjs`: 16.8kb (CJS)
-
-### Cobertura de Funcionalidades
-
-* ✅ Parsing: 100% (68 propriedades DIMSTYLE)
-* ✅ Renderização básica: 100% (6 tipos de dimensão)
-* ✅ Renderização avançada: 100% (extension lines, setas, rotação)
-* ✅ Cores: 100% (DIMCLRD, DIMCLRE, DIMCLRT)
-* ⏸️ Custom arrows: 0% (opcional, baixa prioridade)
-* ⏸️ Tolerâncias: 0% (opcional, baixa prioridade)
-* ⏸️ XDATA overrides: 0% (opcional, edge case)
-
-## Próximos Passos (Opcionais)
-
-1. **Testes unitários**: Criar testes para cada tipo de dimensão
-2. **Testes de integração**: Validar com arquivos DXF reais
-3. **Custom arrow blocks**: Implementar se houver demanda
-4. **Tolerâncias**: Implementar se houver demanda
-5. **Performance**: Profiling e otimização se necessário
-
-## Conclusão
-
-A implementação de `DIMENSION` está completa para casos de uso comuns (estimativa: 95% dos arquivos DXF). As funcionalidades opcionais não implementadas são edge cases raros ou complexos demais para o benefício limitado que trariam.
-
-A arquitetura modular permite fácil extensão futura se necessário.

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

@@ -1,54 +0,0 @@
-# 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.pt-BR.md

@@ -1,169 +0,0 @@
-# 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.)