refactor(docs): code analysis engine

changes:
  - file: __init__.py
    area: core
    removed: [table, _get_table_chars]
  - file: ansi.py
    area: core
    added: [is_no_color, supports_color, strip_ansi]
  - file: highlighting.py
    area: core
    added: [HighlightRule, _make_highlighters, highlight_code]
  - file: logger.py
    area: core
    modified: [Logger, __init__]
  - file: renderer.py
    area: core
    modified: [render_to_string, codeblock, __init__, MarkdownRenderer]
    removed: [_supports_color, _highlight_code, _HL, _make_highlighters, _is_no_color, strip_ansi]
  - file: tables.py
    area: core
    added: [_calculate_column_widths, _render_table_rows, _render_markdown_table, _render_table_header, _get_table_chars, _render_table_border, +1 more]

dependencies:
  flow: "tables→renderer→ansi"
  - highlighting.py -> ansi.py
  - renderer.py -> ansi.py
  - renderer.py -> highlighting.py
  - tables.py -> renderer.py

stats:
  lines: "+934/-703 (net +231)"
  files: 29
  complexity: "+36% complexity (new features)"

Author: tom-sapletta-com

CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [0.1.10] - 2026-03-27
 
+### Fixed
+- Fix magic-numbers issues (ticket-50c6d50a)
+- Fix relative-imports issues (ticket-3450003e)
+- Fix relative-imports issues (ticket-8871b38a)
+- Fix llm-generated-code issues (ticket-235b03a9)
+
+## [0.1.10] - 2026-03-27
+
+### Fixed
+- Fix relative-imports issues (ticket-53a8b762)
+- Fix relative-imports issues (ticket-d9ee608d)
+
+## [0.1.10] - 2026-03-27
+
 ### Fixed
 - Fix smart-return-type issues (ticket-1aaadf0b)
 - Fix ai-boilerplate issues (ticket-8b31945f)
@@ -31,6 +45,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.4] - 2026-03-27
+
+### Docs
+- Update CHANGELOG.md
+- Update TODO.md
+- Update docs/README.md
+- Update project/README.md
+- Update project/context.md
+
+### Other
+- Update examples/basic.py
+- Update examples/logger_usage.py
+- Update examples/table_styles_demo.py
+- Update examples/tables_panels.py
+- Update planfile.yaml
+- Update project/analysis.toon.yaml
+- Update project/calls.mmd
+- Update project/calls.png
+- Update project/compact_flow.mmd
+- Update project/compact_flow.png
+- ... and 9 more files
+
 ## [0.1.3] - 2026-03-27
 
 ### Docs

README.md

@@ -241,10 +241,16 @@ pytest
 
 ## License
 
+Licensed under Apache-2.0.
+
+
 Apache License 2.0 - see [LICENSE](LICENSE) for details.
 
 ## Author
 
+Tom Sapletta
+
+
 Created by **Tom Sapletta** - [tom@sapletta.com](mailto:tom@sapletta.com)
 
 ## Related Projects

TODO.md

@@ -1,57 +1,29 @@
 # TODO
 
-**Generated by:** prefact v0.1.26
-**Generated on:** 2026-03-27T17:20:53.533233
-**Total issues:** 17 active, 24 completed
+**Generated by:** prefact v0.1.28
+**Generated on:** 2026-03-27T18:32:23.639484
+**Total issues:** 16 active, 0 completed
 
 ---
 
