Kip - Turkish Programming Language Support for VS Code

⚠️ Community-Maintained Extension - This extension is not official and is maintained by the community. For official Kip language resources, please visit the official Kip repository.

VS Code extension for the Kip programming language - a Turkish grammar-based functional programming language. This extension provides syntax highlighting, code completion, and language server features for Kip.

📥 Installation

For End Users

Option 1: Install from GitHub Releases (Recommended)

Go to GitHub Releases
Download the latest .vsix file from the Assets section
Open VS Code
Press Ctrl+Shift+P (or Cmd+Shift+P on macOS)
Type "Extensions: Install from VSIX..."
Select the downloaded .vsix file

Option 2: Install from VS Code Marketplace

Note: This extension may not be available on the marketplace yet. Use GitHub Releases instead.

For Developers

See the Development section below.

✨ Features

🎨 Syntax Highlighting

Semantic highlighting via Language Server Protocol (LSP)
Multi-word type recognition (e.g., "öğe listesi")
Color-coded syntax for:
- Functions
- Types
- Variables
- Keywords
- Strings and numbers

Go to Definition (F12) - Jump to where symbols are defined
Find All References (Shift+F12) - Find all usages of a symbol
Workspace Symbols (Ctrl+T / Cmd+T) - Search symbols across your workspace
Document Outline (Ctrl+Shift+O / Cmd+Shift+O) - View all symbols in current file

💡 Code Intelligence

Auto-completion - Smart suggestions as you type
Hover Information - See documentation when hovering over symbols
Code Formatting - Format your code with Shift+Alt+F
Code Actions - Quick fixes and refactorings (Ctrl+. / Cmd+.)

🚀 Code Execution

Run Kip Files - Execute .kip files directly from VS Code
- Click the ▶️ button in the editor toolbar
- Or press Ctrl+Shift+R (Cmd+Shift+R on macOS)
- Or use Command Palette: "Kip: Run File"

📝 Language Support

Turkish grammar-based syntax
Type declarations: Bir ... ya ... olabilir
Function definitions with gerund patterns (-mak/-mek)
Variable definitions: X Y Z diyelim
Pattern matching and conditional expressions

🚀 Quick Start

Install the extension (see Installation above)
Open a .kip file in VS Code
Start coding! The extension will automatically:
- Highlight your code
- Provide code completion
- Show errors and warnings
Run your code using the ▶️ button or Ctrl+Shift+R

📚 Example Code

Here's a simple example to get you started:

Bir (öğe listesi)
ya boş
ya da bir öğenin bir öğe listesine eki
olabilir.

(bu öğe listesiyle) (şu öğe listesinin) birleşimi,
  bu boşsa,
    şu,
  ilkin devama ekiyse,
    ilkin (devamla şunun birleşimine) ekidir.

(bu öğe listesinin) tersi,
  bu boşsa,
    boş,
  ilkin devama ekiyse,
    (devamın tersiyle) 
      (ilkin boşa ekinin) birleşimidir.

((1'in (2'nin boşa ekine) ekinin) tersini) bastır.

⚙️ Configuration

You can configure the extension in VS Code settings (Ctrl+, / Cmd+,):

{
  "kip.compilerPath": "",           // Path to Kip compiler (empty = auto-detect)
  "kip.lspPath": "",              // Path to Kip LSP server (empty = auto-detect)
  "kip.enableCodeLens": true,     // Show reference counts above symbols
  "kip.formatOnSave": false,     // Automatically format on save
  "kip.enableWorkspaceSymbols": true // Enable workspace symbol search
}

🔗 Useful Links

Official Kip Language: kip-dili/kip - The official Kip programming language repository
Kip Language Documentation: Check the official repository for language documentation and tutorials
Report Issues: GitHub Issues - Found a bug? Let us know!
Request Features: GitHub Issues - Have an idea? We'd love to hear it!
Latest Releases: GitHub Releases - Download the latest version

🐛 Troubleshooting

Extension not working?

