Changelog

July 8, 2026 · View on GitHub

[0.2.4] - 2026-07-08

Adds new language coverage and editor folding support, plus documentation updates.

Added Install-Package, Ensure-Package, Query-Package, and Push-PackageFile operation to the language data.
Added SecureCredentialProperty and SecureResourceProperty functions to the language data.
Added folding range support for OtterScript blocks via a dedicated folding range provider.

19 new operations with full IntelliSense (completion, hover, signature help, snippets): Restart-Server, Get-Asset, Release-Server, Download-Http, Upload-Http, Ensure-Service, Ensure-Directory, Ensure-Server, Ensure-Asset, Ensure-PsModule, Ensure-HostsEntry, Acquire-Server, Get-Http, Concatenate-Files, Create-ZipFile, Rename-File, Transfer-Files, Sign-Exe, Collect-RpmPackages.
CodeLens reference counts above module declarations linking to VS Code reference peek (otterscript.codeLens.enable, default true).
ReferenceProvider for module declarations and call sites (Shift+F12).
DocumentSymbolProvider for Outline panel, breadcrumbs, and Ctrl+Shift+O.

Fixed set and call keywords not highlighted when lowercase (missing grammar beginCaptures).
Fixed cross-line block comment and swim-string detection for module navigation.
Fixed stale diagnostics after quick-fix execution.
Fixed module reference scans to ignore strings, comments, and swim-strings.
Fixed module info cache growth on document close.
Fixed pending diagnostic timer not cleared on deactivation.

Internal code quality improvements: scanner consolidation, module navigation helpers, cached module analysis, and shared utilities.

Added language data and documentation for Apply-Template.
Added warning for assignment-like = in if conditions with a quick-fix to replace = with ==.
Added warning diagnostics for duplicate keys in map expressions.
Added duplicate map key diagnostics entry

Added diagnostic codes for unknown scalar, vector, and operation warnings.
Set diagnostic.source to OtterScript for extension diagnostics.
Improved grammar handling for Apply-Template so asset highlighting is reachable and position-aware.
Fixed variable escaping before snippet insertion in language data.
Fixed missing $ diagnostics in parenthesized if conditions.
Minor typo and formatting fixes.

Improved diagnostics performance with debouncing and caching
Enhancements to for language construct and related quick fixes
Fix All Issues command (otterscript.fixAll) that automatically applies all available quick-fixes in the current document

Quick‑fix code actions for selected diagnostics
- Insert missing $ prefix for variables.
- Replace invalid boolean operators
- These fixes are user‑initiated via the editor lightbulb and operate only on the precise diagnostic range.
Editor folding using #region / #endregion directives (editor-only)
Go‑to‑definition support for document‑local module calls.
- When the cursor is on a module name in call ModuleName(...), navigation (F12 / Ctrl+Click) jumps to the corresponding module ModuleName definition within the same document.
- This feature performs a best‑effort textual search and does not resolve cross‑file or imported modules.
Completion trigger and hover documentation for map expressions using the % sigil.
Syntax highlighting for built-in operations
Centralized logger with consistent prefix

Correctly skip multi‑line block comments when counting braces, preventing:
- Braces inside comments from being counted as code.
- Code following a closing */ from being skipped during validation.

Reorganized code: extracted helper functions, logger, constants, and regex patterns to dedicated helpers.js module for improved maintainability

Extended documentation for syntax-only constructs (swim strings, template tags, map/vector expressions).
Richer ProGet-specific variable documentation, including availability notes and examples.
Improved documentation coverage for scalar and vector functions, including clearer parameter descriptions and examples.

Hover provider fully refactored:
- Unified rendering via a shared Markdown builder.
- Correct suppression of hover inside strings and comments.
Completion providers refactored for consistency and maintainability:
- Centralized completion item construction.
- Improved sorting and prioritization across keywords, operations, functions, and variables.
- More accurate snippet insertion without guessing function signatures.
Signature help significantly improved:
- Supports scalar functions, vector functions, and operations.
- Handles nested parentheses and complex argument expressions.
- More reliable active-parameter tracking.
Documentation model normalized:
- Syntax documentation now uses the same structured format as functions and keywords.
- Removed redundant or duplicated documentation text across entries.

Removed stale diagnostic markers when closing files.
Prevented hover and completion from triggering inside string literals and comments.
Corrected snippet definitions for several scalar functions.
Fixed keyword hover regressions caused by overly broad word matching.
Improved error recovery and stability when documentation entries are incomplete or optional.