@littledragon_wxl/drawio-style-graph 1.0.0 → 1.0.2

package/README.md

@@ -78,6 +78,31 @@ Each style is a complete design system mapped to draw.io `style=` token strings:
 
 ## Quick Start
 
+### Install
+
+```bash
+npx skills add Littledragon-wxl/drawio-style-graph
+```
+
+Or via npm:
+
+```bash
+npm install @littledragon_wxl/drawio-style-graph
+```
+
+### Update to Latest Version
+
+```bash
+# Using npm
+npm update @littledragon_wxl/drawio-style-graph
+
+# Or reinstall to latest
+npm install @littledragon_wxl/drawio-style-graph@latest
+
+# Check current version
+npm list @littledragon_wxl/drawio-style-graph
+```
+
 ### Prerequisites
 
 1. Install draw.io desktop: [download](https://github.com/jgraph/drawio-desktop/releases)

package/README_zh.md

@@ -78,6 +78,31 @@ fireworks-tech-graph                  drawio-skill
 
 ## 快速开始
 
+### 安装
+
+```bash
+npx skills add Littledragon-wxl/drawio-style-graph
+```
+
+或通过 npm：
+
+```bash
+npm install @littledragon_wxl/drawio-style-graph
+```
+
+### 更新到最新版本
+
+```bash
+# 使用 npm 更新
+npm update @littledragon_wxl/drawio-style-graph
+
+# 或重新安装最新版本
+npm install @littledragon_wxl/drawio-style-graph@latest
+
+# 查看当前版本
+npm list @littledragon_wxl/drawio-style-graph
+```
+
 ### 前置条件
 
 1. 安装 draw.io 桌面版：[下载](https://github.com/jgraph/drawio-desktop/releases)

package/SKILL.md

@@ -18,7 +18,7 @@ description: >-
   or mermaid/plantuml code blocks.
 license: MIT
 homepage: https://github.com/Agents365-ai/drawio-style-graph
-install: npx skills add agents365-ai/drawio-style-graph
+install: npx skills add Littledragon-wxl/drawio-style-graph
 compatibility: >-
   Requires draw.io desktop app CLI on PATH (macOS/Linux/Windows) for export.
   Core .drawio generation needs Python 3 only.
@@ -38,13 +38,13 @@ exported file in draw.io recovers the editable diagram.
 ## Install
 
 ```bash
-npx skills add agents365-ai/drawio-style-graph
+npx skills add Littledragon-wxl/drawio-style-graph
 ```
 
 Or directly from npm:
 
 ```bash
-npm install @agents365-ai/drawio-style-graph
+npm install @littledragon_wxl/drawio-style-graph
 ```
 
 No other skills required — everything is self-contained.
@@ -305,6 +305,33 @@ python3 scripts/encode_drawio_url.py diagram.drawio        # viewer
 python3 scripts/encode_drawio_url.py --edit diagram.drawio  # editor
 ```
 
+### Optional: Preview in draw.io Browser
+
+To open the generated `.drawio` file for live editing and preview in draw.io, use the 
+built-in preview script:
+
+```bash
+# Opens in native draw.io desktop app (preferred if installed)
+python3 scripts/open_drawio.py diagram.drawio
+
+# Or force browser editor mode
+python3 scripts/open_drawio.py diagram.drawio --edit
+
+# Or force browser-based preview (if desktop app unavailable)
+python3 scripts/open_drawio.py diagram.drawio --browser
+```
+
+**Supported platforms:**
+- **macOS:** Automatically detects `/Applications/draw.io.app`
+- **Windows:** Looks for `C:\Program Files\draw.io\draw.io.exe`
+- **Linux:** Uses `drawio` command if in PATH
+- **Browser fallback:** Generates a diagrams.net URL if desktop app unavailable
+
+**Behind the scenes:**
+1. Tries to open with the native draw.io app first (fastest, no browser needed)
+2. Falls back to generating a diagrams.net URL if app not found
+3. Automatically opens your default browser with the sharable URL
+
 ## Draw.io XML Quick Reference
 
 ### Vertex (Shape)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@littledragon_wxl/drawio-style-graph",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Generate .drawio diagrams with 8 professional visual styles. Self-contained — no external skill dependencies.",
   "main": "SKILL.md",
   "keywords": [
@@ -40,4 +40,3 @@
     "node": ">=14.0.0"
   }
 }
-

package/scripts/autolayout.py

@@ -305,13 +305,13 @@ def to_drawio(graph, height, pos, edge_pts, color=True):
             f"        </mxCell>"
         )
     return (
-        '<mxfile>\n  <diagram id="autolayout" name="Page-1">\n'
-        '    <mxGraphModel dx="800" dy="600" grid="1" gridSize="10" guides="1" '
-        'tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" '
-        'pageWidth="850" pageHeight="1100" math="0" shadow="0">\n'
+        '<?xml version="1.0" encoding="UTF-8"?>\n'
+        '<mxfile host="drawio" version="26.0.0">\n'
+        '  <diagram name="Page-1">\n'
+        '    <mxGraphModel>\n'
         "      <root>\n"
-        '        <mxCell id="0"/>\n'
-        '        <mxCell id="1" parent="0"/>\n'
+        '        <mxCell id="0" />\n'
+        '        <mxCell id="1" parent="0" />\n'
         + "\n".join(cells)
         + "\n      </root>\n    </mxGraphModel>\n  </diagram>\n</mxfile>\n"
     )

package/scripts/open_drawio.py

@@ -0,0 +1,148 @@
+#!/usr/bin/env python3
+"""Open a .drawio file in the native draw.io application or browser.
+
+Automatically detects the draw.io desktop app across platforms (macOS/Windows/Linux)
+and opens the file. Falls back to generating a diagrams.net URL if the app is unavailable.
+
+Usage: python3 open_drawio.py diagram.drawio
+       python3 open_drawio.py diagram.drawio --edit
+       python3 open_drawio.py diagram.drawio --browser
+"""
+import argparse
+import os
+import platform
+import subprocess
+import sys
+from pathlib import Path
+
+
+def find_drawio_app():
+    """Detect the draw.io desktop app path across platforms."""
+    system = platform.system()
+
+    if system == "Darwin":  # macOS
+        app_path = Path("/Applications/draw.io.app/Contents/MacOS/draw.io")
+        if app_path.exists():
+            return str(app_path)
+    elif system == "Windows":
+        # Try default installation paths
+        paths = [
+            Path("C:/Program Files/draw.io/draw.io.exe"),
+            Path("C:/Program Files (x86)/draw.io/draw.io.exe"),
+        ]
+        for p in paths:
+            if p.exists():
+                return str(p)
+    elif system == "Linux":
+        # Try common Linux paths and PATH
+        if subprocess.run(["which", "drawio"], capture_output=True).returncode == 0:
+            return "drawio"
+        if subprocess.run(["which", "draw.io"], capture_output=True).returncode == 0:
+            return "draw.io"
+
+    return None
+
+
+def open_with_desktop_app(file_path):
+    """Open .drawio file in the native draw.io desktop app."""
+    app = find_drawio_app()
+    if not app:
+        return False
+
+    try:
+        system = platform.system()
+        if system == "Darwin":  # macOS
+            subprocess.Popen(["open", "-a", "draw.io", file_path])
+        elif system == "Windows":
+            subprocess.Popen([app, file_path])
+        else:  # Linux
+            subprocess.Popen([app, file_path])
+        return True
+    except Exception as e:
+        print(f"Failed to open with desktop app: {e}", file=sys.stderr)
+        return False
+
+
+def open_with_browser(file_path, edit_mode=False):
+    """Generate a diagrams.net URL and open in browser."""
+    try:
+        # Use encode_drawio_url.py to generate the URL
+        args = ["python3", "scripts/encode_drawio_url.py"]
+        if edit_mode:
+            args.append("--edit")
+        args.append(file_path)
+
+        result = subprocess.run(args, capture_output=True, text=True, timeout=15)
+        if result.returncode != 0:
+            print(f"Failed to generate URL: {result.stderr}", file=sys.stderr)
+            return False
+
+        url = result.stdout.strip()
+        if not url:
+            print("No URL generated", file=sys.stderr)
+            return False
+
+        # Open in default browser
+        webbrowser_cmd = None
+        system = platform.system()
+        if system == "Darwin":  # macOS
+            webbrowser_cmd = ["open", url]
+        elif system == "Windows":
+            webbrowser_cmd = ["cmd", "/c", f'start "" "{url}"']
+        else:  # Linux
+            webbrowser_cmd = ["xdg-open", url]
+
+        if webbrowser_cmd:
+            subprocess.Popen(webbrowser_cmd)
+            print(f"Opened in browser: {url[:80]}...", file=sys.stderr)
+            return True
+    except Exception as e:
+        print(f"Failed to open in browser: {e}", file=sys.stderr)
+        return False
+
+    return False
+
+
+def main():
+    ap = argparse.ArgumentParser(
+        description="Open a .drawio file in draw.io (desktop or browser).",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  python3 open_drawio.py diagram.drawio          # Opens in desktop app (preferred)
+  python3 open_drawio.py diagram.drawio --edit   # Opens in browser editor mode
+  python3 open_drawio.py diagram.drawio --browser # Force browser (diagrams.net)
+        """,
+    )
+    ap.add_argument("file", help=".drawio file path")
+    ap.add_argument(
+        "--edit",
+        action="store_true",
+        help="Open in edit mode (browser only)",
+    )
+    ap.add_argument(
+        "--browser",
+        action="store_true",
+        help="Force opening in browser (skip desktop app)",
+    )
+    args = ap.parse_args()
+
+    file_path = Path(args.file)
+    if not file_path.exists():
+        sys.exit(f"error: file not found: {args.file}")
+
+    if not args.browser:
+        # Try desktop app first
+        if open_with_desktop_app(str(file_path)):
+            print(f"Opened in draw.io desktop app: {file_path}", file=sys.stderr)
+            return
+
+    # Fallback to browser
+    if open_with_browser(str(file_path), edit_mode=args.edit):
+        return
+
+    sys.exit("error: could not open .drawio file (no draw.io app or browser available)")
+
+
+if __name__ == "__main__":
+    main()