-## ✅ Completed Tasks
-
-- [x] examples/table_styles_demo.py:9 - Function 'demo' missing return type (suggested: -> None)
-- [x] examples/basic.py:9 - Function 'hello' missing return type (suggested: -> None)
-- [x] examples/basic.py:34 - Function 'status' missing return type (suggested: -> None)
-- [x] examples/basic.py:51 - Function 'demo' missing return type (suggested: -> None)
-- [x] examples/tables_panels.py:10 - Function 'deps' missing return type (suggested: -> None)
-- [x] examples/tables_panels.py:26 - Function 'info' missing return type (suggested: -> None)
-- [x] examples/logger_usage.py:11 - Function 'deploy' missing return type (suggested: -> None)
-- [x] src/typermd/__init__.py:339 - String concatenation can be converted to f-string
-- [x] src/typermd/__init__.py:261 - String concatenation can be converted to f-string
-- [x] src/typermd/__init__.py:265 - String concatenation can be converted to f-string
-- [x] src/typermd/__init__.py:20 - Unused import: 'annotations'
-- [x] src/typermd/__init__.py:120 - LLM-style docstring in echo
-- [x] src/typermd/__init__.py:234 - LLM-style docstring in table
-- [x] src/typermd/logger.py:56 - String concatenation can be converted to f-string
-- [x] src/typermd/logger.py:16 - Unused import: 'annotations'
-- [x] src/typermd/renderer.py:334 - String concatenation can be converted to f-string
-- [x] src/typermd/renderer.py:328 - String concatenation can be converted to f-string
-- [x] src/typermd/renderer.py:7 - Unused import: 'annotations'
-- [x] src/typermd/renderer.py:87 - Magic number: 20 - use named constant
-- [x] src/typermd/renderer.py:320 - Magic number: 80 - use named constant
-- [x] src/typermd/renderer.py:359 - Magic number: 42 - use named constant
-- [x] src/typermd/help.py:16 - Unused import: 'annotations'
-- [x] src/typermd/help.py:84 - LLM-style docstring in install_help_formatter
-- [x] src/typermd/themes.py:12 - Unused import: 'annotations'
-
 ## 📋 Current Issues
 
-- [ ] examples/tables_panels.py:34 - module execution block
-- [ ] examples/table_styles_demo.py:26 - module execution block
-- [ ] examples/logger_usage.py:31 - module execution block
 - [ ] examples/basic.py:95 - module execution block
-- [ ] src/typermd/__init__.py:338 - String concatenation can be converted to f-string
-- [ ] src/typermd/__init__.py:281 - String concatenation can be converted to f-string
-- [ ] src/typermd/__init__.py:300 - String concatenation can be converted to f-string
-- [ ] src/typermd/__init__.py:119 - LLM-style docstring in echo
-- [ ] src/typermd/__init__.py:233 - LLM-style docstring in table
-- [ ] src/typermd/__init__.py:16 - module execution block
-- [ ] src/typermd/renderer.py:346 - String concatenation can be converted to f-string
-- [ ] src/typermd/renderer.py:171 - String concatenation can be converted to f-string
-- [ ] src/typermd/renderer.py:229 - String concatenation can be converted to f-string
-- [ ] src/typermd/renderer.py:18 - Magic number: 20 - use named constant
-- [ ] src/typermd/renderer.py:19 - Magic number: 80 - use named constant
-- [ ] src/typermd/renderer.py:20 - Magic number: 42 - use named constant
+- [ ] examples/logger_usage.py:31 - module execution block
+- [ ] examples/table_styles_demo.py:26 - module execution block
+- [ ] examples/tables_panels.py:34 - module execution block
+- [ ] src/typermd/__init__.py:158 - Relative import (level=1): '.tables'
+- [ ] src/typermd/ansi.py:15 - Magic number: 20 - use named constant
+- [ ] src/typermd/ansi.py:16 - Magic number: 80 - use named constant
+- [ ] src/typermd/ansi.py:17 - Magic number: 42 - use named constant
+- [ ] src/typermd/highlighting.py:10 - Relative import (level=1): '.ansi'
+- [ ] src/typermd/highlighting.py:184 - LLM-style docstring in highlight_code
+- [ ] src/typermd/renderer.py:13 - Relative import (level=1): '.ansi'
+- [ ] src/typermd/renderer.py:36 - Relative import (level=1): '.highlighting'
 - [ ] src/typermd/help.py:83 - LLM-style docstring in install_help_formatter
+- [ ] src/typermd/tables.py:10 - Relative import (level=1): '.renderer'
+- [ ] src/typermd/tables.py:89 - Relative import (level=1): '.renderer'
+- [ ] src/typermd/tables.py:198 - Relative import (level=1): '.renderer'
 
 ---
 

VERSION

@@ -1 +1 @@
-0.1.3
+0.1.4

docs/README.md

@@ -1,7 +1,7 @@
 <!-- code2docs:start --># typermd
 
