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