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 .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

• 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

1. VS Code extension starts and launches the QingKuai language server.
2. Extension configures the TypeScript plugin (typescript-plugin-qingkuai) for tsserver.
3. Language server delegates core analysis/format/diagnostics to qingkuai-language-service.
4. Language service integrates compiler output and framework-specific semantics.
5. Optional: MCP server provides QingKuai tools and analysis to compatible AI assistants (Claude, etc.)

License

MIT