-![version](https://img.shields.io/badge/version-0.1.0-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.10-blue) ![coverage](https://img.shields.io/badge/coverage-unknown-lightgrey) ![functions](https://img.shields.io/badge/functions-61-green)
-> **61** functions | **5** classes | **10** files | CC̄ = 2.8
+![version](https://img.shields.io/badge/version-0.1.0-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.10-blue) ![coverage](https://img.shields.io/badge/coverage-unknown-lightgrey) ![functions](https://img.shields.io/badge/functions-66-green)
+> **66** functions | **5** classes | **13** files | CC̄ = 2.7
 
 > Auto-generated project documentation from source code analysis.
 
@@ -146,30 +146,39 @@ Content outside the markers is preserved when regenerating. Enable this with `sy
 
 ```
 typermd/
-    ├── tables_panels    ├── table_styles_demo    ├── typermd/    ├── basic    ├── logger_usage        ├── logger├── project        ├── themes        ├── renderer        ├── help```
+    ├── logger_usage    ├── basic        ├── ansi    ├── typermd/    ├── table_styles_demo        ├── tables        ├── renderer    ├── tables_panels        ├── logger├── project        ├── themes        ├── highlighting        ├── help```
 
 ## API Overview
 
 ### Classes
 
+- **`MarkdownRenderer`** — Renders markdown text to the terminal with ANSI colors.
 - **`Logger`** — Markdown-aware structured logger.
 - **`Theme`** — Color theme definition with named color slots.
-- **`MarkdownRenderer`** — Renders markdown text to the terminal with ANSI colors.
+- **`HighlightRule`** — Highlighter rule: pattern + color.
 - **`MarkdownHelpFormatter`** — Click HelpFormatter that renders markdown in help text.
 
 ### Functions
 
-- `deps()` — Show project dependencies as a table.
-- `info()` — Show app info in a panel.
-- `demo()` — Demonstrate all table styles.
-- `echo(message, file, nl, err)` — Enhanced echo that auto-detects and renders markdown.
-- `table(headers, rows, style)` — Render a table to the terminal.
-- `panel(content, title, style_color)` — Render a bordered panel.
-- `blockquote(content)` — Render a blockquote.
+- `deploy(env, dry_run)` — Simulate a deployment with structured logging.
 - `hello(name, formal)` — Say hello with markdown formatting.
 - `status()` — Show system status with styled output.
 - `demo()` — Demonstrate all markdown features.
-- `deploy(env, dry_run)` — Simulate a deployment with structured logging.
+- `strip_ansi(text)` — Remove all ANSI escape codes from text.
+- `is_no_color()` — Check if NO_COLOR env is set (https://no-color.org).
+- `supports_color(stream)` — Detect if the output stream supports color.
+- `echo(message, file, nl, err)` — Enhanced echo that auto-detects and renders markdown.
+- `panel(content, title, style_color)` — Render a bordered panel.
+- `blockquote(content)` — Render a blockquote.
+- `demo()` — Demonstrate all table styles.
+- `table(headers, rows, style)` — Render a table to the terminal.
+- `looks_like_markdown(text)` — Heuristic: does the text contain markdown formatting?
+- `get_renderer(stream, use_colors)` — Get or create the default MarkdownRenderer.
+- `render_markdown(text, stream, use_colors)` — Render markdown text to a stream.
+- `md(text)` — Render markdown text to stdout. Primary convenience function.
+- `render_to_string(text)` — Render markdown and return as string.
+- `deps()` — Show project dependencies as a table.
+- `info()` — Show app info in a panel.
 - `get_logger(name, verbose)` — Get or create the default logger.
 - `set_logger(logger)` — Replace the default logger.
 - `get_theme()` — Get the current active theme.
@@ -178,12 +187,7 @@ typermd/
 - `list_themes()` — Return list of available theme names.
 - `is_no_color()` — Check if NO_COLOR env is set.
 - `init_theme_from_env()` — Initialize theme from TYPERMD_THEME env variable.
-- `strip_ansi(text)` — Remove all ANSI escape codes from text.
-- `looks_like_markdown(text)` — Heuristic: does the text contain markdown formatting?
-- `get_renderer(stream, use_colors)` — Get or create the default MarkdownRenderer.
-- `render_markdown(text, stream, use_colors)` — Render markdown text to a stream.
-- `md(text)` — Render markdown text to stdout. Primary convenience function.
-- `render_to_string(text)` — Render markdown and return as string.
+- `highlight_code(code, lang)` — Apply syntax highlighting to a code block.
 - `install_help_formatter(app)` — Install the markdown help formatter on a Typer app.
 
 
@@ -194,10 +198,13 @@ typermd/
 📄 `examples.table_styles_demo` (1 functions)
 📄 `examples.tables_panels` (2 functions)
 📄 `project`
-📦 `src.typermd` (5 functions)
+📦 `src.typermd` (3 functions)
+📄 `src.typermd.ansi` (3 functions)
 📄 `src.typermd.help` (6 functions, 1 classes)
+📄 `src.typermd.highlighting` (2 functions, 1 classes)
 📄 `src.typermd.logger` (12 functions, 1 classes)
-📄 `src.typermd.renderer` (24 functions, 2 classes)
+📄 `src.typermd.renderer` (19 functions, 1 classes)
+📄 `src.typermd.tables` (7 functions)
 📄 `src.typermd.themes` (7 functions, 1 classes)
 
 ## Requirements
@@ -208,8 +215,8 @@ typermd/
 ## Contributing
 
 **Contributors:**
-- Tom Sapletta <tom-sapletta-com@users.noreply.github.com>
 - Tom Softreck <tom@sapletta.com>
+- Tom Sapletta <tom-sapletta-com@users.noreply.github.com>
 
 We welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
 

examples/basic.py

@@ -93,4 +93,4 @@ def demo() -> None:
 
 
 if __name__ == "__main__":
-    typer.Typer()
+    app()

examples/logger_usage.py

@@ -29,4 +29,4 @@ def deploy(
 
 
 if __name__ == "__main__":
-    typer.Typer()
+    deploy()

examples/table_styles_demo.py

@@ -24,4 +24,4 @@ def demo() -> None:
         typer.table(headers, rows, style=style)
 
 if __name__ == "__main__":
-    typer.Typer()
+    app()

examples/tables_panels.py

@@ -32,4 +32,4 @@ def info() -> None:
 
 
 if __name__ == "__main__":
-    typer.Typer()
+    app()

planfile.yaml

@@ -277,3 +277,81 @@ sprints:
     model_hints:
       planning: balanced
       implementation: balanced
+  - id: ticket-53a8b762
+    name: Fix relative-imports issues
+    description: Resolve 1 relative-imports issues in src/typermd/__init__.py
+    task_type: prefactor
+    priority: medium
+    estimate: 1d
+    files:
+    - src/typermd/__init__.py
+    rule_id: relative-imports
+    count: 1
+    model_hints:
+      planning: balanced
+      implementation: balanced
+  - id: ticket-d9ee608d
+    name: Fix relative-imports issues
+    description: Resolve 3 relative-imports issues in src/typermd/tables.py
+    task_type: prefactor
+    priority: medium
+    estimate: 1d
+    files:
+    - src/typermd/tables.py
+    rule_id: relative-imports
+    count: 3
+    model_hints:
+      planning: balanced
+      implementation: balanced
+  - id: ticket-50c6d50a
+    name: Fix magic-numbers issues
+    description: Resolve 3 magic-numbers issues in src/typermd/ansi.py
+    task_type: prefactor
+    priority: medium
+    estimate: 1d
+    files:
+    - src/typermd/ansi.py
+    rule_id: magic-numbers
+    count: 3
+    model_hints:
+      planning: balanced
+      implementation: balanced
+  - id: ticket-3450003e
+    name: Fix relative-imports issues
+    description: Resolve 2 relative-imports issues in src/typermd/renderer.py
+    task_type: prefactor
+    priority: medium
+    estimate: 1d
+    files:
+    - src/typermd/renderer.py
+    rule_id: relative-imports
+    count: 2
+    model_hints:
+      planning: balanced
+      implementation: balanced
+  - id: ticket-8871b38a
+    name: Fix relative-imports issues
+    description: Resolve 2 relative-imports issues in src/typermd/highlighting.py
+    task_type: prefactor
+    priority: medium
+    estimate: 1d
+    files:
+    - src/typermd/highlighting.py
+    rule_id: relative-imports
+    count: 2
+    model_hints:
+      planning: balanced
+      implementation: balanced
+  - id: ticket-235b03a9
+    name: Fix llm-generated-code issues
+    description: Resolve 1 llm-generated-code issues in src/typermd/highlighting.py
+    task_type: prefactor
+    priority: medium
+    estimate: 1d
+    files:
+    - src/typermd/highlighting.py
+    rule_id: llm-generated-code
+    count: 1
+    model_hints:
+      planning: balanced
+      implementation: balanced