larkvs 0.1__tar.gz

larkvs-0.1/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: larkvs
+Version: 0.1
+Summary: A visual debugging tool for Lark grammars, VS Code-style desktop IDE.
+Author-email: 2229066748@qq.com
+Maintainer: Eagle'sBaby
+Maintainer-email: 2229066748@qq.com
+License: Apache Licence 2.0
+Keywords: python,lark,ui
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: PyQt6>6.4
+Requires-Dist: lark>=1.1.0
+Requires-Dist: qtawesome
+Requires-Dist: fastmcp<3,>2
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: keywords
+Dynamic: license
+Dynamic: maintainer
+Dynamic: maintainer-email
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Lark Visual Studio
+
+A visual debugging tool for Lark grammars, VS Code-style desktop IDE.
+
+## Features
+
+- **Grammar Editing** — Lark syntax highlighting, code completion, color configuration (`#RRGGBB` inline/block)
+- **Parse Tree Visualization** — Tree/text dual view, node color mapping, click-to-locate source
+- **Execution Engine** — Write and run Transformer/Visitor code, variable monitor, safe sandbox
+- **Compile & Run Pipeline** — Compile (F6) parse only; Run (F5) parse + compile + execute
+- **Project Management** — `.larkvs` project directories, recent projects, import/export `.plark`
+- **Theme System** — Light/dark real-time switching
+- **Settings System** — General/Appearance/Editor/Shortcuts/Interpreter, global and project-level
+- **MCP Integration** — Claude Code can read/write grammar, trigger compile/run via MCP
+- **Built-in Examples** — Arithmetic, JSON, CSV, lexical analysis, Lua interpreter, and more
+
+## Installation
+
+```bash
+pip install larkvs
+```
+
+## Usage
+
+```bash
+# Launch GUI (default)
+larkvs
+
+# Open a project file
+larkvs -f <path/to/project>/.larkvs
+
+# Start MCP Server (stdio transport)
+larkvs -m
+
+# Show help
+larkvs -h
+```
+
+| Flag | Description |
+|------|-------------|
+| `-m`, `--mcp` | Start MCP Server (stdio) for AI clients like Claude Code |
+| `-f`, `--file` <path> | Open the specified `.larkvs` project file |
+| `-h` | Show help and exit |
+
+## Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| F6 | Compile (parse only) |
+| F5 | Run (compile + execute) |
+| Ctrl+, | Open settings |
+| Ctrl+Shift+F | Global search |
+| Double Shift | Search dialog |
+
+## Project Structure
+
+```
+main.py            Main window + entry point
+common.py          Base components (CodeEditor, Icons, StatusBar)
+panels.py          Feature panels (grammar editor, test input, parse result, console)
+execution.py       Execution engine (ExecutionPanel, VariableMonitor, ProblemPanel)
+workspace.py       Workspace (ActivityBar, TabWorkspace, BottomPanel, search dialog)
+workers.py         Background threads (ParseWorker, ExecutionWorker)
+highlighters.py    Syntax highlighters
+colorparser.py     Color configuration parser
+colorpicker.py     Color picker popup
+completer.py       Code completion
+home.py            Home page (recent project buttons)
+projectio.py       Project file I/O
+settings.py        Settings dialog
+settingsmgr.py     Settings manager
+settingsui.py      Settings UI components
+theme.py           Theme/examples/templates
+xml_tree_canvas.py XML tree visualization
+claude_helper.py   Claude Code integration
+mcp_ipc.py         MCP TCP server
+mcp_server.py      MCP standalone server
+mcp_tools.py       MCP method constants
+```

larkvs-0.1/larkvs/__init__.py

