elanous 0.2.10 → 0.2.11

package/skills/diagram-master/references/engines/excalidraw/render_excalidraw.py

@@ -0,0 +1,189 @@
+"""Render Excalidraw JSON to PNG using Playwright + headless Chromium.
+
+Usage:
+    cd references
+    uv run python engines/excalidraw/render_excalidraw.py <path-to-file.excalidraw> [--output path.png] [--scale 2] [--width 1920]
+
+First-time setup:
+    cd references
+    uv sync
+    uv run playwright install chromium
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+
+def validate_excalidraw(data: dict) -> list[str]:
+    """Validate Excalidraw JSON structure. Returns list of errors (empty = valid)."""
+    errors: list[str] = []
+
+    if data.get("type") != "excalidraw":
+        errors.append(f"Expected type 'excalidraw', got '{data.get('type')}'")
+
+    if "elements" not in data:
+        errors.append("Missing 'elements' array")
+    elif not isinstance(data["elements"], list):
+        errors.append("'elements' must be an array")
+    elif len(data["elements"]) == 0:
+        errors.append("'elements' array is empty — nothing to render")
+
+    return errors
+
+
+def compute_bounding_box(elements: list[dict]) -> tuple[float, float, float, float]:
+    """Compute bounding box (min_x, min_y, max_x, max_y) across all elements."""
+    min_x = float("inf")
+    min_y = float("inf")
+    max_x = float("-inf")
+    max_y = float("-inf")
+
+    for el in elements:
+        if el.get("isDeleted"):
+            continue
+        x = el.get("x", 0)
+        y = el.get("y", 0)
+        w = el.get("width", 0)
+        h = el.get("height", 0)
+
+        # For arrows/lines, points array defines the shape relative to x,y
+        if el.get("type") in ("arrow", "line") and "points" in el:
+            for px, py in el["points"]:
+                min_x = min(min_x, x + px)
+                min_y = min(min_y, y + py)
+                max_x = max(max_x, x + px)
+                max_y = max(max_y, y + py)
+        else:
+            min_x = min(min_x, x)
+            min_y = min(min_y, y)
+            max_x = max(max_x, x + abs(w))
+            max_y = max(max_y, y + abs(h))
+
+    if min_x == float("inf"):
+        return (0, 0, 800, 600)
+
+    return (min_x, min_y, max_x, max_y)
+
+
+def render(
+    excalidraw_path: Path,
+    output_path: Path | None = None,
+    scale: int = 2,
+    max_width: int = 1920,
+) -> Path:
+    """Render an .excalidraw file to PNG. Returns the output PNG path."""
+    # Import playwright here so validation errors show before import errors
+    try:
+        from playwright.sync_api import sync_playwright
+    except ImportError:
+        print("ERROR: playwright not installed.", file=sys.stderr)
+        print("Run: cd references && uv sync && uv run playwright install chromium", file=sys.stderr)
+        sys.exit(1)
+
+    # Read and validate
+    raw = excalidraw_path.read_text(encoding="utf-8")
+    try:
+        data = json.loads(raw)
+    except json.JSONDecodeError as e:
+        print(f"ERROR: Invalid JSON in {excalidraw_path}: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    errors = validate_excalidraw(data)
+    if errors:
+        print(f"ERROR: Invalid Excalidraw file:", file=sys.stderr)
+        for err in errors:
+            print(f"  - {err}", file=sys.stderr)
+        sys.exit(1)
+
+    # Compute viewport size from element bounding box
+    elements = [e for e in data["elements"] if not e.get("isDeleted")]
+    min_x, min_y, max_x, max_y = compute_bounding_box(elements)
+    padding = 80
+    diagram_w = max_x - min_x + padding * 2
+    diagram_h = max_y - min_y + padding * 2
+
+    # Cap viewport width, let height be natural
+    vp_width = min(int(diagram_w), max_width)
+    vp_height = max(int(diagram_h), 600)
+
+    # Output path
+    if output_path is None:
+        output_path = excalidraw_path.with_suffix(".png")
+
+    # Template path (same directory as this script)
+    template_path = Path(__file__).parent / "render_template.html"
+    if not template_path.exists():
+        print(f"ERROR: Template not found at {template_path}", file=sys.stderr)
+        sys.exit(1)
+
+    template_url = template_path.as_uri()
+
+    with sync_playwright() as p:
+        try:
+            browser = p.chromium.launch(headless=True)
+        except Exception as e:
+            if "Executable doesn't exist" in str(e) or "browserType.launch" in str(e):
+                print("ERROR: Chromium not installed for Playwright.", file=sys.stderr)
+                print("Run: cd references && uv run playwright install chromium", file=sys.stderr)
+                sys.exit(1)
+            raise
+
+        page = browser.new_page(
+            viewport={"width": vp_width, "height": vp_height},
+            device_scale_factor=scale,
+        )
+
+        # Load the template
+        page.goto(template_url)
+
+        # Wait for the ES module to load (imports from esm.sh)
+        page.wait_for_function("window.__moduleReady === true", timeout=30000)
+
+        # Inject the diagram data and render
+        json_str = json.dumps(data)
+        result = page.evaluate(f"window.renderDiagram({json_str})")
+
+        if not result or not result.get("success"):
+            error_msg = result.get("error", "Unknown render error") if result else "renderDiagram returned null"
+            print(f"ERROR: Render failed: {error_msg}", file=sys.stderr)
+            browser.close()
+            sys.exit(1)
+
+        # Wait for render completion signal
+        page.wait_for_function("window.__renderComplete === true", timeout=15000)
+
+        # Screenshot the SVG element
+        svg_el = page.query_selector("#root svg")
+        if svg_el is None:
+            print("ERROR: No SVG element found after render.", file=sys.stderr)
+            browser.close()
+            sys.exit(1)
+
+        svg_el.screenshot(path=str(output_path))
+        browser.close()
+
+    return output_path
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Render Excalidraw JSON to PNG")
+    parser.add_argument("input", type=Path, help="Path to .excalidraw JSON file")
+    parser.add_argument("--output", "-o", type=Path, default=None, help="Output PNG path (default: same name with .png)")
+    parser.add_argument("--scale", "-s", type=int, default=2, help="Device scale factor (default: 2)")
+    parser.add_argument("--width", "-w", type=int, default=1920, help="Max viewport width (default: 1920)")
+    args = parser.parse_args()
+
+    if not args.input.exists():
+        print(f"ERROR: File not found: {args.input}", file=sys.stderr)
+        sys.exit(1)
+
+    png_path = render(args.input, args.output, args.scale, args.width)
+    print(str(png_path))
+
+
+if __name__ == "__main__":
+    main()

package/skills/diagram-master/references/engines/excalidraw/render_template.html

@@ -0,0 +1,57 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { background: #ffffff; overflow: hidden; }
+    #root { display: inline-block; }
+    #root svg { display: block; }
+  </style>
+</head>
+<body>
+  <div id="root"></div>
+
+  <script type="module">
+    import { exportToSvg } from "https://esm.sh/@excalidraw/excalidraw?bundle";
+
+    window.renderDiagram = async function(jsonData) {
+      try {
+        const data = typeof jsonData === "string" ? JSON.parse(jsonData) : jsonData;
+        const elements = data.elements || [];
+        const appState = data.appState || {};
+        const files = data.files || {};
+
+        // Force white background in appState
+        appState.viewBackgroundColor = appState.viewBackgroundColor || "#ffffff";
+        appState.exportWithDarkMode = false;
+
+        const svg = await exportToSvg({
+          elements: elements,
+          appState: {
+            ...appState,
+            exportBackground: true,
+          },
+          files: files,
+        });
+
+        // Clear any previous render
+        const root = document.getElementById("root");
+        root.innerHTML = "";
+        root.appendChild(svg);
+
+        window.__renderComplete = true;
+        window.__renderError = null;
+        return { success: true, width: svg.getAttribute("width"), height: svg.getAttribute("height") };
+      } catch (err) {
+        window.__renderComplete = true;
+        window.__renderError = err.message;
+        return { success: false, error: err.message };
+      }
+    };
+
+    // Signal that the module is loaded and ready
+    window.__moduleReady = true;
+  </script>
+</body>
+</html>

package/skills/diagram-master/references/engines/matplotlib/matplotlib-patterns.md

@@ -0,0 +1,235 @@
+# Matplotlib 패턴 레퍼런스
+
+## 사용 규칙
+
+1. **plt.savefig() / plt.show() 호출 금지** — 렌더러가 처리
+2. **한글 자동 지원** — 별도 설정 불필요
+3. **수식**: `r'$\frac{dP}{dQ}$'` 형태로 LaTeX 수식 사용
+4. **numpy는 `np`로 사용 가능** — 별도 import 불필요
+
+---
+
+## 패턴 1: 경제학 곡선 (수요/공급)
+
+```python
+# supply_demand.py
+fig, ax = plt.subplots(figsize=(8, 6))
+
+Q = np.linspace(0, 10, 100)
+demand = 12 - Q
+supply = 2 + Q
+
+ax.plot(Q, demand, 'b-', linewidth=2.5, label='수요 (D)')
+ax.plot(Q, supply, 'r-', linewidth=2.5, label='공급 (S)')
+
+# 균형점
+eq_q, eq_p = 5, 7
+ax.plot(eq_q, eq_p, 'ko', markersize=8, zorder=5)
+ax.annotate(f'균형점\n(Q*={eq_q}, P*={eq_p})', xy=(eq_q, eq_p),
+            xytext=(eq_q+1.5, eq_p+1), fontsize=11,
+            arrowprops=dict(arrowstyle='->', color='black'))
+
+ax.set_xlabel('수량 (Q)')
+ax.set_ylabel('가격 (P)')
+ax.set_title('수요-공급 균형')
+ax.legend(loc='upper right')
+ax.set_xlim(0, 11)
+ax.set_ylim(0, 14)
+```
+
+## 패턴 2: 확률분포
+
+```python
+# distributions.py
+from scipy import stats  # scipy는 별도 설치 필요 시 pyproject.toml에 추가
+
+fig, axes = plt.subplots(1, 3, figsize=(15, 5))
+
+# 정규분포
+x = np.linspace(-4, 4, 200)
+for mu, sigma in [(0, 1), (0, 0.5), (1, 1.5)]:
+    axes[0].plot(x, stats.norm.pdf(x, mu, sigma),
+                 label=f'μ={mu}, σ={sigma}')
+axes[0].set_title('정규분포')
+axes[0].legend()
+
+# 포아송
+k = np.arange(0, 20)
+for lam in [1, 4, 10]:
+    axes[1].bar(k + lam*0.15, stats.poisson.pmf(k, lam),
+                width=0.4, alpha=0.7, label=f'λ={lam}')
+axes[1].set_title('포아송분포')
+axes[1].legend()
+
+# 지수분포
+x = np.linspace(0, 5, 200)
+for lam in [0.5, 1, 2]:
+    axes[2].plot(x, stats.expon.pdf(x, scale=1/lam),
+                 label=f'λ={lam}')
+axes[2].set_title('지수분포')
+axes[2].legend()
+
+fig.suptitle('확률분포 비교', fontsize=16, fontweight='bold')
+plt.tight_layout()
+```
+
+## 패턴 3: 히트맵
+
+```python
+# heatmap.py
+fig, ax = plt.subplots(figsize=(10, 8))
+
+data = np.random.randn(8, 10)
+categories_x = [f'Feature {i+1}' for i in range(10)]
+categories_y = [f'Sample {i+1}' for i in range(8)]
+
+im = ax.imshow(data, cmap='RdYlBu_r', aspect='auto')
+ax.set_xticks(range(10))
+ax.set_xticklabels(categories_x, rotation=45, ha='right')
+ax.set_yticks(range(8))
+ax.set_yticklabels(categories_y)
+
+# 값 표시
+for i in range(8):
+    for j in range(10):
+        ax.text(j, i, f'{data[i,j]:.1f}', ha='center', va='center',
+                color='white' if abs(data[i,j]) > 1.5 else 'black', fontsize=9)
+
+fig.colorbar(im, ax=ax, shrink=0.8)
+ax.set_title('Feature Correlation Heatmap')
+```
+
+## 패턴 4: Scatter + Regression
+
+```python
+# scatter_regression.py
+fig, ax = plt.subplots(figsize=(8, 6))
+
+np.random.seed(42)
+x = np.random.uniform(0, 10, 50)
+y = 2.5 * x + np.random.normal(0, 3, 50) + 5
+
+ax.scatter(x, y, alpha=0.6, s=60, c='#4A90D9', edgecolors='white', linewidth=0.5)
+
+# 회귀선
+coeffs = np.polyfit(x, y, 1)
+x_fit = np.linspace(0, 10, 100)
+ax.plot(x_fit, np.polyval(coeffs, x_fit), 'r--', linewidth=2,
+        label=f'y = {coeffs[0]:.1f}x + {coeffs[1]:.1f}')
+
+ax.set_xlabel('Independent Variable')
+ax.set_ylabel('Dependent Variable')
+ax.set_title('Scatter Plot with Linear Regression')
+ax.legend()
+```
+
+## 패턴 5: IS-LM 모델 (경제학)
+
+```python
+# is_lm.py
+fig, ax = plt.subplots(figsize=(8, 6))
+
+Y = np.linspace(0, 20, 200)
+
+# IS curve (우하향)
+r_IS = 12 - 0.5 * Y
+# LM curve (우상향)
+r_LM = -2 + 0.5 * Y
+
+ax.plot(Y, r_IS, 'b-', linewidth=2.5, label='IS')
+ax.plot(Y, r_LM, 'r-', linewidth=2.5, label='LM')
+
+# 균형점
+eq_Y = 14  # 12 - 0.5Y = -2 + 0.5Y → Y = 14
+eq_r = 12 - 0.5 * eq_Y  # r = 5
+ax.plot(eq_Y, eq_r, 'ko', markersize=10, zorder=5)
+ax.annotate(f'균형 (Y*={eq_Y}, r*={eq_r})',
+            xy=(eq_Y, eq_r), xytext=(eq_Y+2, eq_r+1.5),
+            fontsize=11, arrowprops=dict(arrowstyle='->', color='black'))
+
+# IS 이동 (재정정책)
+r_IS2 = 15 - 0.5 * Y
+ax.plot(Y, r_IS2, 'b--', linewidth=1.5, alpha=0.5, label="IS' (재정확대)")
+ax.annotate('', xy=(12, 6), xytext=(9, 7.5),
+            arrowprops=dict(arrowstyle='->', color='blue', lw=1.5))
+
+ax.set_xlabel('국민소득 (Y)')
+ax.set_ylabel('이자율 (r)')
+ax.set_title('IS-LM 모델')
+ax.legend(loc='upper right')
+ax.set_xlim(0, 22)
+ax.set_ylim(-2, 16)
+ax.axhline(y=0, color='gray', linewidth=0.5)
+ax.axvline(x=0, color='gray', linewidth=0.5)
+```
+
+## 패턴 6: 3D Surface
+
+```python
+# surface_3d.py
+fig = plt.figure(figsize=(10, 7))
+ax = fig.add_subplot(111, projection='3d')
+
+x = np.linspace(-3, 3, 100)
+y = np.linspace(-3, 3, 100)
+X, Y = np.meshgrid(x, y)
+Z = np.sin(np.sqrt(X**2 + Y**2))
+
+surf = ax.plot_surface(X, Y, Z, cmap='viridis', alpha=0.8,
+                       edgecolor='none', antialiased=True)
+fig.colorbar(surf, shrink=0.5, aspect=10)
+
+ax.set_xlabel('X')
+ax.set_ylabel('Y')
+ax.set_zlabel('Z')
+ax.set_title(r'$z = \sin(\sqrt{x^2 + y^2})$')
+ax.view_init(elev=30, azim=45)
+```
+
+## 패턴 7: 서브플롯 그리드
+
+```python
+# multi_panel.py
+fig, axes = plt.subplots(2, 2, figsize=(12, 10))
+
+# 각 패널에 개별 차트
+x = np.linspace(0, 2*np.pi, 100)
+
+axes[0,0].plot(x, np.sin(x), 'b-', linewidth=2)
+axes[0,0].set_title(r'$y = \sin(x)$')
+
+axes[0,1].plot(x, np.cos(x), 'r-', linewidth=2)
+axes[0,1].set_title(r'$y = \cos(x)$')
+
+axes[1,0].plot(x, np.exp(-x/3) * np.sin(x), 'g-', linewidth=2)
+axes[1,0].set_title(r'$y = e^{-x/3}\sin(x)$')
+
+axes[1,1].plot(x, np.log(x + 1), 'm-', linewidth=2)
+axes[1,1].set_title(r'$y = \ln(x+1)$')
+
+for ax_row in axes:
+    for ax in ax_row:
+        ax.grid(True, alpha=0.3)
+
+fig.suptitle('수학 함수 패널', fontsize=16, fontweight='bold')
+plt.tight_layout()
+```
+
+## 스타일 추천
+
+| 용도 | 스타일 | 명령 |
+|------|--------|------|
+| 학술 논문 | 기본 (흰배경) | `--style default` |
+| 프레젠테이션 | 어두운 배경 | `--style dark_background` |
+| 통계 보고서 | seaborn 스타일 | `--style seaborn-v0_8` |
+| 깔끔한 차트 | ggplot 스타일 | `--style ggplot` |
+
+## 색상 팔레트 추천
+
+| 팔레트 | 용도 |
+|--------|------|
+| `tab10` | 범주형 데이터 (≤10개) |
+| `Set2` | 부드러운 범주형 |
+| `viridis` | 연속형 데이터 (접근성 우수) |
+| `RdYlBu_r` | 발산형 (양극 비교) |
+| `coolwarm` | 상관관계 히트맵 |

package/skills/diagram-master/references/engines/matplotlib/render_matplotlib.py

@@ -0,0 +1,184 @@
+#!/usr/bin/env python3
+"""
+Matplotlib 렌더러 — diagram-master 스킬용.
+
+사용법:
+  # Python 스크립트 파일 렌더링
+  uv run python render_matplotlib.py chart.py
+
+  # 출력 경로 지정
+  uv run python render_matplotlib.py chart.py --output /path/to/output.png
+
+  # DPI 변경 (기본 300)
+  uv run python render_matplotlib.py chart.py --dpi 150
+
+  # 크기 변경 (기본 10x6 인치)
+  uv run python render_matplotlib.py chart.py --figsize 12 8
+
+  # 다크 테마
+  uv run python render_matplotlib.py chart.py --style dark_background
+
+chart.py 작성 규칙:
+  - fig, ax 변수를 사용하거나 plt 직접 사용
+  - plt.savefig() / plt.show() 호출 금지 (렌더러가 처리)
+  - 한글은 자동 지원 (시스템 폰트 탐지)
+"""
+
+import argparse
+import sys
+import textwrap
+from pathlib import Path
+
+import matplotlib
+matplotlib.use("Agg")  # 비-GUI 백엔드
+
+import matplotlib.pyplot as plt
+import matplotlib.font_manager as fm
+import numpy as np  # noqa: F401 — 스크립트에서 사용 가능하도록
+
+
+def setup_korean_font():
+    """시스템에서 한글 폰트를 자동 탐지하여 설정."""
+    korean_fonts = [
+        "Apple SD Gothic Neo",       # macOS
+        "AppleGothic",               # macOS fallback
+        "Noto Sans KR",              # Cross-platform
+        "NanumGothic",               # Korean standard
+        "Malgun Gothic",             # Windows
+        "NanumBarunGothic",
+    ]
+
+    available = {f.name for f in fm.fontManager.ttflist}
+
+    for font_name in korean_fonts:
+        if font_name in available:
+            plt.rcParams["font.family"] = font_name
+            plt.rcParams["axes.unicode_minus"] = False
+            return font_name
+
+    # fallback: sans-serif에 추가
+    for font_name in korean_fonts:
+        if font_name in available:
+            plt.rcParams["font.sans-serif"] = [font_name] + plt.rcParams["font.sans-serif"]
+            plt.rcParams["axes.unicode_minus"] = False
+            return font_name
+
+    return None
+
+
+def setup_style(style: str | None):
+    """Matplotlib 스타일 설정."""
+    if style:
+        plt.style.use(style)
+    else:
+        # 깔끔한 기본 스타일
+        plt.rcParams.update({
+            "figure.facecolor": "white",
+            "axes.facecolor": "white",
+            "axes.grid": True,
+            "grid.alpha": 0.3,
+            "axes.spines.top": False,
+            "axes.spines.right": False,
+            "font.size": 12,
+            "axes.titlesize": 14,
+            "axes.labelsize": 12,
+        })
+
+
+def render(script_path: str, output: str | None = None, dpi: int = 300,
+           figsize: tuple[float, float] | None = None, style: str | None = None) -> str:
+    """Python 스크립트를 실행하여 PNG로 렌더링."""
+    script = Path(script_path)
+    if not script.exists():
+        print(f"Error: {script_path} not found", file=sys.stderr)
+        sys.exit(1)
+
+    # 한글 폰트 설정
+    korean_font = setup_korean_font()
+    if korean_font:
+        print(f"Korean font: {korean_font}")
+
+    # 스타일 설정
+    setup_style(style)
+
+    # figsize 설정
+    if figsize:
+        plt.rcParams["figure.figsize"] = figsize
+
+    # 스크립트 실행을 위한 네임스페이스 준비
+    namespace = {
+        "plt": plt,
+        "np": np,
+        "fig": None,
+        "ax": None,
+        "__name__": "__main__",
+    }
+
+    # fig, ax 자동 생성 (스크립트에서 직접 만들지 않으면 사용됨)
+    code = script.read_text(encoding="utf-8")
+
+    # 스크립트에서 plt.figure/plt.subplots를 호출하지 않으면 자동 생성
+    if "plt.figure" not in code and "plt.subplots" not in code and "fig" not in code:
+        fig_size = figsize or (10, 6)
+        fig, ax = plt.subplots(figsize=fig_size)
+        namespace["fig"] = fig
+        namespace["ax"] = ax
+
+    # 스크립트 실행
+    try:
+        exec(compile(code, str(script), "exec"), namespace)
+    except Exception as e:
+        print(f"Error executing {script_path}: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    # 출력 경로 결정
+    if output:
+        out_path = Path(output)
+    else:
+        out_path = script.with_suffix(".png")
+
+    # 현재 figure 저장
+    current_fig = plt.gcf()
+    if current_fig.get_axes():
+        current_fig.savefig(
+            str(out_path),
+            dpi=dpi,
+            bbox_inches="tight",
+            pad_inches=0.2,
+            facecolor=current_fig.get_facecolor(),
+            edgecolor="none",
+        )
+        plt.close("all")
+        print(f"Saved: {out_path} ({dpi} DPI)")
+        return str(out_path)
+    else:
+        print("Warning: No plot was created by the script", file=sys.stderr)
+        plt.close("all")
+        sys.exit(1)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Matplotlib 렌더러 — Python 스크립트를 PNG로 변환",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=textwrap.dedent("""\
+            예시:
+              uv run python render_matplotlib.py supply_demand.py
+              uv run python render_matplotlib.py dist.py --dpi 150 --style seaborn-v0_8
+              uv run python render_matplotlib.py chart.py --figsize 12 8 --output result.png
+        """),
+    )
+    parser.add_argument("script", help="렌더링할 Python 스크립트 경로")
+    parser.add_argument("--output", "-o", help="출력 PNG 경로 (기본: 스크립트명.png)")
+    parser.add_argument("--dpi", type=int, default=300, help="DPI (기본: 300)")
+    parser.add_argument("--figsize", nargs=2, type=float, metavar=("W", "H"),
+                        help="Figure 크기 (인치, 기본: 10 6)")
+    parser.add_argument("--style", help="Matplotlib 스타일 (e.g., dark_background, seaborn-v0_8)")
+
+    args = parser.parse_args()
+    figsize = tuple(args.figsize) if args.figsize else None
+    render(args.script, args.output, args.dpi, figsize, args.style)
+
+
+if __name__ == "__main__":
+    main()