KoSpellCheck

KoSpellCheck egy offline helyesírás-ellenőrző ökoszisztéma fejlesztői környezetekhez.

Támogatott editorok

• Visual Studio 2022 (VSIX, C# analyzer + quick fix MVP)
• Visual Studio Code (TypeScript extension, diagnostics + code actions)

Fő funkciók

• HU + EN párhuzamos ellenőrzés
• Code-aware tokenizálás: camelCase, PascalCase, snake_case, kebab-case, dot.separated
• Quick fix javaslatok
• preferTerms szabályok (pl. model -> modell vagy fordítva)
• Projekt-stílus tanulás (kapitalizáció/preferált alak) workspace szinten cache-elve
• Magyar ASCII-fold támogatás (pl. homerseklet elfogadása hőmérséklet alapú szótár mellett)
• Opcionális local typo acceleration capability layer (Google Coral/TPU detektálás + safe fallback)
• Teljesen offline működés

MVP scope megjegyzés

• VS2022 oldalon az MVP Roslyn analyzer + code fix alapú (C# identifier fókusz), amely squiggle + lightbulb javítást ad.
• A teljes Tools/Options UI panel a következő iterációban bővíthető.
• VS2022 dashboard megnyitás: Tools -> KoSpellCheck Dashboard (újabb buildben View menüből is elérhető).
• VS2022 beállítások: workspace fájlokban (kospellcheck.json, .editorconfig), gyorsmenü: Tools -> KoSpellCheck: Open Settings File.
• A local typo acceleration jelenleg opcionális capability rétegként van bekötve; ha a kompatibilis lokális runtime/hardver hiányzik, automatikusan fallbackre áll.

Local Typo AI Accelerator (optional)

• Kizárólag lokális klasszifikációs kapu (typo-vs-not-typo), nem LLM és nem cloud.
• A végső javítási javaslatokat továbbra is a meglévő KoSpellCheck quick-fix logika adja.
• Nincs kötelező külön telepítő, Python/pip/apt/brew/Docker lépés.
• Ha kompatibilis gyorsító nincs jelen, a funkció non-blocking módon kikapcsolva marad.
• Ha korábban elérhető volt, de kiesik, automatikus fallback történik.
• Jelenlegi állapot: a runtime/model adapter pontok előkészítve vannak; tényleges Coral-backed modell csak akkor aktiválható, ha a runtime a buildben csomagolva elérhető.
• Runtime forrás mappa a repóban: Coral-tpu/MacOs, Coral-tpu/Linux, Coral-tpu/Windows (manifest + fájlok).
• macOS natív adapter váz forrás: Coral-tpu/MacOs/native/coral_tpu_adapter.cc (bináris: Coral-tpu/MacOs/bin/coral-typo-classifier-native).
• Saját modell készítés CLI (txt alapján): Coral-tpu/tools/koscoral-model-cli.mjs (./scripts/coral-model.sh wrapper).
• TensorFlow Lite C runtime sync script (macOS): ./scripts/sync-tflite-c-runtime.sh.

Repo szerkezet

• Core spell engine: /src/KoSpellCheck.Core
• HU+EN language pack: /src/KoSpellCheck.LanguagePack.HuEn
• VS2022 extension: /src/KoSpellCheck.VS2022
• VS Code extension: /src/KoSpellCheck.VSCode
• Build/test/pack script-ek: /scripts
• Szótárak és licencek: /tools

Dictionaries / Attribution

• A HU + EN .aff/.dic fájlok automatikusan letölthetők:
  • Linux/macOS: ./tools/fetch-dictionaries.sh
  • Windows: ./tools/fetch-dictionaries.ps1
• Rögzített források és commitok: tools/dictionaries/SOURCES.md
• Szótárak:
  • tools/dictionaries/hu_HU/hu_HU.aff
  • tools/dictionaries/hu_HU/hu_HU.dic
  • tools/dictionaries/en_US/en_US.aff
  • tools/dictionaries/en_US/en_US.dic
• Licencek/attribúciók:
  • tools/licenses/LICENSE_DICTIONARIES_HU.txt
  • tools/licenses/LICENSE_DICTIONARIES_EN.txt
  • tools/licenses/ATTRIBUTION_DICTIONARIES_EN_US.txt
  • tools/licenses/ATTRIBUTION_HU_MAGYARISPELL.txt
  • tools/licenses/ATTRIBUTION_TFLITE_C_PREBUILT.txt
  • tools/licenses/LICENSE_MPL_2_0.txt
  • tools/licenses/LICENSE_LGPL_3_0.txt

Changelog

• 2026-02-28: Fix VS Code packaging: a VSIX most közvetlenül vsce package-gel készül, és garantáltan tartalmazza az extension/package.json fájlt.

Fejlesztői build

Linux / macOS

./scripts/build.sh
./scripts/test.sh
./scripts/pack.sh

Windows (PowerShell 7)

./scripts/build.ps1
./scripts/test.ps1
./scripts/pack.ps1

VSIX telepítés

./scripts/pack.sh vagy ./scripts/pack.ps1 után két külön VSIX készül:

• VS Code: artifacts/vscode/KoSpellCheck.VSCode.vsix
• Visual Studio 2022: artifacts/vsix/KoSpellCheck.VS2022.vsix

VS Code-ban mindig a artifacts/vscode/KoSpellCheck.VSCode.vsix fájlt telepítsd (Extensions: Install from VSIX...).

Konfiguráció példa

.editorconfig:

[*.{cs,ts,js,json,md}]
kospellcheck_enabled = true
kospellcheck_languages = hu,en
kospellcheck_allow_mixed_languages = true
kospellcheck_treat_as_hungarian_when_ascii_only = true
kospellcheck_ignore_words = Async,SignalR,STM32
kospellcheck_prefer_terms = model:modell
kospellcheck_workspace_storage_path = /Users/you/.kospellcheck-workspaces
kospellcheck_style_learning = true

kospellcheck.json:

{
  "enabled": true,
  "languages": ["hu", "en"],
  "allowMixedLanguages": true,
  "preferTerms": {
    "model": "modell"
  },
  "workspaceStoragePath": "/Users/you/.kospellcheck-workspaces",
  "styleLearningEnabled": true,
  "localTypoAcceleration": {
    "mode": "auto",
    "showDetectionPrompt": true,
    "verboseLogging": false
  },
  "ignoreWords": ["Async", "SignalR", "STM32"],
  "projectDictionary": ["KoSpellCheck"],
  "suggestionsMax": 5
}

Részletes leírás: docs/configuration.md

Megjegyzés: ha workspaceStoragePath be van állítva, a korábbi workspace alatti .kospellcheck (és legacy .KoSpellChecker/.KoSpellCheck) tartalma automatikusan átmigrálódik az új, projekt-azonosítós mappába.