@@ -0,0 +1,50 @@
+"""Lark Visual Studio — Lark 语法可视化调试工具"""
+import sys
+import argparse
+from pathlib import Path
+
+
+def FN_OpenUI(filepath=None):
+    """启动 Lark Visual Studio GUI。"""
+    from PyQt6.QtWidgets import QApplication
+    from PyQt6.QtGui import QFont
+    from larkvs.main import MainWindow
+
+    app = QApplication(sys.argv)
+    app.setApplicationName("Lark Visual Studio")
+    app.setStyle("Fusion")
+
+    _font = QFont("Segoe UI", 10)
+    _font.setStyleHint(QFont.StyleHint.SansSerif)
+    app.setFont(_font)
+
+    window = MainWindow()
+
+    if filepath:
+        _path = Path(filepath).resolve()
+        if _path.exists():
+            window._loadProjectFromPath(str(_path))
+        else:
+            print(f"项目文件不存在: {_path}")
+
+    window.show()
+    sys.exit(app.exec())
+
+
+def FN_StartMCP():
+    """启动 larkvs MCP Server (stdio 传输)。"""
+    from larkvs.mcp_server import mcp
+    mcp.run(transport="stdio")
+
+
+def CMD_Enter():
+    """larkvs 入口：默认启动 GUI，-m 启动 MCP Server。"""
+    _parser = argparse.ArgumentParser(description="Lark Visual Studio")
+    _parser.add_argument("-m", "--mcp", action="store_true", help="启动 MCP Server (stdio)")
+    _parser.add_argument("-f", "--file", dest="file", default=None, help="打开指定的 .larkvs 项目文件")
+    _args = _parser.parse_args()
+
+    if _args.mcp:
+        FN_StartMCP()
+    else:
+        FN_OpenUI(_args.file)

larkvs-0.1/larkvs/claude_helper.py

@@ -0,0 +1,106 @@
+"""Claude Code 辅助集成"""
+import json
+import os
+import shutil
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+from PyQt6.QtWidgets import QMessageBox
+
+
+class ClaudeHelperMixin:
+    """提供“帮助 claude”菜单功能：检测 claude、生成 MCP 配置并启动。"""
+
+    def _onHelpClaude(self):
+        """检查 claude 是否可用，若可用则创建临时目录、写入 MCP 配置并启动 claude。"""
+        claude_cmd = shutil.which("claude")
+        if claude_cmd is None:
+            QMessageBox.warning(
+                self,
+                "claude 未找到",
+                "未在 PATH 中找到 claude 命令。\n\n"
+                "请确保 Claude Code CLI 已安装并添加到系统 PATH 中。\n"
+                "安装指南: https://docs.anthropic.com/en/docs/claude-code/setup",
+            )
+            return
+
+        project_root = Path(__file__).parent.resolve()
+        mcp_server_path = project_root / "mcp_server.py"
+        if not mcp_server_path.exists():
+            QMessageBox.critical(
+                self,
+                "错误",
+                f"未找到 MCP 服务器脚本:\n{mcp_server_path}\n\n"
+                "请确保项目文件完整。",
+            )
+            return
+
+        temp_dir = Path(tempfile.mkdtemp(prefix="larkvs_claude_"))
+        claude_dir = temp_dir / ".claude"
+        try:
+            claude_dir.mkdir(parents=True, exist_ok=True)
+        except Exception as e:
+            QMessageBox.critical(
+                self,
+                "错误",
+                f"无法创建临时目录:\n{claude_dir}\n\n{str(e)}",
+            )
+            return
+
+        settings = {
+            "mcpServers": {
+                "larkvs": {
+                    "command": sys.executable,
+                    "args": [str(mcp_server_path)],
+                    "env": {
+                        "LARKVS_PID": str(os.getpid()),
+                        "PYTHONIOENCODING": "utf-8",
+                        "PYTHONUNBUFFERED": "1",
+                    },
+                    "type": "stdio",
+                }
+            }
+        }
+        settings_path = claude_dir / "settings.json"
+        try:
+            settings_path.write_text(
+                json.dumps(settings, ensure_ascii=False, indent=2),
+                encoding="utf-8",
+            )
+        except Exception as e:
+            QMessageBox.critical(
+                self,
+                "错误",
+                f"无法写入 Claude 设置文件:\n{settings_path}\n\n{str(e)}",
+            )
+            return
+
+        if hasattr(self, "_console"):
+            self._console.appendInfo(f"正在启动 claude，临时目录: {temp_dir}")
+        if hasattr(self, "_statusBar"):
+            self._statusBar.showMessage("正在启动 claude...", 5000)
+
+        try:
+            kwargs = {}
+            if os.name == "nt":
+                kwargs["creationflags"] = subprocess.CREATE_NEW_CONSOLE
+
+            subprocess.Popen(
+                [claude_cmd],
+                cwd=str(temp_dir),
+                env={**os.environ},
+                **kwargs,
+            )
+
+            if hasattr(self, "_statusBar"):
+                self._statusBar.showMessage(
+                    f"claude 已启动 ({temp_dir.name})", 5000
+                )
+        except Exception as e:
+            QMessageBox.critical(
+                self,
+                "启动失败",
+                f"无法启动 claude:\n\n{str(e)}",
+            )

larkvs-0.1/larkvs/colorparser.py

