hekatan 0.1.0__tar.gz

hekatan-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Giorgio Burbanelli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hekatan-0.1.0/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: hekatan
+Version: 0.1.0
+Summary: Python display library for engineering calculations - matrices, equations, formatted output
+Author-email: Giorgio Burbanelli <giorgioburbanelli89@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/GiorgioBurbanelli89/pyhekatan
+Project-URL: Repository, https://github.com/GiorgioBurbanelli89/pyhekatan
+Project-URL: Issues, https://github.com/GiorgioBurbanelli89/pyhekatan/issues
+Keywords: engineering,calculations,matrix,equations,display,hekatan
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# hekatan
+
+> Python display library for engineering calculations — matrices, equations, formatted output
+
+[![PyPI](https://img.shields.io/pypi/v/hekatan.svg)](https://pypi.org/project/hekatan/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+## Install
+
+```bash
+pip install hekatan
+```
+
+## Quick Start
+
+```python
+from hekatan import matrix, eq, var, fraction, title, text, show
+
+title("Beam Design")
+text("Rectangular section properties:")
+
+var("b", 300, "mm", "beam width")
+var("h", 500, "mm", "beam height")
+
+eq("A", 300 * 500, "mm²")
+
+title("Stiffness Matrix", level=2)
+K = [[12, 6, -12, 6],
+     [6, 4, -6, 2],
+     [-12, -6, 12, -6],
+     [6, 2, -6, 4]]
+matrix(K, "K")
+
+title("Design Ratio", level=2)
+fraction("M_u", "φ · b · d²", "R_n")
+
+show()  # Opens formatted HTML in your browser
+```
+
+## How It Works
+
+Each function (`matrix()`, `eq()`, `var()`, etc.) works in **3 modes**:
+
+| Mode | When | Behavior |
+|------|------|----------|
+| **Hekatan** | Inside Hekatan Calc (WPF/CLI) | Emits `@@HEKATAN` markers → rendered as formatted HTML |
+| **Standalone** | Regular Python script | `show()` generates HTML, opens in browser |
+| **Console** | Fallback | ASCII formatted output |
+
+Mode is auto-detected via `HEKATAN_RENDER=1` environment variable.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `matrix(data, name)` | Display formatted matrix | `matrix([[1,2],[3,4]], "A")` |
+| `eq(name, value, unit)` | Equation: name = value unit | `eq("F", 25.5, "kN")` |
+| `var(name, value, unit, desc)` | Variable with description | `var("b", 300, "mm", "width")` |
+| `fraction(num, den, name)` | Formatted fraction | `fraction("M", "S", "σ")` |
+| `title(text, level)` | Heading (h1-h6) | `title("Results", 2)` |
+| `text(content)` | Paragraph text | `text("Design is OK.")` |
+| `show(filename)` | Generate HTML + open browser | `show()` or `show("out.html")` |
+| `clear()` | Clear accumulated buffer | `clear()` |
+| `set_mode(mode)` | Force mode | `set_mode("console")` |
+
+## Integration with Hekatan Calc
+
+When used inside a Hekatan Calc `.hcalc` document:
+
+```
+# My Calculation
+
+@{python}
+from hekatan import matrix, eq
+
+K = [[12, 6], [6, 4]]
+matrix(K, "K")
+eq("det_K", 12*4 - 6*6)
+@{end python}
+```
+
+The output is automatically formatted with Hekatan's CSS (matrices with brackets, equations with proper typography).
+
+## License
+
+MIT — Giorgio Burbanelli

hekatan-0.1.0/README.md

@@ -0,0 +1,86 @@
+# hekatan
+
+> Python display library for engineering calculations — matrices, equations, formatted output
+
+[![PyPI](https://img.shields.io/pypi/v/hekatan.svg)](https://pypi.org/project/hekatan/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+## Install
+
+```bash
+pip install hekatan
+```
+
+## Quick Start
+
+```python
+from hekatan import matrix, eq, var, fraction, title, text, show
+
+title("Beam Design")
+text("Rectangular section properties:")
+
+var("b", 300, "mm", "beam width")
+var("h", 500, "mm", "beam height")
+
+eq("A", 300 * 500, "mm²")
+
+title("Stiffness Matrix", level=2)
+K = [[12, 6, -12, 6],
+     [6, 4, -6, 2],
+     [-12, -6, 12, -6],
+     [6, 2, -6, 4]]
+matrix(K, "K")
+
+title("Design Ratio", level=2)
+fraction("M_u", "φ · b · d²", "R_n")
+
+show()  # Opens formatted HTML in your browser
+```
+
+## How It Works
+
+Each function (`matrix()`, `eq()`, `var()`, etc.) works in **3 modes**:
+
+| Mode | When | Behavior |
+|------|------|----------|
+| **Hekatan** | Inside Hekatan Calc (WPF/CLI) | Emits `@@HEKATAN` markers → rendered as formatted HTML |
+| **Standalone** | Regular Python script | `show()` generates HTML, opens in browser |
+| **Console** | Fallback | ASCII formatted output |
+
+Mode is auto-detected via `HEKATAN_RENDER=1` environment variable.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `matrix(data, name)` | Display formatted matrix | `matrix([[1,2],[3,4]], "A")` |
+| `eq(name, value, unit)` | Equation: name = value unit | `eq("F", 25.5, "kN")` |
+| `var(name, value, unit, desc)` | Variable with description | `var("b", 300, "mm", "width")` |
+| `fraction(num, den, name)` | Formatted fraction | `fraction("M", "S", "σ")` |
+| `title(text, level)` | Heading (h1-h6) | `title("Results", 2)` |
+| `text(content)` | Paragraph text | `text("Design is OK.")` |
+| `show(filename)` | Generate HTML + open browser | `show()` or `show("out.html")` |
+| `clear()` | Clear accumulated buffer | `clear()` |
+| `set_mode(mode)` | Force mode | `set_mode("console")` |
+
+## Integration with Hekatan Calc
+
+When used inside a Hekatan Calc `.hcalc` document:
+
+```
+# My Calculation
+
+@{python}
+from hekatan import matrix, eq
+
+K = [[12, 6], [6, 4]]
+matrix(K, "K")
+eq("det_K", 12*4 - 6*6)
+@{end python}
+```
+
+The output is automatically formatted with Hekatan's CSS (matrices with brackets, equations with proper typography).
+
+## License
+
+MIT — Giorgio Burbanelli

hekatan-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "hekatan"
+version = "0.1.0"
+description = "Python display library for engineering calculations - matrices, equations, formatted output"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+authors = [
+    {name = "Giorgio Burbanelli", email = "giorgioburbanelli89@gmail.com"}
+]
+keywords = ["engineering", "calculations", "matrix", "equations", "display", "hekatan"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Education",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Scientific/Engineering :: Mathematics",
+]
+
+[project.urls]
+Homepage = "https://github.com/GiorgioBurbanelli89/pyhekatan"
+Repository = "https://github.com/GiorgioBurbanelli89/pyhekatan"
+Issues = "https://github.com/GiorgioBurbanelli89/pyhekatan/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]

hekatan-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

hekatan-0.1.0/src/hekatan/__init__.py

@@ -0,0 +1,32 @@
+"""
+Hekatan - Python display library for engineering calculations.
+
+Works in 3 modes:
+  1. Inside Hekatan Calc (WPF/CLI) - emits markers for formatted HTML rendering
+  2. Standalone Python - show() generates HTML and opens in browser
+  3. Console fallback - ASCII formatted output
+
+Usage:
+    from hekatan import matrix, eq, var, fraction, title, text, show
+
+    A = [[1, 2], [3, 4]]
+    matrix(A, "A")
+    eq("F", 25.5, "kN")
+    var("b", 300, "mm")
+    show()  # Opens HTML in browser (standalone mode)
+"""
+
+__version__ = "0.1.0"
+
+from hekatan.display import (
+    matrix,
+    eq,
+    var,
+    fraction,
+    title,
+    text,
+    heading,
+    show,
+    clear,
+    set_mode,
+)

hekatan-0.1.0/src/hekatan/display.py

@@ -0,0 +1,473 @@
+"""
+Core display functions for Hekatan.
+
+Each function works in 3 modes:
+  - HEKATAN mode: prints @@HEKATAN markers (detected by C# side)
+  - STANDALONE mode: accumulates HTML, show() opens in browser
+  - CONSOLE mode: ASCII formatted output
+"""
+
+import os
+import sys
+import tempfile
+import webbrowser
+from typing import Any, List, Optional, Union
+
+# ============================================================
+# Mode detection
+# ============================================================
+
+_MODE = None  # 'hekatan', 'standalone', 'console'
+_BUFFER = []  # Accumulated elements for standalone mode
+
+
+def _detect_mode() -> str:
+    """Auto-detect rendering mode."""
+    if os.environ.get("HEKATAN_RENDER") == "1":
+        return "hekatan"
+    return "standalone"
+
+
+def _get_mode() -> str:
+    global _MODE
+    if _MODE is None:
+        _MODE = _detect_mode()
+    return _MODE
+
+
+def set_mode(mode: str):
+    """Force a specific mode: 'hekatan', 'standalone', or 'console'."""
+    global _MODE
+    if mode not in ("hekatan", "standalone", "console"):
+        raise ValueError(f"Invalid mode: {mode}. Use 'hekatan', 'standalone', or 'console'.")
+    _MODE = mode
+
+
+def clear():
+    """Clear the accumulated buffer."""
+    _BUFFER.clear()
+
+
+# ============================================================
+# Matrix display
+# ============================================================
+
+def matrix(data: List[List[Any]], name: Optional[str] = None):
+    """
+    Display a matrix with formatted brackets.
+
+    Args:
+        data: 2D list [[row1], [row2], ...]
+        name: Optional name (e.g. "A", "K")
+
+    Example:
+        matrix([[1, 2], [3, 4]], "A")
+    """
+    mode = _get_mode()
+
+    if mode == "hekatan":
+        rows = ";".join(",".join(str(x) for x in row) for row in data)
+        marker = f"@@HEKATAN:MATRIX:{name or ''}[{rows}]"
+        print(marker)
+
+    elif mode == "standalone":
+        html = _matrix_to_html(data, name)
+        _BUFFER.append(html)
+
+    else:  # console
+        _matrix_to_console(data, name)
+
+
+def _matrix_to_html(data: List[List[Any]], name: Optional[str] = None) -> str:
+    """Generate HTML for a matrix using Hekatan CSS classes."""
+    rows_html = []
+    for row in data:
+        cells = "".join(f'<td class="td">{x}</td>' for x in row)
+        # Empty first/last cells create bracket effect
+        rows_html.append(f'<tr class="tr"><td class="td"></td>{cells}<td class="td"></td></tr>')
+
+    table = f'<table class="matrix">{"".join(rows_html)}</table>'
+
+    if name:
+        return f'<div class="eq"><var>{name}</var> = {table}</div>'
+    return f'<div class="eq">{table}</div>'
+
+
+def _matrix_to_console(data: List[List[Any]], name: Optional[str] = None):
+    """Print matrix in ASCII format."""
+    if not data:
+        print("[]")
+        return
+
+    # Calculate column widths
+    col_widths = []
+    for j in range(len(data[0])):
+        w = max(len(str(data[i][j])) for i in range(len(data)))
+        col_widths.append(w)
+
+    prefix = f"{name} = " if name else ""
+    pad = " " * len(prefix)
+
+    for i, row in enumerate(data):
+        cells = "  ".join(str(row[j]).rjust(col_widths[j]) for j in range(len(row)))
+        line_prefix = prefix if i == len(data) // 2 else pad
+        print(f"{line_prefix}| {cells} |")
+
+
+# ============================================================
+# Equation display
+# ============================================================
+
+def eq(name: str, value: Any, unit: str = ""):
+    """
+    Display a formatted equation: name = value [unit]
+
+    Args:
+        name: Variable name (e.g. "F", "M_u")
+        value: Numeric value
+        unit: Optional unit string (e.g. "kN", "mm")
+
+    Example:
+        eq("F", 25.5, "kN")
+        eq("A_s", 1256.64, "mm²")
+    """
+    mode = _get_mode()
+
+    if mode == "hekatan":
+        marker = f"@@HEKATAN:EQ:{name}={value}"
+        if unit:
+            marker += f"|{unit}"
+        print(marker)
+
+    elif mode == "standalone":
+        unit_html = f' <span class="unit">{unit}</span>' if unit else ""
+        # Handle subscripts: A_s -> A<sub>s</sub>
+        display_name = _format_subscript(name)
+        html = f'<div class="eq"><var>{display_name}</var> = <b>{value}</b>{unit_html}</div>'
+        _BUFFER.append(html)
+
+    else:  # console
+        unit_str = f" {unit}" if unit else ""
+        print(f"{name} = {value}{unit_str}")
+
+
+# ============================================================
+# Variable display (with description)
+# ============================================================
+
+def var(name: str, value: Any, unit: str = "", desc: str = ""):
+    """
+    Display a variable with optional description.
+
+    Args:
+        name: Variable name
+        value: Value
+        unit: Optional unit
+        desc: Optional description
+
+    Example:
+        var("b", 300, "mm", "ancho de la viga")
+    """
+    mode = _get_mode()
+
+    if mode == "hekatan":
+        parts = [f"@@HEKATAN:VAR:{name}={value}"]
+        if unit:
+            parts[0] += f"|{unit}"
+        if desc:
+            parts[0] += f"|{desc}"
+        print(parts[0])
+
+    elif mode == "standalone":
+        display_name = _format_subscript(name)
+        unit_html = f' <span class="unit">{unit}</span>' if unit else ""
+        desc_html = f' <span class="desc">— {desc}</span>' if desc else ""
+        html = f'<div class="eq"><var>{display_name}</var> = <b>{value}</b>{unit_html}{desc_html}</div>'
+        _BUFFER.append(html)
+
+    else:  # console
+        unit_str = f" {unit}" if unit else ""
+        desc_str = f"  - {desc}" if desc else ""
+        print(f"{name} = {value}{unit_str}{desc_str}")
+
+
+# ============================================================
+# Fraction display
+# ============================================================
+
+def fraction(numerator: Any, denominator: Any, name: Optional[str] = None):
+    """
+    Display a fraction.
+
+    Args:
+        numerator: Top value
+        denominator: Bottom value
+        name: Optional name for the result
+
+    Example:
+        fraction("M_u", "phi * b * d²", "R_n")
+    """
+    mode = _get_mode()
+
+    if mode == "hekatan":
+        marker = f"@@HEKATAN:FRAC:{name or ''}={numerator}/{denominator}"
+        print(marker)
+
+    elif mode == "standalone":
+        name_html = f'<var>{_format_subscript(name)}</var> = ' if name else ""
+        html = (
+            f'<div class="eq">{name_html}'
+            f'<span class="dvc">'
+            f'<span class="dvl">{numerator}</span>'
+            f'<span class="dvl">{denominator}</span>'
+            f'</span></div>'
+        )
+        _BUFFER.append(html)
+
+    else:  # console
+        prefix = f"{name} = " if name else ""
+        num_str = str(numerator)
+        den_str = str(denominator)
+        width = max(len(num_str), len(den_str))
+        print(f"{prefix}{num_str.center(width)}")
+        print(f"{' ' * len(prefix)}{'-' * width}")
+        print(f"{' ' * len(prefix)}{den_str.center(width)}")
+
+
+# ============================================================
+# Text elements
+# ============================================================
+
+def title(text_content: str, level: int = 1):
+    """Display a heading."""
+    mode = _get_mode()
+    tag = f"h{min(level, 6)}"
+
+    if mode == "hekatan":
+        print(f"@@HEKATAN:TITLE:{level}|{text_content}")
+
+    elif mode == "standalone":
+        _BUFFER.append(f"<{tag}>{text_content}</{tag}>")
+
+    else:
+        marker = "#" * level
+        print(f"\n{marker} {text_content}\n")
+
+
+def heading(text_content: str, level: int = 2):
+    """Alias for title()."""
+    title(text_content, level)
+
+
+def text(content: str):
+    """Display plain text or markdown."""
+    mode = _get_mode()
+
+    if mode == "hekatan":
+        print(f"@@HEKATAN:TEXT:{content}")
+
+    elif mode == "standalone":
+        _BUFFER.append(f"<p>{content}</p>")
+
+    else:
+        print(content)
+
+
+# ============================================================
+# Show (standalone mode - generates HTML)
+# ============================================================
+
+def show(filename: Optional[str] = None):
+    """
+    Generate HTML document and open in browser.
+    Only works in standalone mode.
+
+    Args:
+        filename: Optional output file path. If None, uses temp file.
+    """
+    if not _BUFFER:
+        print("hekatan: nothing to show")
+        return
+
+    html = _generate_html()
+
+    if filename:
+        path = filename
+    else:
+        fd, path = tempfile.mkstemp(suffix=".html", prefix="hekatan_")
+        os.close(fd)
+
+    with open(path, "w", encoding="utf-8") as f:
+        f.write(html)
+
+    webbrowser.open(f"file://{os.path.abspath(path)}")
+    print(f"hekatan: opened {path}")
+
+
+def _generate_html() -> str:
+    """Generate complete HTML document with Hekatan CSS."""
+    body = "\n".join(_BUFFER)
+    return f"""<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Hekatan Output</title>
+<style>
+{_CSS}
+</style>
+</head>
+<body>
+<div class="hekatan-doc">
+{body}
+</div>
+</body>
+</html>"""
+
+
+# ============================================================
+# Helpers
+# ============================================================
+
+def _format_subscript(name: str) -> str:
+    """Convert A_s to A<sub>s</sub>."""
+    if "_" in name:
+        parts = name.split("_", 1)
+        return f"{parts[0]}<sub>{parts[1]}</sub>"
+    return name
+
+
+# ============================================================
+# Embedded CSS (matches Hekatan Calc rendering)
+# ============================================================
+
+_CSS = """
+/* Hekatan Display CSS */
+* { margin: 0; padding: 0; box-sizing: border-box; }
+
+body {
+    font-family: 'Segoe UI', 'Helvetica Neue', Arial, sans-serif;
+    font-size: 11pt;
+    line-height: 1.6;
+    color: #333;
+    background: #fff;
+    padding: 24px 32px;
+    max-width: 900px;
+    margin: 0 auto;
+}
+
+.hekatan-doc { padding: 16px 0; }
+
+h1 { font-size: 1.8em; margin: 16px 0 8px; color: #1a1a1a; border-bottom: 2px solid #e0c060; padding-bottom: 4px; }
+h2 { font-size: 1.4em; margin: 14px 0 6px; color: #2a2a2a; }
+h3 { font-size: 1.15em; margin: 12px 0 4px; color: #333; }
+
+p { margin: 6px 0; }
+
+/* Equation line */
+.eq {
+    font-family: 'Cambria Math', 'Latin Modern Math', 'STIX Two Math', serif;
+    font-size: 11pt;
+    line-height: 2;
+    margin: 2px 0;
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    flex-wrap: wrap;
+}
+
+.eq var {
+    font-style: italic;
+    color: #333;
+}
+
+.eq b {
+    font-weight: 600;
+    color: #1a1a1a;
+}
+
+.unit {
+    font-size: 0.9em;
+    color: #666;
+}
+
+.desc {
+    font-size: 0.9em;
+    color: #888;
+    font-style: italic;
+}
+
+/* Matrix */
+.matrix {
+    display: inline-table;
+    border-collapse: collapse;
+    margin: 4px 2px;
+    vertical-align: middle;
+}
+
+.matrix .tr {
+    display: table-row;
+}
+
+.matrix .td {
+    display: table-cell;
+    text-align: center;
+    padding: 2px 8px;
+    font-size: 10.5pt;
+}
+
+/* Bracket effect: first and last cells have borders */
+.matrix .tr .td:first-child {
+    border-left: 2px solid #333;
+    border-top: 2px solid #333;
+    border-bottom: 2px solid #333;
+    padding: 2px 4px;
+    width: 4px;
+}
+
+.matrix .tr:first-child .td:first-child { border-bottom: none; }
+.matrix .tr:last-child .td:first-child { border-top: none; }
+.matrix .tr:not(:first-child):not(:last-child) .td:first-child { border-top: none; border-bottom: none; }
+
+.matrix .tr .td:last-child {
+    border-right: 2px solid #333;
+    border-top: 2px solid #333;
+    border-bottom: 2px solid #333;
+    padding: 2px 4px;
+    width: 4px;
+}
+
+.matrix .tr:first-child .td:last-child { border-bottom: none; }
+.matrix .tr:last-child .td:last-child { border-top: none; }
+.matrix .tr:not(:first-child):not(:last-child) .td:last-child { border-top: none; border-bottom: none; }
+
+/* Fraction */
+.dvc {
+    display: inline-flex;
+    flex-direction: column;
+    align-items: center;
+    vertical-align: middle;
+    margin: 0 4px;
+}
+
+.dvc .dvl {
+    display: block;
+    text-align: center;
+    padding: 1px 6px;
+}
+
+.dvc .dvl:first-child {
+    border-bottom: 1.5px solid #333;
+}
+
+/* Code output */
+.lang-output-text {
+    font-family: 'Cascadia Code', 'Fira Code', 'Consolas', monospace;
+    font-size: 10.5pt;
+    line-height: 1.5;
+    white-space: pre-wrap;
+    color: #333;
+    padding: 4px 0;
+    margin: 4px 0;
+}
+"""

hekatan-0.1.0/src/hekatan.egg-info/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: hekatan
+Version: 0.1.0
+Summary: Python display library for engineering calculations - matrices, equations, formatted output
+Author-email: Giorgio Burbanelli <giorgioburbanelli89@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/GiorgioBurbanelli89/pyhekatan
+Project-URL: Repository, https://github.com/GiorgioBurbanelli89/pyhekatan
+Project-URL: Issues, https://github.com/GiorgioBurbanelli89/pyhekatan/issues
+Keywords: engineering,calculations,matrix,equations,display,hekatan
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# hekatan
+
+> Python display library for engineering calculations — matrices, equations, formatted output
+
+[![PyPI](https://img.shields.io/pypi/v/hekatan.svg)](https://pypi.org/project/hekatan/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+## Install
+
+```bash
+pip install hekatan
+```
+
+## Quick Start
+
+```python
+from hekatan import matrix, eq, var, fraction, title, text, show
+
+title("Beam Design")
+text("Rectangular section properties:")
+
+var("b", 300, "mm", "beam width")
+var("h", 500, "mm", "beam height")
+
+eq("A", 300 * 500, "mm²")
+
+title("Stiffness Matrix", level=2)
+K = [[12, 6, -12, 6],
+     [6, 4, -6, 2],
+     [-12, -6, 12, -6],
+     [6, 2, -6, 4]]
+matrix(K, "K")
+
+title("Design Ratio", level=2)
+fraction("M_u", "φ · b · d²", "R_n")
+
+show()  # Opens formatted HTML in your browser
+```
+
+## How It Works
+
+Each function (`matrix()`, `eq()`, `var()`, etc.) works in **3 modes**:
+
+| Mode | When | Behavior |
+|------|------|----------|
+| **Hekatan** | Inside Hekatan Calc (WPF/CLI) | Emits `@@HEKATAN` markers → rendered as formatted HTML |
+| **Standalone** | Regular Python script | `show()` generates HTML, opens in browser |
+| **Console** | Fallback | ASCII formatted output |
+
+Mode is auto-detected via `HEKATAN_RENDER=1` environment variable.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `matrix(data, name)` | Display formatted matrix | `matrix([[1,2],[3,4]], "A")` |
+| `eq(name, value, unit)` | Equation: name = value unit | `eq("F", 25.5, "kN")` |
+| `var(name, value, unit, desc)` | Variable with description | `var("b", 300, "mm", "width")` |
+| `fraction(num, den, name)` | Formatted fraction | `fraction("M", "S", "σ")` |
+| `title(text, level)` | Heading (h1-h6) | `title("Results", 2)` |
+| `text(content)` | Paragraph text | `text("Design is OK.")` |
+| `show(filename)` | Generate HTML + open browser | `show()` or `show("out.html")` |
+| `clear()` | Clear accumulated buffer | `clear()` |
+| `set_mode(mode)` | Force mode | `set_mode("console")` |
+
+## Integration with Hekatan Calc
+
+When used inside a Hekatan Calc `.hcalc` document:
+
+```
+# My Calculation
+
+@{python}
+from hekatan import matrix, eq
+
+K = [[12, 6], [6, 4]]
+matrix(K, "K")
+eq("det_K", 12*4 - 6*6)
+@{end python}
+```
+
+The output is automatically formatted with Hekatan's CSS (matrices with brackets, equations with proper typography).
+
+## License
+
+MIT — Giorgio Burbanelli

hekatan-0.1.0/src/hekatan.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/hekatan/__init__.py
+src/hekatan/display.py
+src/hekatan.egg-info/PKG-INFO
+src/hekatan.egg-info/SOURCES.txt
+src/hekatan.egg-info/dependency_links.txt
+src/hekatan.egg-info/top_level.txt
+tests/test_display.py

hekatan-0.1.0/src/hekatan.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

hekatan-0.1.0/src/hekatan.egg-info/top_level.txt

@@ -0,0 +1 @@
+hekatan

hekatan-0.1.0/tests/test_display.py

@@ -0,0 +1,46 @@
+"""Basic tests for hekatan display functions."""
+
+import sys
+import os
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
+
+from hekatan import matrix, eq, var, fraction, title, text, clear, set_mode
+import hekatan.display as disp
+
+
+def test_matrix_console():
+    set_mode("console")
+    matrix([[1, 2], [3, 4]], "A")
+
+
+def test_eq_console():
+    set_mode("console")
+    eq("F", 25.5, "kN")
+
+
+def test_var_console():
+    set_mode("console")
+    var("b", 300, "mm", "ancho")
+
+
+def test_fraction_console():
+    set_mode("console")
+    fraction("M_u", "phi*b*d^2", "R_n")
+
+
+def test_standalone_buffer():
+    set_mode("standalone")
+    clear()
+    matrix([[1, 2], [3, 4]], "A")
+    eq("F", 25.5, "kN")
+    var("b", 300, "mm")
+    assert len(disp._BUFFER) == 3, f"Expected 3, got {len(disp._BUFFER)}"
+
+
+if __name__ == "__main__":
+    test_matrix_console()
+    test_eq_console()
+    test_var_console()
+    test_fraction_console()
+    test_standalone_buffer()
+    print("\nAll tests passed!")