@linkiez/dxf-renew 5.3.1 → 7.1.0

package/{docs/CODE_PATTERNS.md → .github/instructions/code-patterns.instructions.md}

@@ -1,3 +1,6 @@
+---
+applyTo: '**'
+---
 # Code Patterns & Best Practices
 
 This document codifies the current implementation patterns used in DXF-Renewed, plus recommended best practices for new contributions.
@@ -19,7 +22,7 @@ This document codifies the current implementation patterns used in DXF-Renewed,
 Best practices:
 
 - Prefer `import type { ... }` for type-only imports.
-- Avoid `any` in new code. If runtime constraints require it, keep it local and document why.
+- Avoid `any` or `unknown` in new code. If runtime constraints require it, keep it local and document why.
 - Keep names and comments in **English (en_US)**.
 
 ## Project Architecture (High-Level)

package/.github/instructions/exdxf.instruction.md

@@ -0,0 +1,161 @@
+---
+applyTo: '**/*'
+---
+
+# Development Instructions (DXF-Renewed) — using ezdxf
+
+This repository is a TypeScript DXF parser. For DXF fixtures, debugging, and cross-checking group codes, we use the Python library **ezdxf**.
+
+Official docs:
+
+- Setup (extras): <https://ezdxf.readthedocs.io/en/stable/setup.html#installation-with-extras>
+- Reference index: <https://ezdxf.readthedocs.io/en/stable/reference.html>
+
+## 1) Install ezdxf (recommended: local venv)
+
+Many Linux distributions use an externally-managed Python environment (PEP 668), which blocks `pip install --user`.
+Use a local virtualenv inside this repo:
+
+```bash
+cd <path-to>/DXF-Renewed
+python3 -m venv .venv-ezdxf
+. .venv-ezdxf/bin/activate
+python -m pip install -U pip
+
+# Core library
+python -m pip install -U ezdxf
+
+# Optional drawing add-on dependencies (recommended by ezdxf docs)
+python -m pip install -U 'ezdxf[draw]'
+```
+
+Extras from the ezdxf docs:
+
+- `ezdxf[draw]`: Matplotlib, PySide6, PyMuPDF, Pillow
+- `ezdxf[dev]`: `draw` + setuptools, wheel, Cython, pytest
+- If PySide6 is not available, use `ezdxf[draw5]` / `ezdxf[dev5]` (PyQt5-based)
+
+Verify:
+
+```bash
+. .venv-ezdxf/bin/activate
+python -m ezdxf -V
+```
+
+## 2) How ezdxf helps this repo
+
+Use ezdxf for:
+
+- generating **minimal DXF fixtures** for TDD (`test/resources/*.dxf`)
+- dumping **raw group-code tags** for an entity/object/table
+- checking real-world DXF parsing expectations without guessing group codes
+
+This repo’s workflow is TDD-first:
+
+- add a minimal fixture + failing unit test
+- implement parser support
+- keep `yarn test` + `yarn lint` green
+
+## 3) Inspect an existing DXF fixture
+
+Print entity types, handles, and layers:
+
+```bash
+. .venv-ezdxf/bin/activate
+python - <<'PY'
+import ezdxf
+
+doc = ezdxf.readfile('test/resources/entities.dxf')
+msp = doc.modelspace()
+
+for e in msp:
+    handle = getattr(e.dxf, 'handle', None)
+    layer = getattr(e.dxf, 'layer', None)
+    print(e.dxftype(), handle, layer)
+PY
+```
+
+## 4) Dump raw group codes (tags) for a single entity
+
+This is the most useful thing for implementing a new handler in `src/handlers/entity/*`.
+
+```bash
+. .venv-ezdxf/bin/activate
+python - <<'PY'
+import ezdxf
+from ezdxf.lldxf.tagwriter import TagCollector
+
+doc = ezdxf.readfile('test/resources/leader-basic.dxf')
+entity = next(iter(doc.modelspace()))
+
+collector = TagCollector()
+entity.export_dxf(collector)
+
+for tag in collector.tags:
+    print(tag.code, tag.value)
+PY
+```
+
+Tip: If you want to dump all entities:
+
+```bash
+. .venv-ezdxf/bin/activate
+python - <<'PY'
+import ezdxf
+from ezdxf.lldxf.tagwriter import TagCollector
+
+doc = ezdxf.readfile('test/resources/entities.dxf')
+for i, entity in enumerate(doc.modelspace()):
+    print('---', i, entity.dxftype(), '---')
+    collector = TagCollector()
+    entity.export_dxf(collector)
+    for tag in collector.tags:
+        print(tag.code, tag.value)
+PY
+```
+
+## 5) Generate a new minimal fixture (recommended pattern)
+
+If ezdxf supports the entity via `layout.new_entity()`, you can create it directly.
+
+Example: create a minimal `TOLERANCE` entity and export:
+
+```bash
+. .venv-ezdxf/bin/activate
+python - <<'PY'
+import ezdxf
+
+doc = ezdxf.new('R2010')
+msp = doc.modelspace()
+
+# Create entity by DXF type name. dxfattribs depends on entity.
+# "insert" maps to group codes 10/20/30 for many entities.
+fcf = msp.new_entity('TOLERANCE', dxfattribs={
+    'layer': '0',
+    'insert': (10, 20, 0),
+})
+
+# You can set additional attributes if supported:
+# fcf.dxf.text = '%%v%%v'
+
+out = 'test/resources/tolerance-basic.dxf'
+doc.saveas(out)
+print('wrote', out)
+PY
+```
+
+If the high-level attribute you need is unclear, use the **tag dump** technique above to learn what ezdxf writes.
+
+## 6) Run DXF-Renewed checks
+
+```bash
+cd <path-to>/DXF-Renewed
+yarn test
+yarn lint
+```
+
+## 7) Reference sitemap
+
+Curated ezdxf reference links live here:
+
+- docs/EZDXF_REFERENCE_SITEMAP.md