@@ -0,0 +1,403 @@
+"""颜色配置解析器：从语法文本中提取颜色配置，剥离写法2配置块"""
+import re
+from dataclasses import dataclass, field
+
+
+# ==================== 常量 ====================
+COLOR_PATTERN = re.compile(r'#[0-9A-Fa-f]{6}(?::(?:light|dark))?')
+HEX_PREFIX = re.compile(r'#[0-9A-Fa-f]{6}')
+
+
+# ==================== 数据类 ====================
+@dataclass
+class ColorConfig:
+    """颜色配置项（纯数据，不含方法）"""
+    light: str | None = None
+    dark: str | None = None
+    tokens: set = field(default_factory=set)
+
+
+# ==================== 解析函数 ====================
+def ParseColorConfigs(text):
+    """从语法文本中解析颜色配置，返回 list[ColorConfig]
+
+    识别两种写法：
+    - 写法1（行内/向上匹配）：#color 附加到规则行末尾或独立行
+    - 写法2（事后描述）：#color { tokens } 或多行变体
+    """
+    lines = text.split('\n')
+    configs = []
+    i = 0
+    n = len(lines)
+
+    while i < n:
+        stripped = lines[i].strip()
+
+        # 跳过空行和注释行
+        if not stripped or stripped.startswith('//'):
+            i += 1
+            continue
+
+        # 尝试写法2（事后描述）
+        result = _tryPostDesc(lines, i)
+        if result is not None:
+            config, nextI = result
+            configs.append(config)
+            i = nextI
+            continue
+
+        # 尝试写法1行内（规则行末尾带 #color）
+        config = _tryInline(lines[i])
+        if config is not None:
+            configs.append(config)
+            i += 1
+            continue
+
+        # 尝试写法1向上匹配（独立颜色行，无 { 跟随）
+        config = _tryUpward(lines, i)
+        if config is not None:
+            configs.append(config)
+            i += 1
+            continue
+
+        i += 1
+
+    return configs
+
+
+def StripColorConfigs(text):
+    """剥离写法2配置块，返回纯 Lark 语法
+
+    写法1的 #color 是 Lark 注释，无需剥离。
+    写法2的 {...} 和 (...) 非注释，必须剥离。
+    """
+    lines = text.split('\n')
+    result = []
+    i = 0
+    n = len(lines)
+
+    while i < n:
+        stripped = lines[i].strip()
+
+        # 空行和注释行保留
+        if not stripped or stripped.startswith('//'):
+            result.append(lines[i])
+            i += 1
+            continue
+
+        # 检查是否为写法2块起始
+        blockEnd = _findPostDescEnd(lines, i)
+        if blockEnd is not None:
+            i = blockEnd + 1
+            continue
+
+        result.append(lines[i])
+        i += 1
+
+    return '\n'.join(result)
+
+
+# ==================== 内部函数 ====================
+def _extractColors(text):
+    """从文本中提取颜色值，返回 dict: {'light': str|None, 'dark': str|None}"""
+    result = {'light': None, 'dark': None}
+    for m in COLOR_PATTERN.finditer(text):
+        full = m.group(0)
+        hexval = full[:7]  # #RRGGBB
+        suffix = full[7:]  # :light, :dark, or ''
+        if suffix == ':light':
+            result['light'] = hexval
+        elif suffix == ':dark':
+            result['dark'] = hexval
+        else:
+            # 无后缀：同时应用于 light 和 dark
+            if result['light'] is None:
+                result['light'] = hexval
+            if result['dark'] is None:
+                result['dark'] = hexval
+    return result
+
+
+def _extractTokenNames(text):
+    """从文本中提取 TOKEN 名称（终结符名和字面量）"""
+    tokens = set()
+    # 字符串字面量: "..."
+    for m in re.finditer(r'"([^"]*)"', text):
+        tokens.add(m.group(1))
+    # 大写标识符（终结符名）
+    for m in re.finditer(r'\b[A-Z_][A-Z_0-9]*\b', text):
+        tokens.add(m.group(0))
+    return tokens
+
+
+def _extractTokensFromRule(line):
+    """从规则行中提取终结符名和字面量"""
+    # 先移除颜色值
+    cleaned = COLOR_PATTERN.sub('', line)
+    return _extractTokenNames(cleaned)
+
+
+def _isRuleLine(text):
+    """判断是否为规则行（含 : 或以 | 开头）"""
+    # 先移除颜色值，避免 :light/:dark 后缀导致误判
+    cleaned = COLOR_PATTERN.sub('', text).strip()
+    return ':' in cleaned or cleaned.startswith('|')
+
+
+def _tryPostDesc(lines, startIdx):
+    """尝试解析写法2（事后描述），返回 (ColorConfig, nextIdx) 或 None"""
+    idx = startIdx
+    line = lines[idx].strip()
+
+    # 情况1：以 ( 开头的颜色组
+    if line.startswith('('):
+        return _tryPostDescParen(lines, idx)
+
+    # 情况2：以 #color 开头
+    if not HEX_PREFIX.match(line):
+        return None
+
+    colors = _extractColors(line)
+    afterColors = COLOR_PATTERN.sub('', line).strip()
+
+    # #color { ... } 同行
+    if afterColors.startswith('{'):
+        tokens = _parseBraceInline(afterColors)
+        if tokens is None:
+            # 多行 { }，查找闭合 }
+            endIdx = _findClosingBrace(lines, idx)
+            if endIdx is None:
+                return None
+            tokens = _parseBraceBlock(lines, idx, endIdx)
+            return ColorConfig(colors['light'], colors['dark'], tokens), endIdx + 1
+        # } 也在同行
+        return ColorConfig(colors['light'], colors['dark'], tokens), idx + 1
+
+    # #color 独立行，查找下一非空行是否有 {
+    if not afterColors:
+        nextIdx = idx + 1
+        while nextIdx < len(lines):
+            s = lines[nextIdx].strip()
+            if not s or s.startswith('//'):
+                nextIdx += 1
+                continue
+            if s.startswith('{'):
+                endIdx = _findClosingBrace(lines, nextIdx)
+                if endIdx is None:
+                    return None
+                tokens = _parseBraceBlock(lines, nextIdx, endIdx)
+                return ColorConfig(colors['light'], colors['dark'], tokens), endIdx + 1
+            return None  # 非 {，不是写法2
+        return None
+
+    return None
+
+
+def _tryPostDescParen(lines, startIdx):
+    """处理以 ( 开头的颜色组写法2"""
+    idx = startIdx
+    # 收集直到 ) 的文本
+    groupEnd = idx
+    while groupEnd < len(lines):
+        if ')' in lines[groupEnd]:
+            break
+        groupEnd += 1
+    if groupEnd >= len(lines):
+        return None
+
+    groupText = ' '.join(lines[j].strip() for j in range(idx, groupEnd + 1))
+    # 检查组内是否有颜色
+    if not HEX_PREFIX.search(groupText):
+        return None
+
+    colors = _extractColors(groupText)
+
+    # 检查 ) 后是否有 {
+    lineWithParen = lines[groupEnd].strip()
+    parenEnd = lineWithParen.index(')')
+    afterParen = lineWithParen[parenEnd + 1:].strip()
+
+    if afterParen.startswith('{'):
+        endIdx = _findClosingBrace(lines, groupEnd)
+        if endIdx is None:
+            return None
+        tokens = _parseBraceBlock(lines, groupEnd, endIdx)
+        return ColorConfig(colors['light'], colors['dark'], tokens), endIdx + 1
+
+    if not afterParen:
+        # 查找下一非空行
+        nextIdx = groupEnd + 1
+        while nextIdx < len(lines):
+            s = lines[nextIdx].strip()
+            if not s or s.startswith('//'):
+                nextIdx += 1
+                continue
+            if s.startswith('{'):
+                endIdx = _findClosingBrace(lines, nextIdx)
+                if endIdx is None:
+                    return None
+                tokens = _parseBraceBlock(lines, nextIdx, endIdx)
+                return ColorConfig(colors['light'], colors['dark'], tokens), endIdx + 1
+            return None
+        return None
+
+    return None
+
+
+def _findClosingBrace(lines, startIdx):
+    """从 startIdx 开始查找包含 } 的行索引，返回索引或 None"""
+    for j in range(startIdx, len(lines)):
+        if '}' in lines[j]:
+            return j
+    return None
+
+
+def _parseBraceInline(text):
+    """解析同行 { ... } 内的 tokens。返回 set 或 None（如果 } 不在同行）"""
+    braceStart = text.index('{')
+    braceEnd = text.find('}', braceStart)
+    if braceEnd == -1:
+        return None  # } 不在同行
+    inner = text[braceStart + 1:braceEnd].strip()
+    return _extractTokenNames(inner)
+
+
+def _parseBraceBlock(lines, braceIdx, endIdx):
+    """解析多行 { ... } 块内的 tokens"""
+    tokens = set()
+    for j in range(braceIdx, endIdx + 1):
+        s = lines[j].strip()
+        if j == braceIdx:
+            # 第一行：移除 { 前的内容
+            if '{' in s:
+                s = s[s.index('{') + 1:].strip()
+        if j == endIdx:
+            # 最后一行：移除 } 及之后的内容
+            if '}' in s:
+                s = s[:s.index('}')].strip()
+        if not s or s.startswith('//'):
+            continue
+        tokens.update(_extractTokenNames(s))
+    return tokens
+
+
+def _tryInline(line):
+    """尝试解析写法1行内（规则行末尾带 #color）"""
+    stripped = line.strip()
+
+    colors = _extractColors(stripped)
+    if colors['light'] is None and colors['dark'] is None:
+        return None
+
+    # 移除颜色后的内容
+    afterColors = COLOR_PATTERN.sub('', stripped).strip()
+
+    # 必须是规则行
+    if not _isRuleLine(afterColors):
+        return None
+
+    tokens = _extractTokensFromRule(afterColors)
+    return ColorConfig(colors['light'], colors['dark'], tokens)
+
+
+def _tryUpward(lines, idx):
+    """尝试解析写法1向上匹配（独立颜色行，应用于上一规则行）"""
+    stripped = lines[idx].strip()
+
+    colors = _extractColors(stripped)
+    if colors['light'] is None and colors['dark'] is None:
+        return None
+
+    # 移除颜色后必须为空（纯颜色行）
+    afterColors = COLOR_PATTERN.sub('', stripped).strip()
+    if afterColors:
+        return None
+
+    # 查找上一非空、非注释行（跳过颜色行）
+    prevIdx = idx - 1
+    while prevIdx >= 0:
+        prevLine = lines[prevIdx].strip()
+        if not prevLine or prevLine.startswith('//'):
+            prevIdx -= 1
+            continue
+        # 跳过独立的颜色行
+        prevAfterColors = COLOR_PATTERN.sub('', prevLine).strip()
+        prevColors = _extractColors(prevLine)
+        if not prevAfterColors and (prevColors['light'] is not None or prevColors['dark'] is not None):
+            prevIdx -= 1
+            continue
+        if _isRuleLine(prevLine):
+            tokens = _extractTokensFromRule(prevLine)
+            return ColorConfig(colors['light'], colors['dark'], tokens)
+        break
+
+    return None
+
+
+def _findPostDescEnd(lines, startIdx):
+    """如果 lines[startIdx] 开始一个写法2块，返回块最后一行的索引；否则 None"""
+    idx = startIdx
+    line = lines[idx].strip()
+
+    # 以 ( 开头的颜色组
+    if line.startswith('('):
+        # 查找 )
+        groupEnd = idx
+        while groupEnd < len(lines):
+            if ')' in lines[groupEnd]:
+                break
+            groupEnd += 1
+        if groupEnd >= len(lines):
+            return None
+
+        groupText = ' '.join(lines[j].strip() for j in range(idx, groupEnd + 1))
+        if not HEX_PREFIX.search(groupText):
+            return None
+
+        lineWithParen = lines[groupEnd].strip()
+        parenEnd = lineWithParen.index(')')
+        afterParen = lineWithParen[parenEnd + 1:].strip()
+
+        if afterParen.startswith('{'):
+            endIdx = _findClosingBrace(lines, groupEnd)
+            return endIdx if endIdx is not None else None
+
+        if not afterParen:
+            nextIdx = groupEnd + 1
+            while nextIdx < len(lines):
+                s = lines[nextIdx].strip()
+                if not s or s.startswith('//'):
+                    nextIdx += 1
+                    continue
+                if s.startswith('{'):
+                    endIdx = _findClosingBrace(lines, nextIdx)
+                    return endIdx if endIdx is not None else None
+                return None
+        return None
+
+    # 以 #color 开头
+    if not HEX_PREFIX.match(line):
+        return None
+
+    afterColors = COLOR_PATTERN.sub('', line).strip()
+
+    # #color { ... } 同行
+    if afterColors.startswith('{'):
+        endIdx = _findClosingBrace(lines, idx)
+        return endIdx if endIdx is not None else idx
+
+    # #color 独立行，查找下一非空行
+    if not afterColors:
+        nextIdx = idx + 1
+        while nextIdx < len(lines):
+            s = lines[nextIdx].strip()
+            if not s or s.startswith('//'):
+                nextIdx += 1
+                continue
+            if s.startswith('{'):
+                endIdx = _findClosingBrace(lines, nextIdx)
+                return endIdx if endIdx is not None else None
+            return None
+        return None
+
+    return None