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:
After installation, open any .qk file to activate the extension.
Features
- Rich Syntax Highlighting — Full support for
.qk files 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
Setup
git clone https://github.com/qingkuai-js/language-features.git
cd language-features
pnpm install
Build
This command builds all packages via Rollup and emits outputs into dist directories.
Watch Mode
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