package/.github/instructions/tdd.instructions.md

@@ -0,0 +1,271 @@
+---
+applyTo: '**/*'
+---
+
+# Test-Driven Development (TDD) Principles - AI Instructions
+
+## Core TDD Workflow
+
+1. **RED**: Write failing test first
+2. **GREEN**: Write minimal code to pass test
+3. **REFACTOR**: Improve code while maintaining test pass
+
+## Mandatory Rules
+
+### Test-First Discipline
+
+- NEVER write production code without failing test
+- Test describes expected behavior before implementation
+- Watch test fail before writing implementation
+- Verify test passes after implementation
+
+### Minimal Implementation
+
+- Write ONLY code needed to pass current test
+- Avoid premature optimization
+- Resist implementing features without tests
+- Each test drives one specific behavior
+
+### Test Quality Standards
+
+- Tests must be deterministic (same input = same output)
+- Tests should be independent (no execution order dependency)
+- Use descriptive test names explaining expected behavior
+- One assertion concept per test (arrange, act, assert)
+
+## Test Structure Pattern
+
+```typescript
+describe('UnitUnderTest', () => {
+  // Arrange: Setup test data and mocks
+  const input = validInput();
+  const expected = expectedOutput();
+
+  // Act: Execute function/method
+  const result = functionUnderTest(input);
+
+  // Assert: Verify result matches expectation
+  expect(result).toEqual(expected);
+});
+```
+
+## Code Coverage Requirements
+
+- Aim for 100% line coverage
+- 100% branch coverage (all if/else paths)
+- 100% function coverage
+- Use Istanbul/c8 for coverage reporting
+- Uncovered code indicates missing tests
+
+## Anti-Patterns to Avoid
+
+### Do NOT
+
+- Write implementation before test
+- Write multiple tests before implementation
+- Skip watching test fail
+- Test implementation details instead of behavior
+- Couple tests to internal structure
+- Use random/non-deterministic test data
+- Share state between tests
+
+### Do NOT Cheat
+
+- Hard-coding expected results to pass tests
+- Writing `if` statements matching test inputs
+- Returning specific values for test cases
+- Example of cheating:
+  ```typescript
+  // BAD: Hard-coded for specific test
+  function calculate(a: number, b: number): number {
+    if (a === 215 && b === 300) return 85;
+    if (a === 486 && b === 600) return 114;
+    return 0;
+  }
+  ```
+
+## Mocking Strategy
+
+### When to Mock
+
+- External dependencies (APIs, databases, file system)
+- Time-dependent operations (Date.now(), timers)
+- Random operations (Math.random())
+- Complex dependencies not under test
+- Async operations (Promises, Observables)
+
+### Mock Requirements
+
+- Mock external service calls
+- Mock database queries
+- Mock file I/O operations
+- Use spy functions to verify interactions
+- Return predictable, synchronous data when possible
+
+### Mock Example
+
+```typescript
+// Mock Observable service method
+jest.spyOn(service, 'get').mockReturnValue(
+  of({
+    id: 1,
+    data: 'test',
+    toJson: () => ({ id: 1, data: 'test' }),
+  }),
+);
+```
+
+## Handling Async Operations
+
+### Observable/Promise Patterns
+
+- Use `firstValueFrom()` in implementation
+- Mock Observables with `of()` or `throwError()`
+- Properly handle async/await in tests
+- Ensure all Observables complete in tests
+
+### Timeout Prevention
+
+- Mock all external async operations
+- Avoid real HTTP calls in unit tests
+- Mock timers with `jest.useFakeTimers()`
+- Set reasonable test timeouts
+
+## Test Organization
+
+### File Structure
+
+- `*.spec.ts` for unit tests (same directory as source)
+- `*.test.ts` for integration tests
+- `*.e2e.ts` for end-to-end tests
+- One test file per source file
+
+### Test Grouping
+
+```typescript
+describe('ServiceName', () => {
+  describe('methodName', () => {
+    it('should handle valid input', () => {});
+    it('should throw on invalid input', () => {});
+    it('should return empty for edge case', () => {});
+  });
+});
+```
+
+## Regression Prevention
+
+- All tests must pass before commit
+- New features require new tests
+- Bug fixes require reproduction test
+- Refactoring must not break existing tests
+- Use CI to enforce test pass
+
+## Documentation Through Tests
+
+- Tests serve as executable documentation
+- Test names explain functionality
+- Use JSDoc comments for complex logic
+- Include usage examples in test descriptions
+
+## Performance Considerations
+
+- Unit tests should run fast (< 1s per test)
+- Mock slow operations
+- Use test parallelization
+- Avoid real database/network in unit tests
+- Integration tests can be slower
+
+## Implementation Workflow
+
+1. Write test describing one behavior
+2. Run test → verify it fails
+3. Write minimum code to pass test
+4. Run test → verify it passes
+5. Refactor if needed
+6. Run all tests → verify no regression
+7. Repeat for next behavior
+
+## Red-Green-Refactor Cycle
+
+**RED Phase:**
+
+- Write test for non-existent functionality
+- Test must fail with meaningful error
+- Verify test failure reason is correct
+
+**GREEN Phase:**
+
+- Write simplest code to make test pass
+- Don't worry about code quality yet
+- Focus only on making test green
+
+**REFACTOR Phase:**
+
+- Improve code structure
+- Remove duplication
+- Optimize performance if needed
+- All tests must remain green
+
+## Practical Example: Vending Machine Change
+
+**Requirement:** Calculate coin change for vending machine
+
+**Test 1 - Empty Case:**
+
+```typescript
+test('getChange(1,1) returns empty array', () => {
+  expect(getChange(1, 1)).toEqual([]);
+});
+```
+
+**Implementation 1:**
+
+```typescript
+function getChange(payable: number, paid: number): number[] {
+  return [];
+}
+```
+
+**Test 2 - Basic Change:**
+
+```typescript
+test('getChange(215, 300) returns [50,20,10,5]', () => {
+  expect(getChange(215, 300)).toEqual([50, 20, 10, 5]);
+});
+```
+
+**Implementation 2:**
+
+```typescript
+function getChange(payable: number, paid: number): number[] {
+  const coins = [200, 100, 50, 20, 10, 5, 2, 1];
+  const change: number[] = [];
+  let remaining = paid - payable;
+
+  for (const coin of coins) {
+    while (remaining >= coin) {
+      change.push(coin);
+      remaining -= coin;
+    }
+  }
+
+  return change;
+}
+```
+
+## Summary Checklist
+
+Before writing any production code:
+
+- [ ] Write failing test
+- [ ] Verify test fails with expected reason
+- [ ] Write minimal implementation
+- [ ] Verify test passes
+- [ ] Verify no test regressions
+- [ ] Refactor if needed
+- [ ] All tests still pass
+
+## Reference Sources
+
+Based on: https://github.com/dwyl/learn-tdd
+Key principles: Red-Green-Refactor, Test-First, Minimal Implementation

