inkling syntax highlighting and semantic validation
Provides real-time syntax coloring and semantic error/warning detection for Inkling domain-specific language files within VS Code. Integrates with VS Code's language server protocol (LSP) or equivalent diagnostic system to parse .inkling files, identify syntax violations, and surface inline diagnostics (squiggly underlines, error messages) without requiring external compilation or manual validation steps.
Unique: Purpose-built language support for Bonsai's proprietary Inkling DSL, integrating directly into VS Code's diagnostic pipeline rather than relying on generic linting or external validators. Understands Inkling-specific semantics (simulator definitions, reward functions, training configuration) natively.
vs alternatives: Provides native Inkling syntax support that generic language extensions (Pylance, ESLint) cannot offer, eliminating the need for external validation tools or manual compilation cycles during Inkling development.
inkling v1-to-v2 syntax conversion command
Exposes a VS Code command palette action that transforms Inkling v1 syntax to v2 (or vice versa) by parsing the current file's AST, applying syntax transformation rules, and outputting converted code. The conversion likely handles breaking changes between language versions (e.g., renamed keywords, restructured configuration blocks, updated function signatures) without requiring manual line-by-line rewrites.
Unique: Automates Inkling language version migration by implementing version-aware syntax transformation rules specific to Bonsai's DSL evolution, handling domain-specific breaking changes (simulator structure, reward definitions, training parameters) rather than generic code reformatting.
vs alternatives: Eliminates manual line-by-line rewriting of Inkling v1→v2 migrations, which would otherwise require deep knowledge of both syntax versions and Bonsai platform semantics; faster and less error-prone than manual conversion or generic find-replace approaches.
inkling language mode detection and file association
Automatically detects and registers .inkling file extensions with VS Code's language system, enabling the extension to activate its syntax highlighting and validation features. Uses VS Code's language contribution mechanism to associate the Inkling language identifier with the extension, ensuring that opening any .inkling file triggers the language server and diagnostic pipeline without manual configuration.
Unique: Implements VS Code language contribution mechanism to register Inkling as a first-class language, enabling automatic activation and feature discovery without requiring users to manually select language mode or configure file associations.
vs alternatives: Provides seamless out-of-the-box language detection for .inkling files, eliminating the friction of generic text editor defaults or manual language mode selection that users would face with unsupported file types.
inline diagnostic reporting for inkling errors and warnings
Integrates with VS Code's diagnostic API to surface Inkling syntax and semantic errors as inline squiggly underlines, hover tooltips, and entries in the Problems panel. The extension parses Inkling source code, identifies violations against the language grammar and semantic rules, and reports diagnostics with precise line/column positions and actionable error messages, enabling developers to fix issues without leaving the editor.
Unique: Implements Inkling-aware diagnostic parsing that understands domain-specific semantic rules (e.g., valid simulator configurations, reward function signatures, training parameter constraints) rather than generic syntax checking, enabling detection of Inkling-specific errors that generic linters cannot identify.
vs alternatives: Provides real-time, inline error feedback specific to Inkling semantics, eliminating the need for external compilation, separate linting tools, or post-hoc validation that would delay error discovery in the development cycle.