{
  "markdown": "# Qingkuai Language Features\n\nQingkuai Language Features is the official language tooling workspace for QingKuai files (`.qk`).\n\nIt contains the full toolchain used by the VS Code extension, including:\n\n- language grammar and syntax highlighting\n- language service (analysis, completion, formatting, diagnostics)\n- language server (LSP)\n- TypeScript plugin integration\n\n## Workspace Packages\n\n| Package                      | Description                                                |\n| ---------------------------- | ---------------------------------------------------------- |\n| `packages/language-service`  | Core language intelligence and compiler-adapter logic      |\n| `packages/language-server`   | LSP server on top of language-service                      |\n| `packages/vscode-extension`  | VS Code extension client + grammar + commands              |\n| `packages/typescript-plugin` | TS server plugin for QingKuai-specific behavior            |\n| `packages/mcp-server`        | Model Context Protocol server for AI assistant integration |\n\n## Install Vscode Extension\n\nInstall from VS Code Marketplace:\n\n- `qingkuai-tools.qingkuai-language-features`\n- https://marketplace.visualstudio.com/items?itemName=qingkuai-tools.qingkuai-language-features\n\nAfter installation, open any `.qk` file to activate the extension.\n\n### Features\n\n- **Rich Syntax Highlighting** — Full support for `.qk` files and embedded languages (`js/ts/css/sass/scss/less/stylus/postcss`)\n- **Smart Completions** — Context-aware suggestions for directives, attributes, slots, and events\n- **Hover Documentation** — Instant inline help with type information for directives and framework keywords\n- **Type Checking & Diagnostics** — Real-time analysis powered by compiler integration, including generic type validation\n- **Code Navigation** — Go to Definition / References / Rename / Code Lens / Signature Help support\n- **Document Formatting** — Prettier-based formatting with Qingkuai-specific rules and support for component tags with generic parameters\n- **AI Integration** — Optional Model Context Protocol (MCP) server support for AI assistant tools\n\n## Local Development\n\n### Requirements\n\n- Node.js 18+\n- pnpm 8+\n\n### Setup\n\n```bash\ngit clone https://github.com/qingkuai-js/language-features.git\ncd language-features\npnpm install\n```\n\n### Build\n\n```bash\nnpm run build\n```\n\nThis command builds all packages via Rollup and emits outputs into `dist` directories.\n\n### Watch Mode\n\n```bash\nnpm run dev\n```\n\n### Grammar Build (extension package)\n\n```bash\ncd packages/vscode-extension\nnpm run build:grammars\n```\n\n## Architecture Overview\n\n1. VS Code extension starts and launches the QingKuai language server.\n2. Extension configures the TypeScript plugin (`typescript-plugin-qingkuai`) for tsserver.\n3. Language server delegates core analysis/format/diagnostics to `qingkuai-language-service`.\n4. Language service integrates compiler output and framework-specific semantics.\n5. Optional: MCP server provides QingKuai tools and analysis to compatible AI assistants (Claude, etc.)\n\n## License\n\nMIT\n",
  "bytes": 3077,
  "sha": "8b3519e3b0e78ebcaafa18ce40966b3dd0baa630d10df37d1bffc90d43af9f82",
  "repo_slug": "qingkuai-js/language-features",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_qingkuai_js_qingkuai_mcp_serve_2dddaae6/readme"
}