Restart VS Code - Sometimes a simple restart fixes issues
Check the Output Panel - Open Output (Ctrl+Shift+U / Cmd+Shift+U) and select "Kip Language Server"
Reload Window - Press Ctrl+Shift+P / Cmd+Shift+P and run "Developer: Reload Window"

Syntax highlighting not working?

Make sure you're editing a .kip file
Check that the file is recognized as "Kip" language (see bottom-right of VS Code)
Try reloading the window

Code completion not working?

The extension uses LSP (Language Server Protocol) for code intelligence
Make sure the LSP server started successfully (check Output panel)
Try restarting the extension host: Ctrl+Shift+P → "Developer: Restart Extension Host"

Can't run Kip files?

Make sure you have the Kip compiler installed
Check that kip command is available in your terminal
See the official Kip repository for installation instructions

🛠 Development

For Contributors

This extension is open source and community-maintained. Contributions are welcome!

Prerequisites

Node.js 20+
npm
TypeScript
VS Code 1.80+

Setup

# Clone the repository
git clone https://github.com/algorynth/kip-vscode-language-support.git
cd kip-vscode-language-support

# Install dependencies
npm install

# Compile TypeScript
npm run compile

Development Workflow

# Watch mode (auto-compile on changes)
npm run watch

# Run tests
npm test
npm run test:lsp

# Package extension
npm run package

Project Structure

kip-vscode-language-support/
├── src/
│   ├── extension.ts          # Main extension entry point
│   ├── server/
│   │   └── server.ts          # LSP server implementation
│   ├── semanticTokensProvider.ts
│   ├── completionProvider.ts
│   ├── hoverProvider.ts
│   ├── definitionProvider.ts
│   ├── referenceProvider.ts
│   ├── renameProvider.ts
│   ├── codeActionProvider.ts
│   ├── formattingProvider.ts
│   ├── diagnosticProvider.ts
│   └── kipRunner.ts          # Kip file execution
├── scripts/
│   ├── test-lsp-detailed.js  # LSP test suite
│   └── ...
├── .github/
│   └── workflows/
│       └── build-extension.yml # CI/CD workflow
└── package.json

LSP Server

The extension includes a custom TypeScript-based LSP server that provides:

Document Analysis: Parses Kip code to extract types, functions, variables, and symbols
Semantic Highlighting: Identifies and highlights different token types
Code Navigation: Definition and reference finding
Symbol Management: Tracks symbols across documents

Testing

The extension includes comprehensive tests:

Extension Tests: npm test - Tests extension functionality
LSP Tests: npm run test:lsp - Tests LSP server features
All Tests: npm run test:all - Runs all test suites

CI/CD

The project uses GitHub Actions for continuous integration:

Build: Automatically builds on every push
Test: Runs all tests on every push
Release: Creates GitHub Releases when tags are pushed (format: v*)

To create a release:

# Update version in package.json
git tag v1.2.0
git push origin v1.2.0

🤝 Contributing

We welcome contributions! Here's how you can help:

Report Bugs: Open an issue
Suggest Features: Open an issue
Submit Pull Requests:
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request

Contribution Guidelines

Follow the existing code style
Add tests for new features
Update documentation as needed
Be respectful and constructive in discussions

📝 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

Kip Language: Created by the Kip language team - kip-dili/kip
VS Code: Built with VS Code Extension API
LSP: Powered by Language Server Protocol
Community: Maintained by the community for the community

⚠️ Disclaimer

This extension is community-maintained and is not an official product of the Kip language team. While we strive to provide the best experience possible, this extension is provided "as-is" without warranty.

For official Kip language resources, documentation, and support, please visit:

Official Repository: github.com/kip-dili/kip

Made with ❤️ by the community

If you find this extension useful, please consider:

⭐ Starring the repository
🐛 Reporting bugs
💡 Suggesting features
🤝 Contributing code

Thank you for using Kip VS Code Extension!

Kip - Turkish Programming Language

algorynth