package/.github/workflows/release.yml

@@ -73,6 +73,10 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: 22.x
+          registry-url: https://registry.npmjs.org
+
+      - name: Upgrade npm (Trusted Publishers)
+        run: npm i -g npm@^11.5.1
 
       - name: Enable Corepack
         run: corepack enable
@@ -95,11 +99,6 @@ jobs:
       - name: Build
         run: yarn build
 
-      - name: Create tarball for GitHub release
-        run: |
-          mkdir -p dist
-          yarn pack --out dist/%s-%v.tgz
-
       - name: Release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.releaserc.json

@@ -47,7 +47,7 @@
     [
       "@semantic-release/npm",
       {
-        "npmPublish": false,
+        "npmPublish": true,
         "tarballDir": "dist"
       }
     ],

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # Changelog
 
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## 7.1.0 (2026-01-01)
+
+* Merge pull request #1 from linkiez/feat/seqend-sequencing ([068c6e1](https://github.com/linkiez/DXF-Renewed/commit/068c6e1)), closes [#1](https://github.com/linkiez/DXF-Renewed/issues/1)
+* docs: add ezdxf reference sitemap and dev instructions ([859da63](https://github.com/linkiez/DXF-Renewed/commit/859da63))
+* docs: add SVG rendering integration testing docs ([5bb0dbb](https://github.com/linkiez/DXF-Renewed/commit/5bb0dbb))
+* docs: clarify type safety guidance ([dc01286](https://github.com/linkiez/DXF-Renewed/commit/dc01286))
+* docs: consolidate documentation and plan ([2f4f01e](https://github.com/linkiez/DXF-Renewed/commit/2f4f01e))
+* docs: switch to main-only workflow ([6098ad6](https://github.com/linkiez/DXF-Renewed/commit/6098ad6))
+* docs: update dimension docs and test guidance ([c171703](https://github.com/linkiez/DXF-Renewed/commit/c171703))
+* chore: ignore local ezdxf venv ([053e4c4](https://github.com/linkiez/DXF-Renewed/commit/053e4c4))
+* chore(fixtures): add ezdxf validation tooling ([c81c871](https://github.com/linkiez/DXF-Renewed/commit/c81c871))
+* chore(fixtures): regenerate DXF fixtures via ezdxf ([7c6876d](https://github.com/linkiez/DXF-Renewed/commit/7c6876d))
+* chore(tests): track rendered screenshots ([ebcd1f1](https://github.com/linkiez/DXF-Renewed/commit/ebcd1f1))
+* test(dimension): add fixtures for all dimension types ([6b5f9cf](https://github.com/linkiez/DXF-Renewed/commit/6b5f9cf))
+* test(integration): add node DIMENSION SVG rendering test ([820efc6](https://github.com/linkiez/DXF-Renewed/commit/820efc6))
+* test(integration): run SVG rendering tests in browser ([b0abe31](https://github.com/linkiez/DXF-Renewed/commit/b0abe31))
+* feat(dimension): add angular 3-point rendering ([a9ee537](https://github.com/linkiez/DXF-Renewed/commit/a9ee537))
+* feat(entities): add image, underlay, leader, and tolerance support ([7f17e47](https://github.com/linkiez/DXF-Renewed/commit/7f17e47))
+* feat(objects): add handle maps for common DXF objects ([7672211](https://github.com/linkiez/DXF-Renewed/commit/7672211))
+* style: normalize import ordering ([55d54c1](https://github.com/linkiez/DXF-Renewed/commit/55d54c1))
+* fix(denormalise): apply block basepoint to TEXT/MTEXT/DIMENSION ([1ee560e](https://github.com/linkiez/DXF-Renewed/commit/1ee560e))
+* fix(parser): harden POLYLINE sequencing ([7eb1fb7](https://github.com/linkiez/DXF-Renewed/commit/7eb1fb7))
+
+## 7.0.0 (2025-12-31)
+
+* fix: consolidar tipos ParsedDXF e corrigir incompatibilidades ([804c485](https://github.com/linkiez/DXF-Renewed/commit/804c485))
+* fix: tipar handlers e entidades no parseEntities ([a364044](https://github.com/linkiez/DXF-Renewed/commit/a364044))
+* fix(ci): enable corepack for yarn 4 support in github actions ([59048b9](https://github.com/linkiez/DXF-Renewed/commit/59048b9))
+* fix(ci): remove yarn cache from setup-node to enable corepack first ([ba3186c](https://github.com/linkiez/DXF-Renewed/commit/ba3186c))
+* fix(ci): skip eslint temporarily - babel parser incompatible with ts+esm ([37276c4](https://github.com/linkiez/DXF-Renewed/commit/37276c4))
+* fix(ci): use node 22.x for semantic-release v25 compatibility ([c20e69b](https://github.com/linkiez/DXF-Renewed/commit/c20e69b))
+* fix(release): simplify to use only main branch for releases ([705b77d](https://github.com/linkiez/DXF-Renewed/commit/705b77d))
+* fix(release): use https repository URL ([77e9a17](https://github.com/linkiez/DXF-Renewed/commit/77e9a17))
+* chore: sync package and release configuration ([e391038](https://github.com/linkiez/DXF-Renewed/commit/e391038))
+* chore: update yarn.lock ([6a7fb91](https://github.com/linkiez/DXF-Renewed/commit/6a7fb91))
+* docs: add warning about development status to README ([def8658](https://github.com/linkiez/DXF-Renewed/commit/def8658))
+* feat: adicionar tipos para entidades hatch, viewport e ole2frame ([e1c7b8f](https://github.com/linkiez/DXF-Renewed/commit/e1c7b8f))
+* feat: implement DIMENSION rendering with DIMSTYLE support (Phases 1 and 2) ([37b7e62](https://github.com/linkiez/DXF-Renewed/commit/37b7e62))
+* feat: implement Phase 3 - advanced DIMENSION rendering with arrows and extension lines ([02ff584](https://github.com/linkiez/DXF-Renewed/commit/02ff584))
+* feat: implement semantic-release and translate project to en_US ([e5b880d](https://github.com/linkiez/DXF-Renewed/commit/e5b880d))
+* feat(lint): add typescript eslint support and fix lint errors ([df13e74](https://github.com/linkiez/DXF-Renewed/commit/df13e74))
+* refactor: consolidar ColorRGB type em types/common ([4a0bd43](https://github.com/linkiez/DXF-Renewed/commit/4a0bd43))
+* refactor: consolidar types e interfaces em src/types/ ([604aa5c](https://github.com/linkiez/DXF-Renewed/commit/604aa5c))
+* refactor: eliminar interfaces duplicadas de arquivos principais ([3429635](https://github.com/linkiez/DXF-Renewed/commit/3429635))
+* refactor: remover extrusionZ duplicado de InsertEntity ([3a1fcfd](https://github.com/linkiez/DXF-Renewed/commit/3a1fcfd))
+* refactor: simplificar types com extends pattern ([ea08247](https://github.com/linkiez/DXF-Renewed/commit/ea08247))
+
+
+### BREAKING CHANGE
+
+* All commits must now follow Conventional Commits format in English
+
+# Changelog
+
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
 ### [5.3.1](https://github.com/skymakerolof/dxf/compare/v5.3.0...v5.3.1) (2025-09-01)

package/CONTRIBUTING.md

@@ -36,18 +36,20 @@ Antes de reportar um bug, verifique se já existe uma issue aberta sobre o probl
 ### Pull Requests
 
 1. Fork o repositório
-2. Crie uma branch a partir de `develop`:
+2. Crie uma branch a partir de `main`:
+
    ```bash
-   git checkout develop
+   git checkout main
    git checkout -b feature/sua-feature
    ```
+
 3. Faça suas mudanças seguindo o [Padrão de Commits](#padrão-de-commits)
 4. Execute os testes: `yarn test`
 5. Execute o linter: `yarn lint`
 6. Execute a build: `yarn build`
 7. Commit suas mudanças (o commitlint validará automaticamente)
 8. Push para sua branch
-9. Abra um Pull Request para `develop`
+9. Abra um Pull Request para `main`
 
 ## Padrão de Commits
 
@@ -55,7 +57,7 @@ Este projeto utiliza [Conventional Commits](https://www.conventionalcommits.org/
 
 ### Formato
 
-```
+```text
 <type>(<scope>): <subject>
 
 [optional body]
@@ -81,7 +83,7 @@ Este projeto utiliza [Conventional Commits](https://www.conventionalcommits.org/
 
 To indicate a breaking change (generates MAJOR release):
 
-```
+```text
 feat: allow provided config object to extend other configs
 
 BREAKING CHANGE: `extends` key in config file is now used
@@ -90,7 +92,7 @@ to extend other config files
 
 Or use `!` after the type:
 
-```
+```text
 feat!: remove support for Node 6
 ```
 
@@ -139,7 +141,7 @@ This will open an interactive prompt to create the commit in the correct format.
 O projeto usa [semantic-release](https://semantic-release.gitbook.io/) para releases automáticos:
 
 1. Faça commits seguindo o padrão Conventional Commits
-2. Faça merge do PR para `main`, `develop` ou `beta`
+2. Faça merge do PR para `main`
 3. O GitHub Actions automaticamente:
    * Analisa os commits desde o último release
    * Determina o novo número de versão (MAJOR.MINOR.PATCH)
@@ -151,8 +153,6 @@ O projeto usa [semantic-release](https://semantic-release.gitbook.io/) para rele
 ### Branches
 
 * **main**: Releases estáveis de produção
-* **develop**: Pre-releases (versões beta)
-* **beta**: Pre-releases específicas para testes
 
 ### Versionamento
 
@@ -220,7 +220,7 @@ yarn semantic-release   # Executar semantic-release
 
 ### Estrutura do Projeto
 
-```
+```text
 dxf/
 ├── src/                # Código-fonte TypeScript
 │   ├── handlers/       # Parsers de entidades e tabelas
@@ -238,15 +238,17 @@ dxf/
 ### Workflow de Desenvolvimento
 
 1. **Crie uma issue** descrevendo o que você vai fazer
-2. **Crie uma branch** a partir de `develop`:
+2. **Crie uma branch** a partir de `main`:
+
    ```bash
-   git checkout develop
-   git pull origin develop
+   git checkout main
+   git pull origin main
    git checkout -b feat/minha-feature
    ```
+
 3. **Faça suas mudanças** com commits seguindo o padrão
 4. **Execute os testes** localmente
-5. **Push e crie um PR** para `develop`
+5. **Push e crie um PR** para `main`
 6. **Aguarde a revisão** e responda aos comentários
 7. **Após merge**, o release será feito automaticamente